# Factumatico 2.0 — MCP para timbrado CFDI 4.0 desde tu Agente de IA

> Factumatico es un servicio mexicano de timbrado de CFDI 4.0 (facturación electrónica del SAT) accesible por agentes de IA vía Model Context Protocol (MCP). Un agente (Claude, ChatGPT, Cursor, Gemini CLI, n8n) puede generar, timbrar y consultar facturas conectándose a nuestro servidor MCP remoto.

## Qué ofrece
- Servidor MCP remoto con auth Bearer para timbrar CFDI 4.0 contra el SAT.
- Prueba gratis: 2 timbrados en sandbox (sin tarjeta, sin validez fiscal), RFC de pruebas del SAT.
- Plan Agente: $499 MXN IVA incluido por 30 dias. Renovacion manual.
- Alcance del plan: UN (1) RFC emisor y hasta 10,000 timbrados por periodo.
- El RFC emisor es el de la empresa que factura con su CSD. No es el RFC de cada cliente o receptor, que no tiene limite.
- La factura de la suscripcion la emite Grupo Factumatico y Soluciones S.A. de C.V.

## Endpoint MCP
- URL del servidor MCP: https://mcp.factumatico.com/mcp
- Transporte: HTTP (JSON-RPC 2.0), protocolo MCP 2025-06-18.
- Autenticación: header `Authorization: Bearer <API_KEY>`.
- Obtener API key de prueba: POST https://mcp.factumatico.com/api/mcp/trial/issue  body {"email":"tu@correo.com"} -> devuelve api_key sk_test_...

## Tools disponibles
Esto es TODO lo que expone el servidor MCP hoy. El catálogo interno de Factumático
tiene cientos de herramientas; ninguna de ellas está disponible por esta vía.

Con llave de prueba (sandbox, sin validez fiscal):
- factumatico_stamp_test_invoice — timbra un CFDI 4.0 de prueba.
- factumatico_trial_status — consulta timbres restantes y estado de la cuenta.
- factumatico_help — ayuda y guía de uso.

Con Plan Agente y CSD validado, se añaden:
- factumatico_stamp_invoice — timbra un CFDI 4.0 real ante el SAT.
- factumatico_cancel_invoice — cancela un CFDI real.

Consultar facturas, descargar XML/PDF y gestionar clientes o productos NO están
expuestos todavía por MCP.

## API REST (alternativa sin MCP)
- Timbrar prueba: POST https://mcp.factumatico.com/api/mcp/trial/invoice  header Authorization: Bearer <API_KEY>  body {"total":116.00}

## Cómo conectar
- Gemini CLI: agrega a settings.json un mcpServers con httpUrl=https://mcp.factumatico.com/mcp y header Authorization Bearer.
- Claude Desktop / Cursor: usa mcp-remote apuntando a https://mcp.factumatico.com/mcp.
- ChatGPT: Developer Mode -> custom connector con la URL del servidor (según doc oficial de OpenAI).

## Contacto
- Web: https://mcp.factumatico.com
- Email: kioscomatico@gmail.com
- Parte del ecosistema GOLIAT (https://goliat.lat)