¿Qué es Fiscalapi MCP?

Es un servidor remoto del Model Context Protocol (MCP) que conecta tu agente de IA a tu cuenta de Fiscalapi. Con él, el agente emite, consulta y cancela CFDI 4.0, administra personas y productos, solicita descargas masivas y revisa RFC en las listas 69-B, todo a través de la API de Fiscalapi.

¿Con qué clientes funciona?

Con un cliente de IA, como Claude Code, Cursor o Codex, o con tu propia aplicación o agente hecho con un SDK de MCP. En detalle, funciona con cualquier cliente o aplicación que use MCP por streamable HTTP y envíe headers, como Claude Code, Cursor, VS Code con GitHub Copilot, Codex y Windsurf. Se conecta con una API key y tu tenant. Esta versión no tiene OAuth, así que no funciona en ChatGPT ni en los conectores de claude.ai.

¿Puedo usarlo desde mi propia aplicación o agente?

Sí. El backend de tu aplicación se conecta con un SDK de MCP, con la URL del ambiente y los headers X-API-KEY y X-TENANT-KEY. Tu aplicación le da las tools a su modelo y ejecuta la que el modelo elige. Llámalo desde tu servidor, nunca desde el navegador. La guía en docs.fiscalapi.com/mcp-server trae ejemplos en TypeScript, Python y C#.

No tiene costo adicional. Usa los mismos créditos que la API: cada CFDI emitido usa 1 timbre, cada consulta a las listas 69-B usa 1 crédito de validación por lista y una regla de descarga masiva ocupa un asiento mientras exista. Las demás tools no consumen créditos.

¿Puedo probarlo sin timbrar facturas reales?

Sí. Conéctalo a https://test.mcp.fiscalapi.com/mcp con una API key de pruebas. Timbra en el PAC de pruebas y las facturas no tienen validez fiscal.

¿El agente puede ver mis certificados o contraseñas?

No. Ninguna tool recibe ni devuelve CSD, e.firma, llaves privadas ni contraseñas. El agente emite con un emisor que ya tiene su CSD cargado en Fiscalapi.

¿Qué pasa si el agente repite una emisión?

Cada emisión lleva una llave de idempotencia. Si el agente la repite con la misma llave, recibe la factura que ya se timbró y no se emite otra.

¿Cómo limito al agente a consultar?

Conéctalo a la ruta /mcp/readonly: https://test.mcp.fiscalapi.com/mcp/readonly en pruebas y https://live.mcp.fiscalapi.com/mcp/readonly en producción. Esa ruta publica solo las tools de consulta. Limita lo que ve el agente, no la API key: con la misma API key, otra conexión a /mcp sí puede emitir y cancelar.

¿Qué datos recibe el proveedor del modelo?

Lo que escribes en el chat o lo que tu aplicación le envía al modelo, y lo que devuelven las tools, como RFC, razones sociales y conceptos, llega al proveedor del modelo que usan tu cliente o tu aplicación. Revisa sus condiciones antes de operar datos reales.

¿En qué se distingue del MCP de documentación?

Fiscalapi MCP opera tu cuenta: emite, consulta y cancela. El MCP de documentación ayuda a tu agente a escribir tu integración con la referencia de la API y las guías; corre en tu computadora y no necesita API key. Conecta los dos si tu agente también escribe código.

Factura CFDI desde
tu agente de IA

Fiscalapi MCP conecta tu cuenta a un cliente de IA, como Claude Code, Cursor o Codex, o a tu propia aplicación o agente. Pídele a tu agente que emita, consulte o cancele CFDI 4.0 en lenguaje natural, con los mismos permisos y créditos que la API.

Crear cuenta Ver la guía

No cuesta nada aparte: cada CFDI que emite tu agente usa 1 timbre, igual que en la API.

Qué le puedes pedir

Escribe lo que necesitas. El agente elige la tool, busca los datos en tu cuenta y te muestra el resultado.

«Factura las 3 consultorías de mayo a Comercializadora del Norte»

El agente busca al receptor y los productos, arma la factura de ingreso y la timbra cuando la confirmas.

«Registra el pago que recibí ayer de la factura A-1024»

Emite el complemento de pago de la factura PPD con la fecha y el monto del pago.

«¿Qué facturas emití esta semana y cuáles siguen vigentes?»

Lista tus facturas con filtros y consulta en el SAT el estatus de cada una.

«Cancela la factura A-1031: el RFC del receptor está mal»

Elige el motivo de cancelación, cancela la factura ante el SAT y revisa el estatus de la cancelación.

«¿Este proveedor aparece en la lista 69-B?»

Revisa un RFC en las listas 69-B y 69-B Bis del SAT antes de pagarle.

«Descarga del SAT los CFDI que recibí en octubre»

Solicita la descarga masiva del periodo y te da el resumen de los documentos cuando termina.

27 tools sobre la API de Fiscalapi

Cada tool llama a la API con tu API key. Las reglas fiscales y las validaciones son las mismas, y un rechazo llega al agente con su detalle.

7 tipos de CFDI

Factura de ingreso, nota de crédito, complemento de pago, factura global, nómina, Carta Porte y Comercio Exterior, con una tool para cada uno.

Consulta y cancelación

Lista y obtiene facturas, consulta su estatus en el SAT, las cancela con su motivo y envía el XML y el PDF por correo.

Personas y productos

Busca, registra y actualiza emisores, receptores y productos con sus datos fiscales.

Catálogos del SAT

Busca claves en los catálogos del SAT del CFDI 4.0, para que el agente no las invente.

Descarga masiva

Crea reglas de descarga, solicita al SAT los CFDI de un periodo y consulta el resultado.

Listas 69-B

Revisa si un RFC aparece en las listas 69-B y 69-B Bis del SAT.

Créditos y certificados

Muestra el ambiente, tu saldo de créditos, tus movimientos recientes y la vigencia de tus CSD y tu e.firma.

Webhooks

Lista los eventos de los últimos 30 días con sus entregas y reenvía el que necesites.

Además, 3 prompts guiados llevan al agente paso a paso por una factura, un complemento de pago o una cancelación.

Cómo se conecta

Se autentica igual que la API: con tu API key y tu tenant, en los headers X-API-KEY y X-TENANT-KEY.

1
Crea una API key
En el dashboard, crea una API key solo para el MCP y asígnala a la persona cuyos permisos tendrá el agente.
2
Guarda tus credenciales
Define la API key y tu tenant como variables de entorno o en el gestor de secretos de tu servidor. Tu cliente o tu aplicación las lee de ahí, y no quedan escritas en ningún archivo.
3
Agrega el servidor
Agrega la URL y los dos headers a tu cliente de IA o, con un SDK de MCP, a tu aplicación. En la página de API keys del dashboard, Conectar MCP copia la configuración de los clientes más comunes.
4
Pide en lenguaje natural
Empieza en el ambiente de pruebas. Cuando tu flujo esté listo, cambia la URL y la API key a producción.

Un servidor por ambiente

La URL fija el ambiente de la conexión. El agente no puede cambiarlo.

URL de Fiscalapi MCP por ambiente y lo que permite cada una
Conexión	URL	Qué hace
Pruebas	`https://test.mcp.fiscalapi.com/mcp` Timbra en el PAC de pruebas. Las facturas no tienen validez fiscal.	Timbra en el PAC de pruebas. Las facturas no tienen validez fiscal.
Producción	`https://live.mcp.fiscalapi.com/mcp` Timbra CFDI reales ante el SAT y consume timbres.	Timbra CFDI reales ante el SAT y consume timbres.
Pruebas, solo lectura	`https://test.mcp.fiscalapi.com/mcp/readonly` Publica solo las 10 tools de consulta del ambiente de pruebas: el agente no puede emitir ni cancelar.	Publica solo las 10 tools de consulta del ambiente de pruebas: el agente no puede emitir ni cancelar.
Producción, solo lectura	`https://live.mcp.fiscalapi.com/mcp/readonly` Publica solo las 10 tools de consulta del ambiente de producción: el agente no puede emitir ni cancelar.	Publica solo las 10 tools de consulta del ambiente de producción: el agente no puede emitir ni cancelar.

Usa una API key del mismo ambiente que la URL: una API key de pruebas no funciona en producción.

Seguridad

Lo que el servidor garantiza en cada conexión. Ten en cuenta que lo que escribes en el chat o lo que tu aplicación le envía al modelo, y lo que devuelven las tools, llega al proveedor del modelo que usan tu cliente o tu aplicación.

Tus certificados no pasan por el agente
Los CSD, la e.firma y sus contraseñas no entran ni salen por ninguna tool. Se cargan en el dashboard o por la API.
Los permisos de la API key
El agente puede hacer lo mismo que la persona dueña de la API key, y nada más. Con una API key solo para el MCP, la revocas cuando quieras sin tocar tus otras integraciones.
Un ambiente por conexión
Cada conexión opera solo el ambiente de su URL. Una conexión de pruebas nunca timbra en producción.
Sin facturas duplicadas
Cada emisión lleva una llave de idempotencia. Si el agente reintenta, recibe la misma factura en lugar de timbrar otra.
Confirmación al emitir y cancelar
En los clientes que soportan la confirmación del protocolo MCP (elicitation), el servidor te muestra un resumen y espera tu respuesta. En los demás, confirmas con la aprobación de tools de tu cliente. En tu propia aplicación, tu aplicación pide la confirmación antes de emitir o cancelar.
XML y PDF por correo
Ninguna tool devuelve el XML ni el PDF en el chat. Se envían por correo al receptor o a la dirección que indiques.

Recursos para desarrolladores

Documentación detallada, SDKs oficiales y herramientas para integrarte rápidamente.

Documentación

Guías de integración, referencia de API y ejemplos de código

GitHub

SDKs oficiales, ejemplos y código fuente abierto

Postman

Colección lista para probar todos los endpoints

Preguntas frecuentes sobre Fiscalapi MCP

¿Qué es Fiscalapi MCP?: Es un servidor remoto del Model Context Protocol (MCP) que conecta tu agente de IA a tu cuenta de Fiscalapi. Con él, el agente emite, consulta y cancela CFDI 4.0, administra personas y productos, solicita descargas masivas y revisa RFC en las listas 69-B, todo a través de la API de Fiscalapi.
¿Con qué clientes funciona?: Con un cliente de IA, como Claude Code, Cursor o Codex, o con tu propia aplicación o agente hecho con un SDK de MCP. En detalle, funciona con cualquier cliente o aplicación que use MCP por streamable HTTP y envíe headers, como Claude Code, Cursor, VS Code con GitHub Copilot, Codex y Windsurf. Se conecta con una API key y tu tenant. Esta versión no tiene OAuth, así que no funciona en ChatGPT ni en los conectores de claude.ai.
¿Puedo usarlo desde mi propia aplicación o agente?: Sí. El backend de tu aplicación se conecta con un SDK de MCP, con la URL del ambiente y los headers X-API-KEY y X-TENANT-KEY. Tu aplicación le da las tools a su modelo y ejecuta la que el modelo elige. Llámalo desde tu servidor, nunca desde el navegador. La guía en docs.fiscalapi.com/mcp-server trae ejemplos en TypeScript, Python y C#.
¿Cuánto cuesta?: No tiene costo adicional. Usa los mismos créditos que la API: cada CFDI emitido usa 1 timbre, cada consulta a las listas 69-B usa 1 crédito de validación por lista y una regla de descarga masiva ocupa un asiento mientras exista. Las demás tools no consumen créditos.
¿Puedo probarlo sin timbrar facturas reales?: Sí. Conéctalo a https://test.mcp.fiscalapi.com/mcp con una API key de pruebas. Timbra en el PAC de pruebas y las facturas no tienen validez fiscal.
¿El agente puede ver mis certificados o contraseñas?: No. Ninguna tool recibe ni devuelve CSD, e.firma, llaves privadas ni contraseñas. El agente emite con un emisor que ya tiene su CSD cargado en Fiscalapi.
¿Qué pasa si el agente repite una emisión?: Cada emisión lleva una llave de idempotencia. Si el agente la repite con la misma llave, recibe la factura que ya se timbró y no se emite otra.
¿Cómo limito al agente a consultar?: Conéctalo a la ruta /mcp/readonly: https://test.mcp.fiscalapi.com/mcp/readonly en pruebas y https://live.mcp.fiscalapi.com/mcp/readonly en producción. Esa ruta publica solo las tools de consulta. Limita lo que ve el agente, no la API key: con la misma API key, otra conexión a /mcp sí puede emitir y cancelar.
¿Qué datos recibe el proveedor del modelo?: Lo que escribes en el chat o lo que tu aplicación le envía al modelo, y lo que devuelven las tools, como RFC, razones sociales y conceptos, llega al proveedor del modelo que usan tu cliente o tu aplicación. Revisa sus condiciones antes de operar datos reales.
¿En qué se distingue del MCP de documentación?: Fiscalapi MCP opera tu cuenta: emite, consulta y cancela. El MCP de documentación ayuda a tu agente a escribir tu integración con la referencia de la API y las guías; corre en tu computadora y no necesita API key. Conecta los dos si tu agente también escribe código.

Da el siguiente paso

Conecta tu agente a Fiscalapi

Crea tu cuenta, genera una API key de pruebas y emite tu primera factura desde tu agente o tu aplicación.