# Aikount MCP

> Aikount MCP is a freemium MCP server for finance and payments. Spanish bookkeeping for agents: invoices, expense OCR, bank reconciliation and Modelo 303. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $19 a month
- **Platforms:** API, Web, CLI
- **Website:** https://aikount.com/mcp-contabilidad
- **Repository:** https://github.com/mutonby/aikount-mcp
- **MCP Registry name:** io.github.mutonby/aikount-mcp
- **Categories:** finance and payments
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.aikount.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "aikount-mcp": {
      "url": "https://api.aikount.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/aikount-mcp
