Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

Mexican Tax & Banking

de OrtaMarcoversión 1.1.2i★ 1iSe ejecuta en tu computadoraRepositorio ↗
Nombre en el registroio.github.OrtaMarco/mx-fiscal-mcp-server

Cómo instalar

What it does

Validate RFC, CURP, CLABE and NSS, read CFDI 4.0 invoices and check their SAT status. No keys.

  • Connects Se ejecuta en tu computadora
  • Account or key No key needed
  • Category Contabilidad, finanzas e impuestos

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad7/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo0/8El endpoint en la nube respondió en la última revisión
Puntuación de uso19/100

Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala Mexican Tax & Banking. Sigue https://mcp.popnx.com/i/ortamarco-mx-fiscal-mcp-server.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 13 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Que la IA lo instale

Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Mexican Tax & Banking para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "mx-fiscal": { "command": "npx", "args": [ "-y", "mx-fiscal-mcp-server" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Mexican Tax & Banking aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Abre el archivo de configuración de la app de Claude de escritorio

    SettingsDeveloperEdit Config

  3. Pega esta configuración y guarda el archivo

    {
      "mcpServers": {
        "mx-fiscal": {
          "command": "npx",
          "args": [
            "-y",
            "mx-fiscal-mcp-server"
          ]
        }
      }
    }
  4. Cierra Claude y vuelve a abrirlo

  5. Pruébalo

    Usa Mexican Tax & Banking y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Mexican Tax & Banking o muestra una herramienta de Mexican Tax & Banking en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar Mexican Tax & Banking

Mexican Tax & Banking se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar Mexican Tax & Banking

  • Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
  • Instala Node.js en tu computadora primero (una sola vez)
  • Instala Node.js en tu computadora primero (una sola vez)
  • Instala Node.js en tu computadora primero (una sola vez)

B · Otros en Contabilidad, finanzas e impuestos que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Mexican Tax & Banking para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user mx-fiscal -- npx -y mx-fiscal-mcp-server 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Mexican Tax & Banking aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  3. Pega este comando y pulsa Enter

    claude mcp add --scope user mx-fiscal -- npx -y mx-fiscal-mcp-server
  4. Escribe /mcp en Claude Code

    Deberías ver Mexican Tax & Banking en la lista como conectado

  5. Pruébalo

    Usa Mexican Tax & Banking y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Mexican Tax & Banking o muestra una herramienta de Mexican Tax & Banking en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Mexican Tax & Banking para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "mx-fiscal": { "command": "npx", "args": [ "-y", "mx-fiscal-mcp-server" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Mexican Tax & Banking aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  3. Abre el chat de IA de Cursor en modo Agent

  4. Pruébalo

    Usa Mexican Tax & Banking y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Mexican Tax & Banking o muestra una herramienta de Mexican Tax & Banking en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Mexican Tax & Banking para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "mx-fiscal": { "type": "stdio", "command": "npx", "args": [ "-y", "mx-fiscal-mcp-server" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Mexican Tax & Banking aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  3. Abre el chat de IA de VS Code en modo Agent

  4. Pruébalo

    Usa Mexican Tax & Banking y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Mexican Tax & Banking o muestra una herramienta de Mexican Tax & Banking en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Mexican Tax & Banking💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user mx-fiscal -- npx -y mx-fiscal-mcp-server

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "mx-fiscal": {
      "command": "npx",
      "args": [
        "-y",
        "mx-fiscal-mcp-server"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "mx-fiscal": {
      "command": "npx",
      "args": [
        "-y",
        "mx-fiscal-mcp-server"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "mx-fiscal": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mx-fiscal-mcp-server"
      ]
    }
  }
}

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
321/sem
Conexión
Se ejecuta en tu computadora
Última versióni
1.1.2
Publicado en el registroi
10 nov 2026
Último cambio de códigoi
10 nov 2026
Creador
OrtaMarco
Paquetes
npm: mx-fiscal-mcp-server
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub OrtaMarco, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 9 días

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Vulnerabilidades publicadas (OSV.dev)

Sin entradas en OSV.dev para mx-fiscal-mcp-server@1.1.2

Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/ortamarco-mx-fiscal-mcp-server.svg)](https://mcp.popnx.com/en/servers/ortamarco-mx-fiscal-mcp-server)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Contabilidad, finanzas e impuestosi

  • Más estrellas que el 87% de los otros 3417 servidores de esta categoría
  • Publicado en el registro más recientemente que el 77% de los otros 3417 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 3417 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Mexican Tax & Banking?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 9 días, y la última versión (1.1.2) llegó al registro hace 9 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: SolidInvoice, Signal8, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

de SolidInvoiceEn crecimiento★ 989Actualizado hace 10 días

Se ejecuta en la nube✓ del servicio · solidinvoice.co

Signal8

SEC filings, dilution, insider & institutional ownership, and political-trade data for AI agents.

de signal8aiEn crecimiento↓ 431/sem★ 425Actualizado hace 10 días

Computadora o nube✓ del servicio · signal8.ai

Journalit

Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.

de CursivezEn crecimiento★ 261Actualizado hace 11 días

Se ejecuta en la nube✓ del servicio · journalit.co

Beancount.io

Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.

de bex-coEn crecimiento★ 702 Estrellas de todo el repositorioActualizado hace 44 días

Se ejecuta en la nube✓ del servicio · beancount.io
Comparado con otros parecidos
Este
Mexican Tax & Banking
SolidInvoiceSignal8JournalitBeancount.ioTapetide - Indian Stock Market MCP
Dónde se ejecutaSe instala en tu equipoFunciona en la nube, sin instalar nadaEn la nube o instalado en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaEn la nube o instalado en tu equipo
Necesita claveNoNoSíNoNoSí
Se añade con + en ClaudeNoNoNoNoNoNo
Revisiones básicas3/34/65/54/44/45/5
LicenciaMITMITMITNOASSERTIONMITMIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

mx-fiscal-mcp-server

An MCP server that gives an AI agent Mexican tax and banking capabilities — validate RFC, CURP, CLABE and NSS with real check digits, read a CFDI 4.0 invoice, ask the SAT whether it is still live, and look up the SAT's code tables. No API keys, no CSD certificate, no PAC contract.

Ask Claude *"read this invoice and tell me whether it's still valid"* and it parses the XML, labels every SAT code, checks both RFCs and the arithmetic, and queries the SAT's public status service — instead of you opening three web tools.

> Read this CFDI and check it at the SAT

parse_cfdi(xml=" ")

CFDI A-1042 — 1160.00 MXN ✅ Stamped · version 4.0 · Ingreso Emisor: TES150312DX2 ✅ 601 — General de Ley Personas Morales Receptor: PELJ900521DK2 ✅ G03 — Gastos en general ✅ Totals add up: subtotal − discount + transferred − withheld = total

cfdi_status(xml=" ")

CFDI status — Vigente ✅ The invoice exists in the SAT's records and has not been cancelled. Es cancelable: Cancelable con aceptación EFOS: returned 200 — the issuer is NOT on the SAT's definitive 69-B list.


Why this exists

Mexican electronic invoicing has two halves, and only one of them was served.

Building and stamping a CFDI needs a CSD certificate and a contract with a PAC. That half already has tooling — mcp-cfdi-mx (Python) does it, and this server deliberately does not compete with it.

Reading is the other half, and it needs nothing: the check-digit algorithms are public, the SAT's catalogues are public, and the invoice status service behind the QR code on every printed invoice is public and unauthenticated. Yet an agent asked to validate an RFC will happily invent a regex that rejects XAXX010101000 — the RFC of every invoice issued to the general public — because that one does not satisfy its own check digit. This server is the read half, done carefully.

The arithmetic comes from mx-identifiers (MIT, zero dependencies, 101 tests against public vectors); the CFDI reader is ported from the tool running at ortamarco.me; the SOAP envelope was read out of nodecfdi/sat-estado-cfdi rather than guessed. It is the third of three read-only, key-free MCP servers alongside domain-security-mcp-server and seo-geo-mcp-server.

Tools

Identifiers
ToolWhat it does
validate_rfcRFC for individuals (13 chars) and companies (12), full modulus-11 check digit, parsed fields, birth/incorporation date. Flags the SAT generics and says which of them satisfies the arithmetic
validate_curp18-character CURP with the base-37 check digit; decodes birth date, sex, state (RENAPO keys, *not* INEGI/ISO) and the century marker
validate_clabe18-digit CLABE with the correct 3-7-1 control digit — each weighted product counts only its last digit (9 × 7 = 63 counts 3), not the Luhn-style sum of its digits (6 + 3 = 9) many implementations copy — plus the Banxico bank and the plaza code
validate_nss11-digit IMSS number with its Luhn digit, split into subdelegación / registration year / birth year / serial
generate_test_data ⭐1-100 coherent fake people or companies: the RFC and CURP derive from the same name and birth date, the CLABE's bank is a real participant, every check digit holds
CFDI
ToolWhat it does
parse_cfdi ⭐CFDI XML → JSON: header, issuer, receiver, every line item with transferred and withheld taxes, tax totals, and the Timbre Fiscal Digital (or null). Labels every catalogue code, validates both RFCs, checks the totals arithmetic. Walks the document by local name, so any PAC's namespace prefixes work. Reads 4.0 (Pagos 2.0 and Nómina documents included, but only the timbre and local taxes are extracted from complements; the rest are named in findings) and 3.3 with a version warning; a *Retenciones e información de pagos* document is refused with that explanation
cfdi_status ⭐Queries the SAT's public ConsultaCFDIService SOAP endpoint: Estado, EsCancelable, EstatusCancelación and ValidaciónEFOS, each with its meaning in plain words. Takes the four key fields or the whole XML. Fail-soft: 10 s timeout, one retry after a timeout, network error or 5xx (never after a 4xx), available: false on failure — never an exception
cfdi_batch_statusUp to 25 invoices through the same service, built to be gentle on it: two requests in flight at most, duplicates asked once, answers cached in memory for 10 minutes (an outage never is), and no new request once two in a row have failed. Bad items are reported one by one and cost no request
Catalogues
ToolWhat it does
sat_catalog_lookupNine bundled code tables — regimen_fiscal, uso_cfdi, forma_pago, metodo_pago, tipo_comprobante, objeto_imp, impuestos, bancos_clabe, estados_curp — by exact code (leading zeros ignored) or accent-insensitive text search. Never touches the network

Every tool is read-only, declares an outputSchema and returns structuredContent (validated by the SDK) alongside human-readable Markdown (default) or JSON (response_format="json"). Only cfdi_status and cfdi_batch_status are annotated openWorldHint: true: they are the two that reach the network.

Resources and prompts
KindNameWhat it is
Resourcemx-fiscal://catalogsIndex of the nine bundled code tables
Resourcemx-fiscal://catalog/ One table (regimen_fiscal, uso_cfdi, …) as JSON, same shape as sat_catalog_lookup
Promptreview_cfdiParse an invoice, check it at the SAT, report both honestly
Promptvalidate_identifiersClassify and validate a mixed list of RFC / CURP / CLABE / NSS
Promptseed_test_dataGenerate valid fake people or companies for a seed file

Honesty notes

These are surfaced in the tool output, not buried here:

  • Structurally valid is not registered. A check digit that adds up says the string is well-formed and nothing more. Only the SAT can say an RFC is registered; only RENAPO that a CURP belongs to a person. This server never asks either, and its wording never implies it did.
  • `XAXX010101000` does not satisfy its own check digit. The SAT assigned the general-public RFC by decree and the modulus-11 algorithm asks for a 4 where the SAT wrote a 0. XEXX010101000 (foreign residents) *does* satisfy it. The tools report is_generic and check_digit_satisfied as separate fields rather than collapsing both into "valid".
  • Reading a CFDI is not verifying it. parse_cfdi does not check the digital signature. A perfectly parseable invoice can be cancelled, or fabricated wholesale.
  • An unreachable SAT is not an invalid invoice. The status endpoint publishes no SLA and no status page, and it goes down. Its documentation states capacity for up to 2 million queries per hour and asks callers not to raise their query volume, since every query reads the SAT's transactional databases. cfdi_status degrades to available: false with the reason — a statement about the SAT, never about the document.
  • The bank list is a subset. bancos_clabe carries the main Banxico participants, not the full catalogue; an unknown code is reported as unknown rather than given an invented name. The plaza catalogue is not bundled at all, so the plaza code is returned verbatim.
  • EFOS codes are read from the SAT's own table. The SAT documents ValidacionEFOS in its *Documentación del Servicio de Consulta de CFDI* v1.4, section 3: 100, 101 and 104 put the issuer on the definitive 69-B list; 102 and 103 mean the issuer is not on it but a third-party RFC the invoice was issued on behalf of (*a cuenta de terceros*) is; 200 and 201 mean the issuer is not on it (201: nor any third party). efos_state speaks of the issuer only, and efos_third_party_state (listed / not_listed / not_reported / unknown) of the third parties. An empty field or an undocumented code is reported as unknown with the raw code kept in validacion_efos, never as "listed". Versions up to 1.0.1 reported 102 and 103 as an issuer on the list; 1.0.2 fixes it.
  • Bineo CLABEs (bank 165). 1.0.3 requires mx-identifiers ^1.0.1, which carries the fix for them.

Protocol

Built on the v2 MCP SDK, so it speaks the 2026-07-28 revision (server/discover, no initialize, per-request _meta envelope) and still serves 2025-era clients — Claude Desktop, Claude Code and Cursor — from the same server factory. The entry points own the era decision: serveStdio(factory) on stdio, createMcpHandler(factory) over HTTP with the default legacy: 'stateless'. There is no session state and no Mcp-Session-Id in either direction. npm run smoke exercises every tool on both eras and asserts the negotiated era of each connection.

Because the tool list is a compile-time constant, tools/list and server/discover advertise a real one-hour ttlMs with cacheScope: 'public' on 2026-era connections instead of the SDK's conservative ttlMs: 0.

Install

Requires Node.js 20+. Nothing to clone — every MCP client can run it with npx.

Use it with Claude Code

claude mcp add mx-fiscal -- npx -y mx-fiscal-mcp-server

Add --scope user (all your projects) or --scope project (writes a shared .mcp.json) before the --; the default is local to the current project.

Use it with Claude Desktop

Open *Settings → Developer → Edit Config* and add to claude_desktop_config.json — see examples/:

{

"mcpServers": { "mx-fiscal": { "command": "npx", "args": ["-y", "mx-fiscal-mcp-server"] } } }

On Windows use "command": "cmd" with "args": ["/c", "npx", "-y", "mx-fiscal-mcp-server"]. Restart the client, then ask: *"Generate 10 Mexican customers with valid RFC and CURP for my seed file."*

Use it with Cursor

The same JSON block goes in ~/.cursor/mcp.json (every project) or .cursor/mcp.json (this project only).

Use it with Codex

codex mcp add mx-fiscal -- npx -y mx-fiscal-mcp-server

or in ~/.codex/config.toml (a project-scoped .codex/config.toml also works):

[mcp_servers.mx-fiscal]

command = "npx" args = ["-y", "mx-fiscal-mcp-server"]

Self-host (HTTP transport)

The same server speaks stateless Streamable HTTP for remote or multi-client use.

TRANSPORT=http npx -y mx-fiscal-mcp-server

POST JSON-RPC to http://127.0.0.1:3000/mcp · health at /healthz

It is safe by default: it binds to 127.0.0.1 and only accepts localhost Host and Origin headers, which blocks DNS-rebinding attacks from a web page. To expose it — for example behind Coolify or Traefik — opt in explicitly:

VariableDefaultPurpose

Solo se muestra el principio; lee el resto en el repo