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