Una skill. Tu agente factura en tu sistema.
No es un proyecto de tres semanas. La IA pega el timbrado donde ya operas.
Instala la skill de CFDI Express y pídele a tu agente que integre la facturación en tu POS, ERP o checkout. Él escribe la integración REST con la autenticación, la idempotencia y los endpoints correctos, sin adivinar campos del SAT.
$ npx skills add CFDI-Express/skillsFunciona en Claude Code, Cursor, Codex, OpenCode y cualquier agente soportado por skills.
Sandbox gratis con llaves sk_test_. $1 MXN por timbre en producción, sin mensualidad.
Dos caminos, una cuenta
La skill es para que el agente escriba la integración en tu código. El servidor MCP es para que facture por chat. Se combinan y comparten cuenta, saldo y emisores.
El agente escribe la integración REST
Instalas npx skills add CFDI-Express/skills y describes lo que necesitas: “cuando la orden se pague, timbra un PUE”. El agente lee el OpenAPI, usa las llaves sk_test_/sk_live_, manda Idempotency-Key y maneja los errores problem+json con su código estable. Tú revisas el PR.
El agente factura en vivo
Conecta api.cfdi.express/mcp a claude.ai, ChatGPT, Claude Code o Cursor y pídele en lenguaje natural que timbre facturas, registre pagos REP o cancele CFDIs. 14 herramientas, OAuth 2.1 o API key, con modo de pruebas en /mcp/test.
Misma cuenta, mismo saldo, mismos emisores. Instala una, conecta el otro y tienes las dos mitades.
Lo que el agente necesita para no adivinar
Código abierto en github.com/CFDI-Express/skills. Léela antes de instalarla, si quieres.
Las convenciones, ya resueltas
URL base, llaves sk_test_/sk_live_, Idempotency-Key, paginación por cursor y errores problem+json con su código estable. El agente no las infiere de un blog.
Lee el esquema, no lo inventa
La skill lo manda al OpenAPI y a la referencia en markdown antes de escribir código. Menos campos alucinados, menos rechazos del SAT.
Todo el ciclo CFDI
Emisores y CSD, facturas PUE/PPD/globales, notas de crédito, complementos de pago REP, cancelaciones con acuse, catálogos del SAT y saldo. 31 endpoints.
Cero dobles timbres
La skill enseña a mandar el id de tu orden como Idempotency-Key: un reintento devuelve la respuesta original y dos requests concurrentes no timbran dos veces.
Agentes soportados:
Tres cosas que necesitas saber antes del primer timbre
MXN por timbre
Saldo prepagado, sin mensualidad ni mínimos. Descuentos por volumen automáticos y reembolso si el SAT rechaza.
Sandbox gratis e ilimitado
Tu llave de pruebas timbra contra el sandbox del SAT sin costo. Cambias a sk_live_ cuando el flujo esté listo.
Se sube en el dashboard
Los certificados se validan (vigencia, llave↔cert, RFC) y se guardan encriptados desde dash.cfdi.express. El agente nunca los toca.
Antes de correr el comando
¿Qué hace exactamente la skill?
Es un paquete de instrucciones para tu agente de código. Le da la URL base, la autenticación con llaves sk_test_/sk_live_, la idempotencia, los códigos de error, el mapa de los 31 endpoints y las ligas al OpenAPI y a la referencia en markdown. Con eso, cuando le pides que integre la facturación, escribe el código correcto en tu proyecto en lugar de adivinar campos del SAT.
¿En qué agentes funciona?
En Claude Code, Cursor, Codex, OpenCode y cualquier agente soportado por skills, el gestor de skills de Vercel Labs. Se instala con npx skills add CFDI-Express/skills, o solo para un agente con --skill cfdi-express-api -a claude-code.
¿Skill o MCP? ¿Cuál necesito?
La skill es para que el agente escriba la integración REST en tu código; el servidor MCP es para que el agente facture en vivo por chat. Son complementarios y usan la misma cuenta: instala la skill para el código y conecta el MCP si quieres pedir facturas conversando.
¿Cuánto cuesta y hay sandbox?
$1 MXN por timbre con descuentos por volumen, saldo prepagado que recargas desde $100 MXN con tarjeta. Sin mensualidad. El sandbox es gratis e ilimitado con tu llave sk_test_, así que puedes dejar la integración lista sin gastar un peso.
Instala la skill. Timbra hoy.
Cuenta gratis, llaves sk_test_ al instante y la integración la escribe tu agente.