io.github.codespar/mcp-facturapi

Official

by codespar · TypeScript

FacturAPI — Mexican CFDI e-invoicing

MCP FacturAPI (io.github.codespar/mcp-facturapi)

FacturAPI is a Model Context Protocol (MCP) server focused on Mexican CFDI e-invoicing. It provides an interface for working with FacturAPI’s Mexican documentation, described as the equivalent of Brazil’s NFe.

🛠️ Key Features

MCP server for FacturAPI Mexican CFDI e-invoicing
Supports two transports: stdio and HTTP (--http)
Configurable via FACTURAPI_API_KEY and optional HTTP settings

🚀 Use Cases

Integrate Mexican e-invoicing (CFDI) into developer tools via MCP
Use HTTP transport when running outside a stdio-based setup

⚡ Developer Benefits

Simple run commands for stdio and HTTP
Environment-based configuration for API key and server port
Aligns with MCP and lists topics relevant to fintech and LLM tools

⚠️ Limitations

HTTP transport requires enabling with MCP_HTTP="true" and setting MCP_PORT (default: 3)

Topics

agentic-commerceai-agentsbrazilclaudefintechlatin-americallm-toolsmcpmodel-context-protocolnfeopen-financepaymentspix

packages/mexico/facturapi/README.md2 KBView on GitHub

MCP FacturAPI

MCP server for FacturAPI — Mexican CFDI e-invoicing platform (equivalent to Brazil's NFe).

Quick Start

bash

# Set your API key
export FACTURAPI_API_KEY="sk_..."

# Run via stdio
npx tsx packages/mexico/facturapi/src/index.ts

# Run via HTTP
npx tsx packages/mexico/facturapi/src/index.ts --http

Environment Variables

Variable	Required	Description
`FACTURAPI_API_KEY`	Yes	API key from FacturAPI dashboard
`MCP_HTTP`	No	Set to `"true"` to enable HTTP transport
`MCP_PORT`	No	HTTP port (default: 3000)

Tools (20)

Tool	Purpose
`create_invoice`	Create a CFDI invoice
`get_invoice`	Get invoice by ID
`list_invoices`	List invoices with filters
`cancel_invoice`	Cancel an invoice
`download_invoice_pdf`	Download invoice as PDF (returns download URL)
`download_invoice_xml`	Download invoice as XML (returns download URL)
`send_invoice_email`	Send invoice (PDF + XML) by email to the customer or to specific recipients
`create_customer`	Create a customer for invoicing
`get_customer`	Get customer by ID
`list_customers`	List customers with optional filters
`update_customer`	Update an existing customer (partial update)
`delete_customer`	Delete a customer
`create_product`	Create a product for invoicing
`get_product`	Get product by ID
`list_products`	List products
`update_product`	Update an existing product (partial update)
`delete_product`	Delete a product
`create_receipt`	Create a receipt (recibo de venta) — the customer can later self-invoice it from the receipt's folio
`list_receipts`	List receipts with filters
`list_webhooks`	List configured webhooks

Auth

Uses Bearer token authentication. Obtain your API key from the FacturAPI Dashboard.

API Reference

FacturAPI Docs

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

Authentication

Set these environment variables before launching the server:

FACTURAPI_API_KEY (required, secret) — API key for FacturAPI

Issue credentials at the provider's developer portal: https://docs.facturapi.io.

License

MIT

Install

Configuration

Environment variables

FACTURAPI_API_KEYrequiredsecret

API key for FacturAPI

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-facturapi": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-facturapi@0.2.2"
      ],
      "env": {
        "FACTURAPI_API_KEY": "<YOUR_FACTURAPI_API_KEY>"
      }
    }
  }
}