MCP.Market

Reportia MCP server

by javalenciacai·io.github.javalenciacai/mcp-reportia·v0.3.2

Reportia HTTP API as 66 curated MCP tools (accounting, mappings, SIIGO).

B78/100grade B
What users say
No reviews yet
Be the first
Safety scan
B78/100

full report

Adoption
New

0 stars51 downloads/wk

Reviews

Write one

Nobody 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 posts

Read from the package source without running it. The installed server may list more.

  • reportia_account_codes_search

    Busca códigos de cuenta únicos por prefijo dentro de los movimientos contables de una empresa.

  • reportia_account_mapping_createwrite action

    Crea un nuevo mapeo de cuenta contable para una empresa.

  • reportia_account_mapping_deletewrite action

    Elimina un mapeo de cuenta contable.

  • reportia_account_mapping_updatewrite action

    Actualiza un mapeo de cuenta contable existente.

  • reportia_account_mappings_list

    Lista los mapeos de cuentas contables para una empresa.

  • reportia_commission_export_excel

    Exporta 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_list

    Lista el reporte de comisiones de una empresa con filtros opcionales (fecha, terceros, vendedores, estado de pago).

  • reportia_companies_list

    Lista las empresas accesibles para el usuario autenticado (GET /api/companies).

  • reportia_company_activatewrite action

    Activa una empresa (POST /api/companies/:id/activate). Requiere confirm=true.

  • reportia_company_get

    Obtiene el detalle de una empresa (GET /api/companies/:id).

  • reportia_company_settings_get

    Obtiene la configuracion de una empresa (GET /api/companies/:id/settings).

  • reportia_company_settings_updatewrite action

    Actualiza parcialmente la configuración de una empresa (PATCH /api/companies/:id/settings). DESTRUCTIVA: requiere { confirm: true }.

  • reportia_cost_center_mapping_createwrite action

    Crea un mapeo de centro de costo. Campos: centerCode, name (mín 1 car), subCenterCode opcional (default "").

  • reportia_cost_center_mapping_deletewrite action

    Elimina un mapeo de centro de costo (DELETE). REQUIERE { confirm: true } — operación destructiva.

  • reportia_cost_center_mapping_updatewrite action

    Actualiza un mapeo de centro de costo existente (PUT). Campos opcionales: centerCode, subCenterCode, name.

  • reportia_cost_center_mappings_list

    Lista los mapeos de centros de costo para una empresa.

  • reportia_cost_center_mappings_suggestions

    Devuelve sugerencias de centros de costo desde los movimientos contables de la empresa.

  • reportia_cost_center_report_createwrite action

    Crea 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 action

    Elimina un reporte de centros de costo y todas sus líneas (CASCADE). REQUIERE { confirm: true } — destructiva.

  • reportia_cost_center_report_duplicate

    Duplica 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 action

    Ejecuta 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_excel

    Ejecuta el reporte y descarga el resultado como .xlsx (descarga segura). Requiere startDate y endDate.

  • reportia_cost_center_report_export_pdf

    Ejecuta el reporte y descarga el resultado como .pdf (descarga segura). Requiere startDate y endDate.

  • reportia_cost_center_report_get

    Detalle de un reporte configurable de centros de costo con sus líneas.

  • reportia_cost_center_report_updatewrite action

    Reemplaza un reporte y todas sus líneas (PUT). Mismo body que create.

  • reportia_cost_center_reports_list

    Lista los reportes configurables de centros de costo para una empresa.

  • reportia_cost_centers_available

    Lista todos los centros de costo disponibles de la empresa (usado por el wizard de creación de reportes).

  • reportia_health

    Devuelve 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_system

    Verifica 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_workers

    Devuelve 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 action

    Envia UNA factura por email a un destinatario explicito. DESTRUCTIVA: requiere { confirm: true }. Envuelve POST /api/invoices/:invoiceId/email.

  • reportia_invoice_settings_createwrite action

    Crea 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 action

    Obtiene la configuracion de facturacion (titulo, footer, proveedor de email, etc.) de una empresa.

  • reportia_invoice_settings_updatewrite action

    Actualiza parcialmente la configuracion de facturacion (PATCH). El body libre es un record<string, unknown> aceptado por la API. DESTRUCTIVA: requiere { confirm: true }.

  • reportia_invoices_list

    Lista las facturas de una empresa con filtros opcionales: startDate, endDate, nit, numeroDocumento, tipoComprobante, codigoComprobante.

  • reportia_invoices_send_multiplewrite action

    Envia VARIAS facturas por email usando la libreta de direcciones del cliente. DESTRUCTIVA: requiere { confirm: true }. Envuelve POST /api/invoices/send-multiple.

  • reportia_line_group_description

    Devuelve la descripción asociada a un par (line, group) ya mapeado para la empresa.

  • reportia_line_group_mapping_createwrite action

    Crea un mapeo de línea/grupo para una empresa. Campos: line, group (mín 1 car), description opcional.

  • reportia_line_group_mapping_deletewrite action

    Elimina un mapeo de línea/grupo (DELETE). REQUIERE { confirm: true } — operación destructiva.

  • reportia_line_group_mapping_updatewrite action

    Actualiza un mapeo de línea/grupo existente (PUT). Los campos son opcionales: line, group, description.

  • reportia_line_group_mappings_list

    Lista los mapeos de líneas/grupos configurados para una empresa.

  • reportia_line_group_suggestions_by_type

    Devuelve sugerencias filtradas por tipo. type debe ser exactamente "lines" o "groups" (verificado en backend).

  • reportia_line_group_suggestions_lines_groups

    Devuelve sugerencias de líneas y grupos derivadas de los movimientos contables de la empresa.

  • reportia_logoutwrite action

    Cierra 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 action

    Elimina todos los movimientos contables de una empresa después de confirmar explícitamente.

  • reportia_movements_export_excel

    Exporta movimientos contables a un archivo Excel.

  • reportia_movements_export_pdf

    Exporta movimientos contables a un archivo PDF.

  • reportia_movements_list

    Lista movimientos contables crudos (raw rows) con filtros opcionales y paginación

  • reportia_salesperson_mapping_createwrite action

    Crea un nuevo mapeo de vendedor para una empresa. Body: salespersonId, salespersonName.

  • reportia_salesperson_mapping_deletewrite action

    Elimina un mapeo de vendedor. DESTRUCTIVA: requiere { confirm: true }.

  • reportia_salesperson_mapping_updatewrite action

    Actualiza parcialmente un mapeo de vendedor (PATCH /:mappingId).

  • reportia_salesperson_mappings_list

    Lista los mapeos de vendedores (salespersonId <-> salespersonName) de una empresa.

  • reportia_salesperson_options_list

    Lista las opciones de vendedores (dropdown) para una empresa: id, name, displayValue.

  • reportia_siigo_clients_list

    Lista 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_get

    Obtiene 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 action

    Obtiene la trazabilidad completa (trace) de una corrida de sincronizacion SIIGO especifica (GET /api/companies/:companyId/siigo/sync/runs/:runId/trace).

  • reportia_siigo_schedules_list

    Lista las programaciones (schedules) de sincronizacion SIIGO configuradas para una empresa (GET /api/companies/:companyId/siigo/schedules).

  • reportia_siigo_settings_get

    Obtiene la configuracion SIIGO Pyme de una empresa (GET /api/companies/:companyId/siigo-settings).

  • reportia_siigo_sync_runs_list

    Lista 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_nit

    Obtiene un tercero por su NIT.

  • reportia_third_parties_list

    Lista todos los terceros de una empresa.

  • reportia_third_parties_portfolio_balance

    Obtiene el balance de cartera de una empresa para los NITs dados.

  • reportia_third_parties_search

    Busca terceros por NIT o nombre.

  • reportia_upload_status_getwrite action

    Obtiene 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_list

    Lista 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_whoami

    Devuelve 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

no findings
  • 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
Overall 78/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

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
Add to Cursor

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-usage

Flujo 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).

  1. Abre https://www.npmjs.com/package/@james.valencia/mcp-reportia/settings (logueado como james.valencia en el navegador).
  2. 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).
  3. Completa el formulario con estos valores exactos (la doc oficial los lista así):
  1. 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.