MéxicoAPI
Datos oficiales de México: FIX, UDIS, días hábiles, UMA, ISR, municipios, CLABE, RFC, CURP y NSS.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
mexicoapi-mcpclaude mcp add m-xicoapi -e 'MEXICOAPI_BASE=<MEXICOAPI_BASE>' -e 'MEXICOAPI_SIN_RED=<MEXICOAPI_SIN_RED>' -- npx -y mexicoapi-mcp@0.2.0{
"mcpServers": {
"m-xicoapi": {
"command": "npx",
"args": [
"-y",
"mexicoapi-mcp@0.2.0"
],
"env": {
"MEXICOAPI_BASE": "<MEXICOAPI_BASE>",
"MEXICOAPI_SIN_RED": "<MEXICOAPI_SIN_RED>"
}
}
}
}Variables d'environnement
MEXICOAPI_BASEDirección de la API que se consulta; sin ella, la pública. Con http://, solo localhost, 127.0.0.1 o [::1].MEXICOAPI_SIN_REDCon true responde todo con los datos del paquete mexicoapi, sin usar la red.
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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/002010077777777771El 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.
Questions fréquentes
Qu'est-ce que MéxicoAPI ?
Datos oficiales de México: FIX, UDIS, días hábiles, UMA, ISR, municipios, CLABE, RFC, CURP y NSS.
Comment installer MéxicoAPI ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add m-xicoapi -e 'MEXICOAPI_BASE=<MEXICOAPI_BASE>' -e 'MEXICOAPI_SIN_RED=<MEXICOAPI_SIN_RED>' -- npx -y mexicoapi-mcp@0.2.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour MéxicoAPI ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
MéxicoAPI est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient MéxicoAPI ?
Il est publié par Dagel4k. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.