LABSCO SUMMARY
The tool list comes from the live API docs, not from a release.
Rebuilding the tools at launch from Adfin's current documentation means the server does not go stale between versions — a new endpoint is there the next time you start your client. The trade is that first start costs 10-20 seconds and needs network access. The bulk-upload workflow is the one worth setting up deliberately: it wants a filesystem server alongside this one, which is why the sample config declares both.
What it is
Adfin's server for its invoicing and payments platform. It exposes Adfin's API to an assistant, and refreshes the tool set from Adfin's current API documentation each time the client launches.
What you get
- Credit control status on demand — ask for the check and read it back
- Invoice creation from a sentence: amount, currency, customer name, due date and email
- Bulk upload of existing PDF invoices from a local folder, when paired with a filesystem server
- The available tools are rebuilt at launch from the most recent Adfin API documentation, so a new endpoint appears without you updating anything
Requirements
Python 3.10 or higher and uv. Add it to your client with uv --directory <YOUR_ABSOLUTE_PATH_TO_ADFIN_MCP> run main_adfin_mcp.py, with ADFIN_EMAIL and ADFIN_PASSWORD in the environment. The first launch takes 10-20 seconds while packages install and the current API documentation downloads.
Setup effort
Clone and run — clone the repository, then add the configuration for your client; uv runs the script from your clone, with nothing to build
USE CASES
01
Checking where you stand on collections
Ask for a credit control status and read the summary instead of opening the dashboard.
02
Raising an invoice in one sentence
Give the amount, the customer and the terms and let the invoice be created.
03
Getting a backlog of PDFs into the system
Point at the folder and have every invoice in it uploaded.
BEFORE YOU INSTALL
What to know first
Requires
- uv on PATH
- ADFIN_PASSWORD in your environment
- ADFIN_EMAIL in your environment
INSTALLATION
Connect your client
Server setup
TERMINAL
git clone https://github.com/Adfin-Engineering/mcp-server-adfinMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"Adfin": {
"command": "<YOUR_HOME_PATH>/.local/bin/uv",
"args": [
"--directory",
"<YOUR_ABSOLUTE_PATH_TO_ADFIN_MCP>",
"run",
"main_adfin_mcp.py"
],
"env": {
"ADFIN_EMAIL": "<YOUR_ADFIN_EMAIL>",
"ADFIN_PASSWORD": "<YOUR_ADFIN_PASSWORD>"
}
},
"filesystem": {
"command": "<YOUR_HOME_PATH>/.local/bin/uv",
"args": [
"--directory",
"<YOUR_ABSOLUTE_PATH_TO_ADFIN_MCP>",
"run",
"filesystem.py"
]
}
}
}