whoamiLABSCO SUMMARY
The books, kept by the agent.
Aikount is built so the API is the product and the web interface is the fallback, which means an assistant can issue an invoice, file an expense and prepare the VAT return without anyone opening the app.
What it is
The official MCP server for Aikount, an agent-first Spanish accounting SaaS. It connects an assistant to your books through Aikount's public REST API: contacts, invoices, purchases, treasury, the Plan General Contable ledger and quarterly VAT.
What you get
- create_invoice drafts and issue_invoice assigns the legal number; list_invoices and get_invoice read them back
- ingest_purchase_pdf runs OCR on an expense PDF into a purchase without creating duplicates, and get_ingest_job follows the run — there is deliberately no create_purchase, because duplicate purchase invoices corrupt the totals
- list_contacts and create_contact cover customers and suppliers; list_products and list_tax_types supply invoice lines with the right IVA, IGIC, IPSI or IRPF rate and its UUID
- list_treasuries shows bank, Stripe and PayPal accounts with their balances; list_bank_movements filters the transactions
- reconciliation_board and reconcile_movement do the bank reconciliation
- list_accounts, ledger and trial_balance give the PGC accounts, the ledger and the trial balance
- modelo_303_summary and modelo_303_csv prepare the quarterly VAT return
- whoami confirms which company the token is pointed at; api_request reaches any other endpoint in the OpenAPI spec
Requirements
Python with the aikount-mcp package from PyPI, and an Aikount account with an API token. Documentation is in Spanish.
Setup effort
One command plus a key — uvx aikount-mcp, then supply credentials
USE CASES
01
Issuing an invoice to a client
The draft is built with the correct tax rate on each line, then issued — which is the step that assigns the legal number.
02
Filing an expense from a PDF
The receipt is read by OCR into a purchase, with duplicate protection built into the only path that creates one.
03
Reconciling the bank at month end
Movements are filtered, matched on the reconciliation board and settled, instead of ticked off against a statement by hand.
04
Preparing the quarterly VAT return
The Modelo 303 summary and the matching csv export come out of the live books rather than from a spreadsheet rebuilt each quarter.
05
Checking where the accounts stand
Trial balance and ledger on demand, so a question about a PGC account is answered without exporting anything.
06
Seeing what is in the bank across accounts
Bank, Stripe and PayPal balances in one view, which is the number a cash decision actually needs.
23 tools
Listed in project docs. Your client may show a different list.
list_contactscreate_contactlist_tax_typeslist_productslist_invoicesget_invoicecreate_invoiceissue_invoicelist_purchasesget_purchaseingest_purchase_pdfget_ingest_joblist_treasurieslist_bank_movementsreconciliation_boardreconcile_movementlist_accountsledgertrial_balancemodelo_303_summarymodelo_303_csvapi_requestBEFORE YOU INSTALL
What to know first
Tools you get
23 tools named in the project's documentation.
Requires
- uvx on PATH
- AIKOUNT_TOKEN in your environment
INSTALLATION
Connect your client
Server setup
uvx
TERMINAL
uvx aikount-mcpHosted endpoint
ENDPOINT URL
https://api.aikount.com/mcpAdd this hosted endpoint to your MCP client using the credentials listed under Requirements.
MCP Clients
Any MCP client — Remote
Clients that support remote MCP: connect to the hosted endpoint over streamable HTTP and send your Aikount key in the Authorization header. Nothing to install.
ANY MCP CLIENT — REMOTE · YAML
URL: https://api.aikount.com/mcp
Header: Authorization: Bearer agl_tu_tokenagl_tu_token is your Aikount API key (it starts with agl_; generate it with the "Conectar agente" button in the Aikount web app). The endpoint is multi-tenant: each request is authenticated by its own token.
Claude Desktop, Claude Code
JSON
{
"mcpServers": {
"aikount": {
"command": "uvx",
"args": [
"aikount-mcp"
],
"env": {
"AIKOUNT_TOKEN": "<YOUR_AIKOUNT_TOKEN>"
}
}
}
}claude_desktop_config.json, or .mcp.json in Claude Code
Cursor
CURSOR · JSON
{
"mcpServers": {
"aikount": {
"command": "uvx",
"args": [
"aikount-mcp"
],
"env": {
"AIKOUNT_TOKEN": "<YOUR_AIKOUNT_TOKEN>"
}
}
}
}Settings → MCP → Add new server, with the same command / args / env
