Mexico Invoice

by junter1989k-ai

278 downloads
Not rated
GitHub Website

About

Remote MCP server: AI agents issue Mexico CFDI 4.0 electronic invoices (factura electronica) via Facturapi. Stateless, BYO credentials.

Details

Author
junter1989k-ai
Downloads
278

- MCP server integration

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Mexico Invoice
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

The README includes setup instructions such as node test/serve.js # local server on :3226.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mexico invoice": {
            "mexico-invoice": {
                "type": "http",
                "url": "https://inv-mx.wishpool.app/mcp",
                "headers": {
                    "x-facturapi-key": "sk_test_..."
                }
            }
        }
    }
}

McpServers

{
    "mexico-invoice": {
        "type": "http",
        "url": "https://inv-mx.wishpool.app/mcp",
        "headers": {
            "x-facturapi-key": "sk_test_..."
        }
    }
}

Mexico Invoice MCP 🇲🇽 — How can my AI agent issue a CFDI factura electrónica in Mexico?

Remote MCP server that lets any AI agent issue Mexico CFDI 4.0 electronic invoices (factura electrónica, stamped/timbrada through a SAT-certified PAC) via Facturapi. Stateless, bring-your-own credentials, never stores anything.

Live endpoint: https://inv-mx.wishpool.app/mcp · Registry: app.wishpool/mexico-invoice-mcp

Quick start

{
  "mcpServers": {
    "mexico-invoice": {
      "type": "http",
      "url": "https://inv-mx.wishpool.app/mcp",
      "headers": { "x-facturapi-key": "sk_test_..." }
    }
  }
}

Free sk_test_ keys from facturapi.io never reach SAT. Your CSD certificate stays in your own Facturapi account — this server never sees it.

Tools

| Tool | What it does |
|---|---|
| create_invoice | Stamp a CFDI 4.0 — customer RFC + zip + line items in, uuid (SAT folio fiscal) out. SAT catalog defaults baked in (product_key 01010101, payment_form 03, use G03). |
| query_invoice | Status check: VALID (stamped) or CANCELED; includes SAT verification_url. |
| cancel_invoice | Void at SAT with the required motive code (0104, default 02). |
| send_invoice | Email the stamped PDF + XML to the buyer via Facturapi. |

Owner policy guardrails ride optional headers (x-agentpay-max-amount, x-agentpay-approval-above, x-agentpay-allowed-tools) — set by the human owner in client config; the agent cannot relax them.

Develop

node test/serve.js   # local server on :3226
node test/e2e.js     # protocol + validation + fake-key live probes

Safety

Pure stateless translation layer. The SAT/PAC certification burden sits with Facturapi; credentials travel per-request in headers, nothing is stored. Privacy policy.

Sister servers

Local payments in 81 countries, one family: mcp.wishpool.app · Taiwan e-invoice 電子發票 included. More invoice countries coming: Brazil NF-e · Chile DTE · Peru CPE · India GST · Poland KSeF · Romania e-Factura · Italy SdI.

MIT licensed.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.