contasimple-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CONTASIMPLE_API_KEY | Yes | Clave de API de Contasimple | |
| CONTASIMPLE_ALLOW_WRITE | No | Establece `1` para permitir crear proveedores, facturas, pagos y adjuntos. Por defecto solo lectura. | 0 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| cs_whoamiA | Comprueba la conexión: devuelve el usuario y la empresa activa en Contasimple, y si la escritura está permitida. |
| cs_list_periodsA | Lista los periodos contables (trimestres, p. ej. 2026-4T) y si están abiertos o cerrados. |
| cs_list_invoice_classesA | Lista las clases (tipos de gasto/ingreso) válidas para facturas recibidas o emitidas. Necesario para invoiceClass al crear. |
| cs_list_payment_methodsA | Lista las formas de pago configuradas (transferencia, tarjeta, domiciliación...) con su id, necesario para cs_add_payment. |
| cs_list_invoicesB | Lista facturas emitidas o recibidas de un trimestre, con filtros opcionales. |
| cs_get_invoiceA | Obtiene el detalle completo de una factura (líneas, pagos, emisor, receptor) por su id. |
| cs_search_invoice_by_numberB | Busca facturas por número exacto en todos los periodos (útil para no duplicar). |
| cs_pending_summaryB | Facturas pendientes de cobro (issued) o de pago (received) de un mes. |
| cs_create_received_invoiceA | Registra una factura recibida (de un proveedor). Calcula IVA y bases de cada línea. Contasimple rechaza duplicados por número+proveedor+año. Requiere escritura activada. |
| cs_attach_fileA | Adjunta un archivo local (PDF o imagen de la factura) a una factura recibida o emitida. Requiere escritura activada. |
| cs_download_invoice_pdfC | Descarga el PDF de una factura a una ruta local. |
| cs_search_entitiesC | Busca proveedores o clientes por nombre o NIF. |
| cs_create_providerB | Crea un proveedor nuevo. Busca antes con cs_search_entities para no duplicarlo. Requiere escritura activada. |
| cs_list_paymentsC | Lista los pagos o cobros registrados en una factura. |
| cs_add_paymentA | Registra un pago (factura recibida) o cobro (emitida) en una factura. Si no se indica importe, paga todo lo pendiente y la factura queda como pagada. Requiere escritura activada. |
| cs_delete_paymentB | Elimina un pago registrado por error en una factura. Requiere escritura activada. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 16 tools
Most tools target a clearly distinct resource+action (periods, invoice classes, payment methods, entities, payments). The main overlap is between cs_list_invoices, cs_search_invoice_by_number and cs_get_invoice, but descriptions distinguish them by listing vs exact-number lookup vs full detail.
All tools use a consistent cs_ snake_case prefix with a verb_noun pattern. Minor deviations like cs_whoami and cs_pending_summary omit an explicit action verb, but the overall convention is predictable.
16 tools is on the higher side but reasonable for an invoicing/accounting domain with lookup, creation, attachment and payment workflows. Each tool maps to a real operation, though a few could potentially be consolidated.
Core flows (search, create received invoice, attach PDF, manage payments) are covered, but there are notable gaps: no creation of issued invoices, no update/delete for invoices or providers, and no edit payment operation. Agents hitting these needs will have to work around the surface.