Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"aikount": {
"env": {
"AIKOUNT_TOKEN": "agl_xxxxxxxxxxxxxxxxxxxxxxxx"
},
"args": [
"aikount-mcp"
],
"command": "uvx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
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.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
uvx 'aikount-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked aikount-mcp against OSV.dev.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in other
Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 60-95% fewer tokens, same answers. Library, proxy, MCP server.
Pi Coding Agent extension (CLI-first) — routes bash/read/grep/find/ls through lean-ctx CLI for strong token savings. Optional MCP bridge can register advanced tools.
AI travel agent — 1 smart MCP tool plus 62 compatibility aliases for flights, hotels, ground transport, price alerts. No API keys required.
Research graph MCP for hypotheses, goals, runs, source quality, audits, and generated maps.
MCP Security Weekly
Get CVE alerts and security updates for io.github.mutonby/aikount-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
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 un SaaS de contabilidad agent-first: una alternativa a Holded pensada para que sea una IA quien lleve la contabilidad. Este repositorio es el servidor MCP (Model Context Protocol) oficial que conecta tu agente de IA con tus libros a través de la API REST pública de Aikount. 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 en aikount.com y conecta tu agente con este servidor MCP.
| Herramienta | Qué hace |
|---|---|
whoami | Verifica el token y devuelve el tenant (empresa) activo |
list_contacts / create_contact | Clientes y proveedores |
list_tax_types | Tipos de IVA/IGIC/IPSI/IRPF y sus UUID para las líneas |
list_products | Catálogo de productos/servicios |
list_invoices / get_invoice | Consultar facturas de venta |
create_invoice / issue_invoice | Crear borrador y emitir (asigna número legal) |
list_purchases / get_purchase | Consultar gastos / facturas de compra |
ingest_purchase_pdf / get_ingest_job | OCR de un PDF a un gasto sin duplicados |
list_treasuries | Cuentas de banco / Stripe / PayPal con saldo |
list_bank_movements | Movimientos bancarios, con filtros |
reconciliation_board / reconcile_movement | Conciliación bancaria automática |
list_accounts / ledger / trial_balance | Plan General Contable (PGC), mayor y sumas y saldos |
modelo_303_summary / modelo_303_csv | IVA trimestral (Modelo 303) |
api_request | Acceso a cualquier otro endpoint (ver OpenAPI) |
¿Por qué no hay
create_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, que deduplica por identidad de factura.
Necesitas una API key de Aikount (scope *, con prefijo agl_). La generas
con el botón «Conectar agente» dentro de la app web de Aikount — te muestra
las líneas export exactas.
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"
Ejecútalo con uv (sin instalar nada):
uvx aikount-mcp
O con pip/pipx:
pipx install aikount-mcp # o: pip install aikount-mcp
aikount-mcp
Añádelo a tu configuración MCP (claude_desktop_config.json, o .mcp.json en
Claude Code):
{
"mcpServers": {
"aikount": {
"command": "uvx",
"args": ["aikount-mcp"],
"env": { "AIKOU
... [View full README on GitHub](https://github.com/mutonby/aikount-mcp#readme)