# contadeo-mcp

Servidor MCP de Contadeo: emite y consulta comprobantes electrónicos del SRI (Ecuador) desde asistentes de IA como Claude

- **Type:** MCP server
- **Trust:** 60/100 (B), scored on the package rubric
- **Verification:** community-indexed — nobody has claimed this listing
- **Version:** 0.25.0
- **Author:** com.contadeo
- **License:** MIT
- **npm:** contadeo-mcp
- **Endpoints:** streamable-http https://contadeo.com/api/mcp
- **Source:** https://contadeo.com/mcp
- **Endpoint health:** reachable (last checked 2026-09-26T22:46:19.455Z, 3 samples) — uptime is not a security property and is not part of the trust score
- **Compatible clients:** claude-code, cursor, copilot, chatgpt, gemini (basis: transport)

## Trust

60/100 (B), scored on the package rubric
- Publisher verified: no
- Install scripts: nothing suspicious found
- Prompt-injection scan: not run
- Obfuscation scan: not run
- Evidence age: 18 days

## Security scan

- **Status:** clean
- **Scanned:** 2026-09-17T13:24:11.865Z
- **Version scanned:** 0.25.0
- **CVEs:** none found by OSV at scan time

## Tools

39 declared. Statically extracted from the shipped source — a floor on the surface, not a census.
- `consultar_cuenta` — Devuelve la cuenta de Contadeo del usuario: nombre, ambiente activo
- `contexto_emision` — Devuelve TODO lo necesario para emitir un comprobante: los emisores
- `buscar_clientes` — Lista los clientes del catálogo, opcionalmente filtrados por texto
- `buscar_productos` — Lista los productos/servicios del catálogo, opcionalmente filtrados
- `preparar_factura` — Construye UNA factura LISTA con toda la matemática tributaria hecha
- `emitir_factura` — Emite la factura: se firma con el certificado del emisor y se
- `preparar_lote` — Construye VARIAS facturas de una vez (máximo 25) con toda la
- `emitir_lote` — Emite en secuencia las facturas de un lote preparado con
- `preparar_nota_credito` — Construye una NOTA DE CRÉDITO (comprobante 04) que revierte una factura
- `emitir_nota_credito` — Emite la nota de crédito: se firma con el certificado del emisor y se
- `crear_cliente` — Da de alta un cliente (comprador) en el catálogo de la cuenta.
- `crear_producto` — Da de alta un producto o servicio en el catálogo: código único,
- `ajustar_stock` — Ajusta las existencias de un producto del inventario por su código:
- `consultar_reglas_sri` — Devuelve las tablas de referencia oficiales que aplican a la
- `listar_comprobantes` — Lista los comprobantes emitidos, con filtros opcionales por estado
- `consultar_comprobante` — Devuelve el detalle y estado actual de un comprobante por su ID:
- `esperar_autorizacion` — Hace polling de uno o VARIOS comprobantes hasta que el SRI los
- `descargar_ride` — Devuelve una URL temporal (expira en 1 hora) para descargar el RIDE
- `descargar_xml` — Devuelve una URL temporal (expira en 1 hora) para descargar el XML
- `reporte_ventas` — Agregados de ventas del período (default: mes en curso): conteo por
- `consultar_retenciones` — Retenciones que TU emisor practicó a otros en un mes (Renta, IVA,
- `mi_situacion_tributaria` — El panorama COMPLETO de la cuenta en una sola llamada: si está lista
- `explicar_termino` — Glosario del SRI en lenguaje llano: RIDE, clave de acceso, RIMPE,
- `consultar_calendario_tributario` — Próximos vencimientos de declaraciones (IVA mensual o semestral
- `consultar_semaforo_rimpe` — Proyecta los ingresos anuales del emisor (lo facturado en Contadeo:
- `consultar_obligaciones` — Checklist de obligaciones según el perfil del emisor (régimen,
- `consultar_f104` — Borrador del F104 (declaración de IVA) del período, EXPLICADO.
- `consultar_f103` — Auxiliar de la declaración mensual de retenciones en la fuente de
- `consultar_ats` — Borrador de SOLO LECTURA del Anexo Transaccional Simplificado del
- `explicar_f104` — Explica el F104 casillero por casillero, al nivel de alguien que
- `simular_f104` — Responde '¿qué pasa si...?' sobre el borrador del F104 del período:
- `validar_f104` — Chequeo previo a la declaración: cruza el borrador del F104 contra
- `consultar_ruc` — Autocompleta los datos de un comprador a partir de su RUC (13 díg.) o
- `anular_comprobante` — Marca una factura AUTORIZADA como ANULADA en Contadeo (registro
- `reenviar_comprobante` — Reenvía por correo el comprobante (RIDE/XML) de una factura AUTORIZADA
- `consultar_libro_ventas` — Libro de ventas del período: comprobantes emitidos AUTORIZADOS con sus
- `consultar_libro_compras` — Libro de compras del período: comprobantes recibidos de proveedores con
- `registrar_compra` — Registra un comprobante que TE FACTURARON, para que su IVA cuente en
- `clasificar_proveedor` — Guarda de una vez si los comprobantes de un proveedor dan crédito de

## Install

**Verdict: review** — Installable, but 1 thing to check first: No publisher has proved control of this listing; it is indexed, not vouched for.
**Cautions** (coverage gaps and advisories — never blocking)
- No publisher has proved control of this listing; it is indexed, not vouched for.
**Config** (claude-code):
```json
"{\n  \"mcpServers\": {\n    \"contadeo\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"contadeo-mcp\"\n      ],\n      \"env\": {\n        \"CONTADEO_API_KEY\": \"<YOUR_CONTADEO_API_KEY>\",\n        \"MCP_CONFIRM_SECRET\": \"<YOUR_MCP_CONFIRM_SECRET>\"\n      }\n    }\n  }\n}"
```
**Credentials it will ask for** (names only — Forge never holds a value):
- `CONTADEO_API_KEY` — Contadeo API Key (required)
- `MCP_CONFIRM_SECRET` — Mcp Confirm Secret (optional)
Placeholders only. Forge never holds, brokers, or transmits a credential value — replace each <YOUR_NAME> in your own config file. Do not send a value back to Forge; no Forge endpoint accepts one.
- This entry needs 2 credentials (1 required). The generated config carries placeholders, so it will fail in the editor rather than at runtime if they are left unset.

## Blast radius

Moderate blast radius — runs locally and hosted; holds an api key.
- Floor 29, ceiling 29 (tier: moderate)
- This is impact, not likelihood. A high radius is not a defect: a filesystem server is supposed to write files. It is never part of the trust score.

## Machine-readable views of this entry

- Signed JSON: https://forgeregistry.com/api/v1/packages/contadeo-mcp
- Install plan: https://forgeregistry.com/api/v1/packages/contadeo-mcp/install-plan
- Alternatives: https://forgeregistry.com/api/v1/alternatives/contadeo-mcp
- HTML page: https://forgeregistry.com/registry/contadeo-mcp
- MCP: POST https://forgeregistry.com/api/mcp → `forge_get_package` / `forge_install_plan`

## About this document

Generated by Forge (https://forgeregistry.com) — a compact rendering of the same record served, signed, at the JSON URL above. Trust and scan facts are the registry's own measurements; anything Forge did not measure is named as unmeasured rather than omitted.
