Reportia MCP server
io.github.javalenciacai/mcp-reportia·v0.3.2Reportia HTTP API as 66 curated MCP tools (accounting, mappings, SIIGO).
0 stars51 downloads/wk
Reviews
Write oneNobody has reviewed Reportia yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Reportia tools (66, 27 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
reportia_account_codes_searchBusca códigos de cuenta únicos por prefijo dentro de los movimientos contables de una empresa.
reportia_account_mapping_createwrite actionCrea un nuevo mapeo de cuenta contable para una empresa.
reportia_account_mapping_deletewrite actionElimina un mapeo de cuenta contable.
reportia_account_mapping_updatewrite actionActualiza un mapeo de cuenta contable existente.
reportia_account_mappings_listLista los mapeos de cuentas contables para una empresa.
reportia_commission_export_excelExporta el reporte completo de comisiones a Excel con jerarquía de 3 niveles (Plan 37). Recibe los mismos filtros que la herramienta de listado.
reportia_commission_listLista el reporte de comisiones de una empresa con filtros opcionales (fecha, terceros, vendedores, estado de pago).
reportia_companies_listLista las empresas accesibles para el usuario autenticado (GET /api/companies).
reportia_company_activatewrite actionActiva una empresa (POST /api/companies/:id/activate). Requiere confirm=true.
reportia_company_getObtiene el detalle de una empresa (GET /api/companies/:id).
reportia_company_settings_getObtiene la configuracion de una empresa (GET /api/companies/:id/settings).
reportia_company_settings_updatewrite actionActualiza parcialmente la configuración de una empresa (PATCH /api/companies/:id/settings). DESTRUCTIVA: requiere { confirm: true }.
reportia_cost_center_mapping_createwrite actionCrea un mapeo de centro de costo. Campos: centerCode, name (mín 1 car), subCenterCode opcional (default "").
reportia_cost_center_mapping_deletewrite actionElimina un mapeo de centro de costo (DELETE). REQUIERE { confirm: true } — operación destructiva.
reportia_cost_center_mapping_updatewrite actionActualiza un mapeo de centro de costo existente (PUT). Campos opcionales: centerCode, subCenterCode, name.
reportia_cost_center_mappings_listLista los mapeos de centros de costo para una empresa.
reportia_cost_center_mappings_suggestionsDevuelve sugerencias de centros de costo desde los movimientos contables de la empresa.
reportia_cost_center_report_createwrite actionCrea un reporte configurable de centros de costo con sus líneas. chartType ∈ {bar, line, pie}; operaciones por línea ∈ {ADD, SUBTRACT, IGNORE}.
reportia_cost_center_report_deletewrite actionElimina un reporte de centros de costo y todas sus líneas (CASCADE). REQUIERE { confirm: true } — destructiva.
reportia_cost_center_report_duplicateDuplica un reporte existente con un nuevo nombre (3-255 caracteres). Crea un reporte nuevo en el backend. DESTRUCTIVA: requiere { confirm: true }.
reportia_cost_center_report_executewrite actionEjecuta un reporte aplicando sus operaciones sobre los movimientos del rango [startDate, endDate] (YYYY-MM-DD). Puede ser costoso (consulta SQL sobre millones de filas). DESTRUCTIVA: requiere { confirm: true }.
reportia_cost_center_report_export_excelEjecuta el reporte y descarga el resultado como .xlsx (descarga segura). Requiere startDate y endDate.
reportia_cost_center_report_export_pdfEjecuta el reporte y descarga el resultado como .pdf (descarga segura). Requiere startDate y endDate.
reportia_cost_center_report_getDetalle de un reporte configurable de centros de costo con sus líneas.
reportia_cost_center_report_updatewrite actionReemplaza un reporte y todas sus líneas (PUT). Mismo body que create.
reportia_cost_center_reports_listLista los reportes configurables de centros de costo para una empresa.
reportia_cost_centers_availableLista todos los centros de costo disponibles de la empresa (usado por el wizard de creación de reportes).
reportia_healthDevuelve el estado de salud de la API de Reportia y un diagnóstico del cliente MCP (modo auth, base URL, descarga dir). Útil como primera llamada para validar conectividad.
reportia_health_queue_systemVerifica la salud del sistema de colas (queue system health check, sin autenticacion de empresa). Util para diagnostico de BullMQ / Redis (GET /api/health/queue-system).
reportia_health_workersDevuelve la salud de los workers de la cola y el lag actual, con un flag `isStuck` y timestamp de la verificacion (GET /api/queue/workers/health).
reportia_invoice_email_sendwrite actionEnvia UNA factura por email a un destinatario explicito. DESTRUCTIVA: requiere { confirm: true }. Envuelve POST /api/invoices/:invoiceId/email.
reportia_invoice_settings_createwrite actionCrea o reemplaza la configuracion de facturacion (POST). El body libre es un record<string, unknown> aceptado por la API. DESTRUCTIVA: requiere { confirm: true }.
reportia_invoice_settings_getwrite actionObtiene la configuracion de facturacion (titulo, footer, proveedor de email, etc.) de una empresa.
reportia_invoice_settings_updatewrite actionActualiza parcialmente la configuracion de facturacion (PATCH). El body libre es un record<string, unknown> aceptado por la API. DESTRUCTIVA: requiere { confirm: true }.
reportia_invoices_listLista las facturas de una empresa con filtros opcionales: startDate, endDate, nit, numeroDocumento, tipoComprobante, codigoComprobante.
reportia_invoices_send_multiplewrite actionEnvia VARIAS facturas por email usando la libreta de direcciones del cliente. DESTRUCTIVA: requiere { confirm: true }. Envuelve POST /api/invoices/send-multiple.
reportia_line_group_descriptionDevuelve la descripción asociada a un par (line, group) ya mapeado para la empresa.
reportia_line_group_mapping_createwrite actionCrea un mapeo de línea/grupo para una empresa. Campos: line, group (mín 1 car), description opcional.
reportia_line_group_mapping_deletewrite actionElimina un mapeo de línea/grupo (DELETE). REQUIERE { confirm: true } — operación destructiva.
reportia_line_group_mapping_updatewrite actionActualiza un mapeo de línea/grupo existente (PUT). Los campos son opcionales: line, group, description.
reportia_line_group_mappings_listLista los mapeos de líneas/grupos configurados para una empresa.
reportia_line_group_suggestions_by_typeDevuelve sugerencias filtradas por tipo. type debe ser exactamente "lines" o "groups" (verificado en backend).
reportia_line_group_suggestions_lines_groupsDevuelve sugerencias de líneas y grupos derivadas de los movimientos contables de la empresa.
reportia_logoutwrite actionCierra la sesión actual contra Reportia (POST /api/auth/logout). Invalida la sesión local del cliente MCP tras el logout.
reportia_movements_delete_allwrite actionElimina todos los movimientos contables de una empresa después de confirmar explícitamente.
reportia_movements_export_excelExporta movimientos contables a un archivo Excel.
reportia_movements_export_pdfExporta movimientos contables a un archivo PDF.
reportia_movements_listLista movimientos contables crudos (raw rows) con filtros opcionales y paginación
reportia_salesperson_mapping_createwrite actionCrea un nuevo mapeo de vendedor para una empresa. Body: salespersonId, salespersonName.
reportia_salesperson_mapping_deletewrite actionElimina un mapeo de vendedor. DESTRUCTIVA: requiere { confirm: true }.
reportia_salesperson_mapping_updatewrite actionActualiza parcialmente un mapeo de vendedor (PATCH /:mappingId).
reportia_salesperson_mappings_listLista los mapeos de vendedores (salespersonId <-> salespersonName) de una empresa.
reportia_salesperson_options_listLista las opciones de vendedores (dropdown) para una empresa: id, name, displayValue.
reportia_siigo_clients_listLista los clientes remotos disponibles en SIIGO para una empresa (proxy contra el servicio SIIGO; requiere token externo vigente) (GET /api/companies/:companyId/siigo/clients).
reportia_siigo_history_getObtiene el historial de comandos SIIGO de una empresa. ⚠️ ATENCION: si el servidor detecta comandos activos, dispara una sincronizacion on-demand antes de devolver el resultado. DESTRUCTIVA: requiere { confirm: true } para evitar sincronizaciones accidentales.
reportia_siigo_run_trace_getwrite actionObtiene la trazabilidad completa (trace) de una corrida de sincronizacion SIIGO especifica (GET /api/companies/:companyId/siigo/sync/runs/:runId/trace).
reportia_siigo_schedules_listLista las programaciones (schedules) de sincronizacion SIIGO configuradas para una empresa (GET /api/companies/:companyId/siigo/schedules).
reportia_siigo_settings_getObtiene la configuracion SIIGO Pyme de una empresa (GET /api/companies/:companyId/siigo-settings).
reportia_siigo_sync_runs_listLista las corridas de sincronizacion SIIGO de una empresa (GET /api/companies/:companyId/siigo/sync/runs). Parametro opcional `limit` (1-200, por defecto 50).
reportia_third_parties_get_by_nitObtiene un tercero por su NIT.
reportia_third_parties_listLista todos los terceros de una empresa.
reportia_third_parties_portfolio_balanceObtiene el balance de cartera de una empresa para los NITs dados.
reportia_third_parties_searchBusca terceros por NIT o nombre.
reportia_upload_status_getwrite actionObtiene el estado actual de un upload especifico, incluyendo progreso visible y diagnostico de su job en cola (GET /api/upload/:uploadId/status).
reportia_uploads_history_listLista el historial de cargas (uploads) de una empresa, filtrado por el usuario autenticado y limitado a 20 entradas visibles (GET /api/companies/:companyId/upload-history).
reportia_whoamiDevuelve el perfil del usuario autenticado en Reportia (GET /api/auth/me). Útil para confirmar que la sesión está activa.
Public scan report
scanner v0.1.10 · 2026-10-14 · same rubric, same numbers if you re-run it
- Code scan32 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 32 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Reportia compares
Against every graded Finance MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 78/100
- higher than 62% of 1,761 Finance servers
- Tools
- 66
- the typical Finance server has 8
- Tools that change things
- 41%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 51
- more than 49% of 421 Finance servers with a package
What its tools let an agent do: 39 read · 27 change
Install Reportia in Claude Code, Cursor or VS Code
Runs npx -y @james.valencia/mcp-reportia on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add mcp-reportia -- npx -y @james.valencia/mcp-reportia
What the publisher says
From the Reportia repository's README, as published. We do not edit it. Read it on GitHub
mcp-reportia
Servidor MCP (Model Context Protocol) independiente que envuelve la API HTTP real de Reportia y la expone a través del transporte stdio con JSON-RPC newline-delimited. Pensado para ser consumido por clientes MCP (Claude Desktop, Cursor, Hermes Agent, otros) con un único npx, sin ejecutar código de servidor propio.
Esta capa no contiene lógica de negocio ni secretos propios: actúa como traductor entre el protocolo MCP y los endpoints REST de Reportia. Las credenciales se inyectan desde variables de entorno.
Índice
- Dónde está indexado
- Instalación y uso rápido
- Variables de entorno
- Configuración en clientes MCP
- Flujo de release
- Herramientas disponibles
- Limitaciones conocidas
- Seguridad
- Rutas cubiertas y omitidas
- Desarrollo local
- Pruebas
- Inspección con MCP Inspector
Dónde está indexado
Este servidor MCP está publicado y discoverable en:
Instalación via skills.sh:
npx skills add javalenciacai/mcp-reportia --skill reportia-mcp-usageFlujo de release
Este repo publica automáticamente a npm y al MCP Registry oficial cuando se pushea un tag v a main. La indexación en skills.sh** es automática (scrapeo de GitHub).
Configuración inicial (una sola vez)
Opción elegida: npm Trusted Publishing (OIDC)
La configuración vive en la página del paquete (no en /settings/james.valencia/security — esa URL es para tokens tradicionales).
- Abre https://www.npmjs.com/package/@james.valencia/mcp-reportia/settings (logueado como james.valencia en el navegador).
- En la sección "Trusted Publisher", click en "Add a trusted publisher" (o "GitHub Actions" según el wording de tu versión de npmjs.com).
- Completa el formulario con estos valores exactos (la doc oficial los lista así):
- Click "Add" o "Save". npm NO valida la configuración al guardar, pero el workflow fallará en runtime si los datos no coinciden exactamente.
Subir el workflow a Node 24 (necesario para Trusted Publishing)
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Reportia: common questions
- Is Reportia MCP server safe?
- Mostly: it is graded B (78/100). Read the Reportia safety report
- How do I install Reportia?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Reportia need an API key?
- Yes. The registry entry asks for
REPORTIA_TOKEN,REPORTIA_COOKIE,REPORTIA_PASSWORD. - Is Reportia maintained?
- The last commit was 53 days ago (2026-09-12). The latest release is v0.3.2.
- What can I use instead of Reportia?
- Servers from other publishers that do the same job: Siigo MCP server, Benethos Lexware Office MCP server and E Arveldaja MCP server.
- How does Reportia compare with other Finance MCP servers?
- safety score 78/100 (higher than 62% of 1,761 Finance servers); tools 66 (the typical Finance server has 8); tools that change things 41% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Reportia
Same job from other publishers: the closest match first, then the best rated.
- not reviewedGrowingB
- Benethos Lexware OfficeUnofficial MCP server for the Lexware Office accounting API — runs over stdio or HTTP.not reviewedGrowingA
- E ArveldajaEstonian e-arveldaja (RIK e-Financials) accounting — invoices, bank import, reports.not reviewedEstablishedB
- OpenAccountantsOpen-source AI accounting skills verified by licensed accountants (tax, VAT, payroll).not reviewedEstablishedB
Norman Finance — AI Bookkeeping, Accounting & TaxesBookkeeping, invoices and tax workflows for European businesses, including Polish KPiR and JPK.not reviewedGrowingA