{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_wdpzqjqmkx9g","handle":"facturama-mcp","url":"https://wellknown.network/agents/facturama-mcp","links":{"self":"https://wellknown.network/agents/facturama-mcp/record.json","html":"https://wellknown.network/agents/facturama-mcp","markdown":"https://wellknown.network/agents/facturama-mcp/record.md","api":"https://wellknown.network/api/v1/agents/facturama-mcp","status":"https://wellknown.network/api/v1/agents/facturama-mcp/status","claim":"https://wellknown.network/agents/facturama-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/facturama-mcp/claim.json","badge":"https://wellknown.network/agents/facturama-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/facturama-mcp/history","tools":"https://wellknown.network/api/v1/agents/facturama-mcp/tools"},"ard":{"identifier":"urn:air::server:facturama-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"facturama-mcp","summary":"Servidor MCP para Facturama — facturación electrónica CFDI 4.0 en México","description":"<!-- mcp-name: mx.facturama/facturacion -->\n\n# 🧾 Facturama MCP Server\n\n> Servidor MCP (Model Context Protocol) basado en **FastMCP 3.x** que expone la API de [Facturama](https://facturama.mx) como herramientas para agentes LLM (Claude Desktop, Claude Code, Cursor, y cualquier cliente MCP). Cubre toda la operación de facturación electrónica CFDI 4.0 en México.\n\n[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)\n[![FastMCP 3.x](https://img.shields.io/badge/FastMCP-3.x-purple.svg)](https://gofastmcp.com)\n[![CFDI 4.0](https://img.shields.io/badge/CFDI-4.0-green.svg)](https://www.sat.gob.mx)\n[![Status](https://img.shields.io/badge/status-beta-orange.svg)]()\n\n---\n\n## Tabla de contenidos\n\n- [¿Qué hace?](#qué-hace)\n- [Características](#características)\n- [Herramientas disponibles](#herramientas-disponibles-27-tools)\n- [Instalación](#instalación)\n- [Configuración](#configuración)\n- [Uso](#uso)\n  - [Claude Desktop](#claude-desktop)\n  - [Claude Code](#claude-code)\n  - [Cursor](#cursor)\n  - [VS Code](#vs-code)\n  - [n8n, Make y Zapier](#n8n-make-y-zapier)\n- [Ejemplos de uso](#ejemplos-de-uso)\n- [Particularidades de la API de Facturama](#particularidades-de-la-api-de-facturama)\n- [Estructura del proyecto](#estructura-del-proyecto)\n- [Desarrollo](#desarrollo)\n- [Despliegue](#despliegue)\n- [Troubleshooting](#troubleshooting)\n- [Roadmap](#roadmap)\n- [Stack técnico](#stack-técnico)\n- [Contribuir](#contribuir)\n\n---\n\n## ¿Qué hace?\n\nPermite que un agente de IA (o cualquier cliente MCP) pueda operar la facturación electrónica completa con lenguaje natural:\n\n- 🧾 **Crear, consultar, cancelar y descargar CFDIs** (Ingreso, Egreso, Pago)\n- 💸 **Generar Complementos de Pago** (REP 2.0) para facturas PPD\n- 👥 **CRUD de clientes y productos** del catálogo\n- 📚 **Buscar en catálogos del SAT** sin salir del agente\n- 📧 **Enviar facturas por email** al receptor\n- 💰 **Manejar descuentos, retenciones, multiconcepto**, monedas extranjeras\n\nEjem…","publisher":null,"homepage":"https://github.com/facturamamx/mcp-facturacion#readme","repository":"https://github.com/facturamamx/mcp-facturacion/blob/main/CHANGELOG.md","version":"1.0.0rc2","license":null,"protocols":["mcp"],"tags":["cfdi","facturacion","facturama","mcp","mexico","model-context-protocol","sat"],"pricing":null,"endpoints":[{"url":"pypi:facturama-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"automation.workflows","name":"Workflow Automation","confidence":1,"provenance":"derived"}],"categories":["automation"],"language":"es"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"facturama-mcp","registry":"pypi","observedAt":"2026-10-28T00:27:46.040Z","publishedAt":"2026-08-04T01:27:14.706915Z","latestVersion":"1.0.0rc2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"facturama-mcp","url":"https://pypi.org/project/facturama-mcp/","firstSeenAt":"2026-09-09T15:22:17.327Z","fetchedAt":"2026-10-28T00:26:43.919Z","normalizedAt":"2026-10-28T00:26:43.919Z"}]},"firstSeenAt":"2026-09-09T15:22:17.327Z","updatedAt":"2026-10-28T00:27:46.040Z"}