Adfin

Adfin

The only platform you need to get paid - all payments in one place, invoicing and accounting reconciliations with Adfin.

9
Stars
8
Forks
0
Releases

Overview

The Adfin MCP server provides a Claude Desktop integration that exposes Adfin's payments, invoicing, and accounting capabilities through a dedicated MCP. By configuring Claude to run main_adfin_mcp.py via UV, users can interact with Adfin services directly from the AI assistant. The Adfin MCP server authenticates using environment variables ADFIN_EMAIL and ADFIN_PASSWORD, ensuring secure access to the Adfin API. When Claude Desktop is launched, it installs and makes the latest Adfin API tools and documentation available to the assistant, enabling up-to-date functionality. The setup supports two MCP endpoints: Adfin (main_adfin_mcp.py) for core operations and a filesystem MCP (filesystem.py) for uploading multiple invoices from a folder. Typical workflows demonstrated include checking credit control status, creating new invoices (specifying amount, recipient, due date and contact email), and bulk-upload of PDF invoices from a directory. The MCP framework requires Python 3.10+ and UV installation; upon first use, the required packages are downloaded. This integration is intended for finance teams and developers who want to automate payments, invoicing, and document handling within Claude.

Details

Owner
Adfin-Engineering
Language
Python
License
Updated
2025-12-07

Features

Adfin API access via Claude

Provides Claude with direct access to Adfin API tools and up-to-date documentation for payments and invoicing.

Secure environment-based authentication

Authenticates to Adfin services using ADFIN_EMAIL and ADFIN_PASSWORD supplied as environment variables.

Main Adfin MCP script runner

Runs main_adfin_mcp.py through UV to connect Claude requests to Adfin services.

Directory-driven MCP configuration

Configures the MCP to run from a specified directory via the --directory path.

Filesystem-based upload endpoint

Includes a separate filesystem.py MCP endpoint to upload multiple invoices from a folder.

Automatic tool provisioning on launch

Installs and exposes the latest Adfin API tools and API docs on each Claude startup.

Common workflows supported

Supports credit control status checks, creating invoices, and bulk invoice uploads.

Prerequisites and installation flow

Guides installation of uv and Claude Desktop integration for quick setup.

Audience

Finance teamsUse Adfin MCP to manage payments, invoicing, and reconciliation via Claude.
Accountants/BookkeepersAutomate routine invoicing tasks and invoice uploads through Claude Adfin integration.
Developers/IntegratorsIntegrate Adfin capabilities into custom AI workflows and automate document handling.

Tags

AdfinpaymentsinvoicingaccountingAPIClaudefilesystemcredit controlinvoiceautomation