Skip to content
MCP server

Aikount MCP

Spanish bookkeeping for agents: invoices, expense OCR, bank reconciliation and Modelo 303

Install
Pricing
Freemium
Platforms
API, Web, CLI
Runs
Locally or Remotely
Version
0.2.0
Listing updated
2 days ago

About Aikount MCP

Aikount MCP is a freemium MCP server for finance and payments. It can run locally on your machine or as a hosted remote server.

Aikount is an accounting service aimed at Spanish freelancers and small businesses, and this server hands an assistant the same operations it would use by hand. A sales invoice moves from draft to issued, which assigns its legal number; a PDF of a purchase invoice is read by OCR into a supplier, lines and taxes.

One design choice stands out: there is no create_purchase tool. Duplicate purchase invoices distort expense totals, input VAT and reconciliation, so expenses only enter through ingest_purchase_pdf, which de-duplicates by invoice identity. Bank, Stripe and PayPal movements can be reconciled, the chart of accounts, ledger and trial balance can be queried, and the quarterly Modelo 303 VAT summary can be prepared for review.

Use the hosted endpoint with OAuth (a read-only option is offered on consent) or a bearer key, or run the PyPI package locally with uvx and an agl_ token. Data is hosted in the European Union, according to the site.

Install

Run in a terminal

claude mcp add --transport http aikount-mcp https://api.aikount.com/mcp

Add to Settings → Connectors → Add custom connector

https://api.aikount.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "aikount-mcp": {
      "url": "https://api.aikount.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "aikount-mcp": {
      "type": "http",
      "url": "https://api.aikount.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "aikount-mcp": {
      "serverUrl": "https://api.aikount.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "aikount-mcp": {
      "type": "http",
      "url": "https://api.aikount.com/mcp"
    }
  }
}

Configuration

  • AIKOUNT_TOKENAikount API key (agl_...), scope *. Generada con 'Conectar agente'.Required
  • AIKOUNT_APIURL base de la API (por defecto producción).

Tools this server provides (23)

Taken from the project documentation; the running server may differ.

whoami
Verify the token and return the active company.
list_contacts
List clients and suppliers.
create_contact
Create a client or supplier.
list_tax_types
List VAT, IGIC, IPSI and IRPF types.
list_products
List the product and service catalogue.
list_invoices
List sales invoices.
get_invoice
Get one sales invoice.
create_invoice
Create a draft invoice.
issue_invoice
Issue an invoice and assign a legal number.
list_purchases
List expenses and purchase invoices.
get_purchase
Get one purchase invoice.
ingest_purchase_pdf
OCR a PDF into an expense without duplicates.
get_ingest_job
Check a PDF ingestion job.
list_treasuries
List bank, Stripe and PayPal accounts with balances.
list_bank_movements
List bank movements with filters.
reconciliation_board
Show the reconciliation board.
reconcile_movement
Reconcile a bank movement.
list_accounts
List accounts in the chart of accounts.
ledger
Query the ledger.
trial_balance
Return the trial balance.
modelo_303_summary
Quarterly VAT summary.
modelo_303_csv
Modelo 303 as CSV.
api_request
Call any other API endpoint.

What it does

Invoice lifecycle
Create drafts and issue invoices to assign a legal number.
Expense OCR
ingest_purchase_pdf extracts supplier, lines and taxes without duplicates.
Bank reconciliation
Match bank, Stripe and PayPal movements.
Ledger queries
Chart of accounts, ledger and trial balance.
Modelo 303
Quarterly VAT summary and CSV for review.
Hosted or local
Remote OAuth endpoint or local uvx package.

Good for

  • Issue an invoice from a chat request
  • Capture an expense from a PDF
  • Reconcile bank movements
  • Prepare the quarterly VAT return
  • Query the trial balance

Pricing

Freemium, from $19 a month

Free up to 24,000 EUR annual invoicing; then from 19 EUR/month excluding VAT

Prices change. Check aikount.com before you buy.

Aikount MCP FAQ

How do I connect it?

Use the hosted URL with OAuth or a bearer key, or run uvx aikount-mcp with AIKOUNT_TOKEN set.

Can it be read-only?

Yes, OAuth consent offers a read-only option.

Why can't it create purchases directly?

To avoid duplicates, purchases are added only through PDF ingestion.

What does Aikount cost?

Free up to 24,000 euros of annual billing, then from 19 euros a month before VAT.

Is Aikount MCP free?

Aikount MCP has a free plan, with paid plans for more usage or features. Paid plans start at $19 a month.

How do I add Aikount MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http aikount-mcp https://api.aikount.com/mcp

What are the best alternatives to Aikount MCP?

The closest alternatives to Aikount MCP are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

Alternatives to Aikount MCP

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government