Aikount Mcp
About
Spanish accounting (contabilidad) for AI agents — issue invoices, OCR expense PDFs into deduplicated purchases, reconcile bank movements, and prepare the quarterly VAT return (Modelo 303) over the Aikount REST API. For autónomos, SMEs and gestorías. Works with Claude, Cursor and
Details
- Author
- mutonby
- Downloads
- 271
- Categories
- Finance, Other, Automation, Developer Tools
Jump to
- Issue invoices through the Aikount REST API
- OCR expense PDFs into deduplicated purchases
- Reconcile bank movements automatically
- Prepare quarterly VAT return (Modelo 303)
- Works with Claude, Cursor, and ChatGPT
- Designed for autónomos, SMEs, and gestorías
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Aikount McpCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install the server with uvx aikount-mcp, then use it with supported AI assistants. Once configured, you can issue invoices, process expense receipts, reconcile bank movements, and prepare VAT returns by conversing with Claude, Cursor or ChatGPT.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"aikount mcp": {
"aikount": {
"command": "uvx",
"args": [
"aikount-mcp"
],
"env": {
"AIKOUNT_TOKEN": "agl_your_token_here"
}
}
}
}
}McpServers
{
"aikount": {
"command": "uvx",
"args": [
"aikount-mcp"
],
"env": {
"AIKOUNT_TOKEN": "agl_your_token_here"
}
}
}Aikount MCP — Contabilidad española con IA para Claude, Cursor y ChatGPT
Servidor MCP de contabilidad para autónomos y pymes en España.Lleva tu contabilidad a cualquier agente de IA: emite facturas, captura PDFs de gastos por OCR, concilia movimientos bancarios y prepara el Modelo 303 — todo desde Claude, Cursor, ChatGPT o cualquier cliente MCP.
Aikount es unSaaS de contabilidad agent-first: una alternativa a Holded pensada para que sea unaIA quien lleve la contabilidad. Este repositorio es elservidorMCP(Model Context Protocol)oficial que conecta tu agente de IA con tus libros a través de la API REST pública deAikount. La API es el producto; la interfaz web es el plan B para humanos.
¿Eres autónomo o gestoría y quieres que un agente de IA lleve tu contabilidad en España?Empieza enaikount.comy conecta tu agente con este servidor MCP.
¿Por qué no haycreate_purchase?Las facturas de compra duplicadas corrompen los totales de gasto, el IVA soportado y la conciliación bancaria. Por eso los gastos solo se añaden víaingest_purchase_pdf, quededuplica por identidad de factura.
Necesitas unaAPI keyde Aikount (scope, con prefijoagl_). La generas con el botón«Conectar agente»dentro de la app web de Aikount — te muestra las líneasexportexactas.
Opción A — Hosted, sin instalar nada (MCP remoto)
Conecta tu cliente al endpoint hosted con tu token en la cabecera:
URL: https://api.aikount.com/mcp (streamable-HTTP) Header: Authorization: Bearer agl_tu_token
Es multi-tenant: cada petición se autentica con su propio token. Ideal para clientes que soportan MCP remoto. Las mismas herramientas que la versión local.
export AIKOUNT_TOKEN="agl_xxxxxxxxxxxxxxxxxxxxxxxx" # opcional, por defecto producción: # export AIKOUNT_API="https://api.aikount.com/api/v1"
pipx install aikount-mcp # o: pip install aikount-mcp aikount-mcp
Añádelo a tu configuración MCP (claude_desktop_config.json, o.mcp.jsonen Claude Code):
{ "mcpServers": { "aikount": { "command": "uvx", "args": ["aikount-mcp"], "env": { "AIKOUNT_TOKEN": "agl_xxxxxxxxxxxxxxxxxxxxxxxx" } } } }
Ajustes → MCP → Add new server, con el mismocommand/args/env.
- «Emite una factura de 1.200 € a ACME por la consultoría de mayo.»El agente busca el contacto, resuelve el IVA y crea el borrador; tú confirmas y lo emite.
- «Mete este PDF de Amazon Web Services como gasto.»OCR + alta deduplicada del gasto en el Plan General Contable.
- «¿Cómo va mi IVA del segundo trimestre?»Resumen del Modelo 303 al momento.
- «Concilia los movimientos del banco con las facturas.»Conciliación bancaria automática (auto-concilia con confianza ≥ 0,95).
- Dineroen euros decimales (unit_price: 1200.00), no en céntimos. EUR salvo quecurrencydiga otra cosa.
- FechasISO-8601AAAA-MM-DD.IDsson UUID.
- Las líneas referencian impuestos portax_type_id(UUID delist_tax_types), no por un código de texto. Omítelo para heredar el del contacto/producto.
- Los errores vuelven como{"error": true, "status_code": ..., "detail": ..., "hint": ...}para que el modelo se autocorrija (re-auth en 401, corregir el cuerpo en 422).
- El token tiene scope— trátalo como una contraseña. El aislamiento por empresa (multi-tenant) es automático.
Es un servidor MCP (Model Context Protocol) que conecta agentes de IA como Claude, Cursor o ChatGPT con tu contabilidad en Aikount, para que la IA puedaemitir facturas, registrar gastos, conciliar el banco y preparar impuestos(Modelo 303) usando el Plan General Contable español.
¿Cómo conecto Claude (o Cursor/ChatGPT) con mi contabilidad?
Instala el servidor conuvx aikount-mcp, genera tu API key en Aikount con «Conectar agente» y añade el bloquemcpServersa la configuración de tu cliente MCP. En segundos tu agente puede leer y escribir en tus libros.
¿Es seguro? ¿Aikount guarda mis credenciales bancarias?
No. La conexión bancaria se hace mediantepasarelas PSD2 reguladas(Ponto Connect, Salt Edge, GoCardless); Aikountnuncaalmacena credenciales del banco. Los datos se alojan en laUE. El token de la API es revocable y está aislado por empresa.
¿Sirve para autónomos y pymes en España?
Sí. Aikount está pensado paraautónomos y pymes españolasy para lasgestoríasque las supervisan, con soporte multiempresa y multidivisa, Plan General Contable y Veri*Factu. No sustituye a tu gestor: le entrega el trabajo hecho para revisar y firmar.
¿Qué es el Modelo 303 y puede prepararlo la IA?
ElModelo 303es la autoliquidación trimestral del IVA en España. El agente genera el resumen por trimestre (modelo_303_summary) y el detalle por operación (modelo_303_csv) listos para revisar y presentar.
Sí. Donde Holded es una suite por módulos, Aikount es unagente de IA centrado en hacerte la contabilidad, con precio por tramo de facturación. Comparativa:aikount.com/alternativas-a-holded.
Aikount —contabilidad española agent-firstpara autónomos, pymes y gestorías. Recursos:
- 🌐 Web:aikount.com
- 🤖 Contabilidad con IA:aikount.com/contabilidad-con-ia
- 🏦 Conciliación bancaria automática:aikount.com/conciliacion-bancaria-automatica
- 🧮 Calculadora de IVA trimestral (Modelo 303):aikount.com/calculadora-iva-trimestral
- 🆚 Alternativa a Holded:aikount.com/alternativas-a-holded
- 📚 Documentación de la API:api.aikount.com/docs
- 🧩 Contexto para agentes:aikount.com/llms.txt
python -m venv .venv && source .venv/bin/activate pip install -e ".[dev]" pytest -q # 23 tests, sin red (httpx MockTransport)
Los tests fijan cada herramienta a la rutarealde la API verificada contra la especificación OpenAPI en vivo, para que las rutas no se rompan en silencio.
server.jsones el manifiesto de este paquete para elregistro oficial de MCP.
international financial reporting engine for Agents and REST api users journal entries, statement generation, audit trail with workings, financial reporting automation
Agentic Document Parsing and Extraction (ADP)
ADP automatically classifies overseas invoices, domestic vouchers, procurement contracts, logistics documents, financial statements and trading contracts, and accurately extracts key fields. It also supports table parsing, content verification and multilingual recognition. Requiring no template setup, data labeling or ongoing rule maintenance, it efficiently handles high-volume document processing tasks.
MCP-enabled invoicing platform for invoice creation, PDF export, and billing operations.
MCP server for Fiken — Norway's popular accounting software. Manage invoices, contacts, journal entries, and bank accounts via AI agents.
An assistant API to help find and apply for funding opportunities.
AI-native business management MCP server — 31 tools for invoicing, expenses, clients, products, quotes & tax compliance. 40 currencies, OCR, Stripe Connect. MIT licensed.
MCP server for Pohoda accounting software (Czech) - read and create invoices, orders, inventory, contacts via mServer XML API.
Cross-border debt collection from your AI assistant: check cases, get pricing, submit new cases.
AI agents that automate bookkeeping and financial close for SMBs.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
