MéxicoAPI
Datos oficiales de México: FIX, UDIS, días hábiles, UMA, ISR, municipios, CLABE, RFC, CURP y NSS.
MéxicoAPI
Datos de referencia de México, abiertos y al día, con su fuente oficial.
Cualquier sistema que se hace en México termina necesitando lo mismo:
- estados y municipios;
- bancos y validación de CLABE;
- tipo de cambio y UDIS;
- días inhábiles del SAT o de los bancos;
- UMA, salario mínimo y tablas de ISR.
Hoy cada quien descarga esos datos por su cuenta, los limpia a mano y deja de actualizarlos. MéxicoAPI los publica una sola vez, bien hechos, con su fuente. Un bot revisa las fuentes de los datos automáticos, a diario o cada semana, y los actualiza cuando cambian; los que se transcriben del DOF los captura una persona con cada publicación.
La API v1 ya está en línea en https://mexicoapi.dagel4k.workers.dev, con las descargas y el sitio. Los paquetes
mexicoapiymexicoapi-mcpestán en npm desde el 2026-10-18 (0.1.0).
Qué incluye
- API pública de solo lectura, rápida (archivos estáticos en el borde) y gratuita.
- Paquete de npm (
mexicoapi) con cliente, validadores y datos para usar sin conexión:npm install mexicoapi. - Servidor MCP (
mexicoapi-mcp) para que los asistentes de IA consulten el dato oficial en vez de inventarlo:npx -y mexicoapi-mcp. - Descargas completas en JSON, CSV y SQLite.
Cada respuesta indica de dónde salió el dato, su licencia y la fecha de su última actualización.
Datos de la primera versión
| Dato | Fuente |
|---|---|
| Estados y municipios | INEGI |
| Bancos (participantes SPEI) y validación de CLABE | Banxico |
| Tipo de cambio FIX y UDIS | Diario Oficial de la Federación |
| Días inhábiles (LFT, bancos y SAT) | DOF, LFT, CFF |
| UMA, salario mínimo y tarifas de ISR | INEGI, CONASAMI, SAT |
Los códigos postales de SEPOMEX no se pueden redistribuir. El paquete trae un comando (mexicoapi sepomex sync) que los descarga directamente de Correos de México en tu máquina y los deja listos para usar.
Datos disponibles hoy
| Dataset | Carpeta | Fuente | Se actualiza | Documentación |
|---|---|---|---|---|
| Estados | data/inegi-estados/ | INEGI | semanal | estados |
| Municipios | data/inegi-municipios/ | INEGI | semanal | municipios |
| Bancos, con historial | data/bancos/ | Banxico | diario | bancos |
| Tipo de cambio FIX | data/tipo-cambio-fix/ | DOF (Banxico) | diario | FIX |
| UDIS | data/udis/ | DOF (Banxico) | diario | UDIS |
| Días inhábiles de la CNBV | data/dias-inhabiles-cnbv/ | CNBV, DOF | a mano, con cada publicación | días CNBV |
| Días inhábiles del SAT | data/dias-inhabiles-sat/ | CFF y RMF, DOF | las vacaciones, a mano con cada publicación de la RMF; los del art. 12 del CFF, por regla | días SAT |
| UMA | data/constantes-uma/ | INEGI, DOF | a mano, cada año | UMA |
| Salario mínimo | data/constantes-salario-minimo/ | CONASAMI, DOF | a mano, cada año | salario mínimo |
| Tarifas de ISR | data/isr-tarifas/ | Anexo 8 de la RMF, DOF | a mano, cada año | tarifas de ISR |
Además, la API valida CLABE, calcula días hábiles con los calendarios de la Ley Federal del Trabajo, la CNBV y el SAT, y responde la UMA vigente en una fecha.
Cada carpeta incluye manifest.json con la fuente, la licencia y el hash, y los archivos fuente en raw/ (los descargados tal cual y, en bancos, la compilación mensual del CEP). Los datos curados (días inhábiles, UMA, salario mínimo e ISR) no tienen raw/: se transcriben del DOF a data/curado/, un YAML por dataset con la cita literal de cada valor, y el comando curar genera su carpeta. Los días que fija una ley no se transcriben: los del art. 12 del CFF en el calendario del SAT (y los del art. 74 de la LFT) los calcula una regla del núcleo, y del SAT solo se capturan las vacaciones. Los términos de uso de cada fuente están en DATA_LICENSE.md.
API
API de solo lectura, con respuestas JSON { data, meta }, descargas completas y especificación OpenAPI, en https://mexicoapi.dagel4k.workers.dev (workers.dev de Cloudflare; todavía sin dominio propio). No pide llave ni cuenta. La referencia está en docs/api/README.md y los errores en docs/api/problemas.md; el despliegue, en docs/operacion/cloudflare.md.
curl https://mexicoapi.dagel4k.workers.dev/v1/estados/25
curl https://mexicoapi.dagel4k.workers.dev/v1/clabe/002010077777777771
El mismo despliegue sirve el sitio, que genera el build con los datos: en / la página de inicio con los datasets, su fuente y las descargas; en /estado/, si cada dataset automático está al día; y en /llms.txt, un resumen de la API para herramientas que leen ese formato, con la documentación completa en /llms-full.txt (detalles).
Documentación
- API v1 y errores
- Paquete
mexicoapi: validadores, datos sin red, cliente, SEPOMEX y CLI - Servidor MCP
mexicoapi-mcp: herramientas, configuración del cliente yMEXICOAPI_BASE - Diseño técnico v1
- Bot de datos
- Datos curados: cómo se transcriben del DOF los calendarios y las constantes
- Publicación en npm: cómo se arman y se publican los paquetes
- Cómo contribuir y política de seguridad
Licencia
El código se publica bajo la licencia MIT. Los datos conservan la licencia de su fuente oficial, indicada en cada dataset.
Installation
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
npx -y mexicoapi-mcpSet up in your AI client
Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"io-github-dagel4k-mexicoapi-mcp": {
"command": "npx",
"args": [
"-y",
"mexicoapi-mcp"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup referencePackage
mexicoapi-mcpnpmCompatible MCP Clients
MéxicoAPI works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
- Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect. - Cursor
~/.cursor/mcp.jsonRestart Cursor for changes to take effect. - VS Code
.vscode/mcp.jsonReload VS Code window for changes to take effect. - Windsurf
~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect. - Claude Code
.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.