mexicoapi-mcp
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.
Related MCP server: corpus-iuris
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 |
| INEGI | semanal | |
Municipios |
| INEGI | semanal | |
Bancos, con historial |
| Banxico | diario | |
Tipo de cambio FIX |
| DOF (Banxico) | diario | |
UDIS |
| DOF (Banxico) | diario | |
Días inhábiles de la CNBV |
| CNBV, DOF | a mano, con cada publicación | |
Días inhábiles del SAT |
| CFF y RMF, DOF | las vacaciones, a mano con cada publicación de la RMF; los del art. 12 del CFF, por regla | |
UMA |
| INEGI, DOF | a mano, cada año | |
Salario mínimo |
| CONASAMI, DOF | a mano, cada año | |
Tarifas de ISR |
| Anexo 8 de la RMF, DOF | a mano, cada año |
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
Paquete
mexicoapi: validadores, datos sin red, cliente, SEPOMEX y CLIServidor MCP
mexicoapi-mcp: herramientas, configuración del cliente yMEXICOAPI_BASEDatos 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
Licencia
El código se publica bajo la licencia MIT. Los datos conservan la licencia de su fuente oficial, indicada en cada dataset.
Available Tools
15 toolsbanco_por_codigoBanco por códigoARead-onlyIdempotent
Devuelve un banco o participante del SPEI por el código de 3 dígitos con el que empieza la CLABE: nombre corto, razón social, clave SPEI, si sigue activo y su historial de nombres. Sale del catálogo que trae el paquete, sin red.
Inputs: codigo (required). Returns: as_of, datos, avisos, fuente, +3 more
buscar_municipioBuscar municipioARead-onlyIdempotent
Busca municipios y alcaldías por nombre en el catálogo de INEGI que trae el paquete, sin red. No distingue mayúsculas, acentos ni signos: primero los de nombre igual al texto, luego los que empiezan con él y al final los que lo contienen. Devuelve de cada uno su clave geoestadística (cvegeo), la clave de su estado y el nombre del estado, y el total de coincidencias.
Inputs: texto (required), limite, cve_ent. Returns: as_of, datos, total, avisos, +4 more
codigo_postalCódigo postalARead-onlyIdempotent
Estado, municipio y asentamientos (colonias, fraccionamientos, pueblos) de un código postal, del catálogo de Correos de México que el usuario descargó en este equipo con npx mexicoapi sepomex sync. No usa la red. Si el catálogo no está descargado, responde con error y el comando para descargarlo. Los datos son de Correos de México, para uso particular, y cada resultado trae su aviso de uso.
Inputs: cp (required). Returns: as_of, aviso, datos, avisos, +5 more
constantesUMA, salario mínimo e ISRARead-onlyIdempotent
UMA, salario mínimo y tarifas de ISR publicados en el DOF, cada uno con la publicación que lo respalda. tipo uma con anio (la UMA de ese año) o con fecha (la vigente ese día: cada UMA rige del 1 de febrero al 31 de enero siguiente); tipo salario_minimo con anio (zona general y Zona Libre de la Frontera Norte); tipo isr con periodo (mensual o anual) y anio. Los montos son texto con dos decimales. Consulta la API de MéxicoAPI (la pública, o la de MEXICOAPI_BASE) y, si no responde, usa los datos del paquete y lo advierte. Con MEXICOAPI_SIN_RED=1 responde con los datos del paquete, sin red.
Inputs: tipo (required), anio, fecha, periodo. Returns: tipo, as_of, datos, avisos, +4 more
dias_inhabilesDías inhábilesARead-onlyIdempotent
Días inhábiles de un año según una autoridad: lft, cnbv o sat. No lista los sábados y domingos por serlo, pero sí un día publicado que cae en fin de semana. Cada día trae su motivo, su tipo (descanso, o vacaciones del SAT, que en los plazos de declaraciones y pagos cuentan como hábiles) y su fuente. Si la lista de un año puede estar incompleta, lo advierte; con lft advierte siempre que no incluye los festivos ni las suspensiones de labores del artículo 715. Consulta la API de MéxicoAPI (la pública, o la de MEXICOAPI_BASE) y, si no responde, usa los datos del paquete y lo advierte. Con MEXICOAPI_SIN_RED=1 responde con los datos del paquete, sin red.
Inputs: anio (required), autoridad (required). Returns: as_of, datos, avisos, fuente, +3 more
estadosEstadosARead-onlyIdempotent
Las 32 entidades federativas del catálogo de INEGI que trae el paquete, sin red: clave de 2 dígitos (cve_ent), nombre, abreviatura y cvegeo. Úsala para saber la clave de un estado, que piden municipios_de_estado y buscar_municipio.
Inputs: no named parameters. Returns: as_of, datos, avisos, fuente, +3 more
municipioMunicipio por claveARead-onlyIdempotent
Devuelve un municipio o alcaldía por su clave geoestadística de INEGI (cvegeo: los 2 dígitos del estado y los 3 del municipio), con el nombre de su estado. Sale del catálogo que trae el paquete, sin red.
Inputs: cvegeo (required). Returns: as_of, datos, avisos, fuente, +3 more
municipios_de_estadoMunicipios de un estadoARead-onlyIdempotent
Todos los municipios y alcaldías de un estado, con el total, del catálogo de INEGI que trae el paquete, sin red: de cada uno, su clave geoestadística (cvegeo) y su nombre; municipio da el registro completo. Úsala para preguntas como qué municipios tiene un estado o cuántos son: buscar_municipio solo da los que coinciden con un texto. Indica el estado con cve_ent (su clave de 2 dígitos) o con estado (su nombre o abreviatura, sin distinguir mayúsculas ni acentos), no con los dos. Si el nombre no es de un solo estado, responde con error; estados da los nombres y las claves.
Inputs: estado, cve_ent. Returns: as_of, datos, total, avisos, +5 more
sumar_dias_habilesSumar días hábilesARead-onlyIdempotent
Calcula la fecha que resulta de sumar días hábiles a la fecha desde según el calendario de una autoridad (lft, cnbv o sat), contando desde el día hábil siguiente. En un plazo que corre desde una notificación, desde es el día en que surte efectos, no el día en que se hizo. Con sat, tipo_plazo es obligatorio: en declaraciones_pagos las vacaciones del SAT cuentan como hábiles (CFF, artículo 12) y en general no; con lft o cnbv no se acepta. Devuelve la fecha resultante y los días inhábiles saltados con su fuente. Las advertencias dicen lo que el cálculo no descuenta: con lft, los festivos y las suspensiones de labores del artículo 715; con declaraciones_pagos, la prórroga del quinto párrafo del artículo 12 si el resultado cae en viernes, en vacaciones del SAT o en un cierre bancario, o fuera de las vacaciones publicadas. Si el calendario no cubre el periodo responde con error; con permitir_incompleto: true calcula de todos modos y lo advierte. Es una calculadora, no asesoría legal. Consulta la API de MéxicoAPI (la pública, o la de MEXICOAPI_BASE) y, si no responde, usa los datos del paquete y lo advierte. Con MEXICOAPI_SIN_RED=1 responde con los datos del paquete, sin red.
Inputs: dias (required), desde (required), autoridad (required), tipo_plazo, +1 more. Returns: as_of, datos, avisos, fuente, +3 more
tipo_de_cambio_fixTipo de cambio FIXARead-onlyIdempotent
Tipo de cambio FIX (pesos por dólar) publicado en el DOF. Con publicado, el valor que se publicó ese día; con operacion, el que aplica a una operación de ese día según el CFF, artículo 20 (el publicado el día anterior o, si ese día no hubo publicación, el último antes); sin ninguno de los dos, la publicación más reciente. Indica solo uno. Las fechas son días de la zona America/Mexico_City: para un pago de hoy, usa la fecha de hoy en esa zona; de las 18:00 a las 24:00 de esa zona, en UTC ya es el día siguiente. Consulta la API de MéxicoAPI (la pública, o la de MEXICOAPI_BASE) y, si no responde, usa los datos del paquete y lo advierte. Con MEXICOAPI_SIN_RED=1 responde con los datos del paquete, sin red. Sin red advierte en la publicación más reciente y en fechas a 7 días o menos del último dato del paquete.
Inputs: operacion, publicado. Returns: as_of, datos, avisos, fuente, +3 more
udisValor de la UDIARead-onlyIdempotent
Valor de la UDI (pesos por unidad de inversión) de un día, como se publica en el DOF. Hay un valor para cada día del calendario, fines de semana incluidos. Consulta la API de MéxicoAPI (la pública, o la de MEXICOAPI_BASE) y, si no responde, usa los datos del paquete y lo advierte. Con MEXICOAPI_SIN_RED=1 responde con los datos del paquete, sin red. Sin red advierte en fechas a 7 días o menos del último valor del paquete.
Inputs: fecha (required). Returns: as_of, datos, avisos, fuente, +3 more
validar_clabeValidar CLABEARead-onlyIdempotent
Valida una CLABE interbancaria de 18 dígitos: dígito de control y código de banco contra el catálogo de bancos que trae el paquete. Acepta espacios y guiones entre los dígitos. No usa la red ni confirma que la cuenta exista. Devuelve el banco (activo: false si ya no aparece en el SPEI), la plaza y la cuenta.
Inputs: clabe (required). Returns: as_of, datos, avisos, fuente, +3 more
validar_curpValidar CURPARead-onlyIdempotent
Valida el formato de una CURP: estructura, fecha de nacimiento, sexo, entidad y dígito verificador. Corre en el equipo, sin red; no consulta a RENAPO ni confirma que la CURP exista.
Inputs: curp (required). Returns: as_of, datos, avisos, fuente, +3 more
validar_nssValidar NSSARead-onlyIdempotent
Valida un número de seguridad social del IMSS: 11 dígitos y dígito verificador (Luhn). Corre en el equipo, sin red; no consulta al IMSS ni confirma que el número exista.
Inputs: nss (required). Returns: as_of, datos, avisos, fuente, +3 more
validar_rfcValidar RFCARead-onlyIdempotent
Valida el formato de un RFC de persona física (13 caracteres) o moral (12): estructura, fecha y dígito verificador de la homoclave. El dígito verificador es informativo: si no coincide se reporta, pero el RFC no se marca inválido. Corre en el equipo, sin red; no consulta al SAT ni confirma que el RFC exista.
Inputs: rfc (required). Returns: as_of, datos, avisos, fuente, +3 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 15 tools
The four municipal tools (buscar_municipio, municipio, municipios_de_estado, estados) share a resource but descriptions explicitly carve out search-by-name vs. lookup-by-cvegeo vs. list-by-state vs. state catalog, so an agent can pick correctly. All other tools target clearly different artifacts: validators by identifier type (CLABE, RFC, CURP, NSS), financial values (tipo_de_cambio_fix, udis, constantes), calendars (dias_inhabiles, sumar_dias_habiles) and codigo_postal. Minor residual risk of confusing buscar_municipio with municipios_de_estado for 'what municipalities exist' questions.
Everything is snake_case and readable, but conventions are mixed: verb_noun operations (buscar_municipio, validar_clabe, sumar_dias_habiles) sit alongside bare resource nouns (estados, municipio, udis, constantes) and compound descriptors (tipo_de_cambio_fix, banco_por_codigo, dias_inhabiles). The singular/plural pair municipio vs. municipios_de_estado and municipio vs. buscar_municipio are especially easy to conflate by name alone.
15 tools is at the top of the comfortable range but each covers a distinct slice of Mexican reference data (geography, identity validators, financial indicators, business-day calendars, postal codes). No tool looks redundant or like filler, and the surface is cohesive around a single domain.
Coverage is broad: geography lookup, four validators, exchange rate, UDI, ISR/UMA/salary constants, holiday calendars with add-business-days, bank codes and postal codes. Gaps are minor: no reverse lookup from municipality to postal codes or settlements, no bank search by name, and no generic holiday search across multiple years. Agents can work around these with the existing tools.
Maintenance
Related MCP Connectors
Official Mexican data for AI agents: CURP, RFC, CFDI, postal codes, phone, SPEI/CEP, DOF, geocoding.
CFDI 4.0 invoicing for Mexico: invoices, payments, receipts and SAT catalogs, stamped with SAT
Mexico's official economic data from Banxico: USD/MXN, inflation, UDIS, TIIE and reserves.
Brazil CNPJ, CEP, Selic/IPCA/PTAX, holidays, banks/ISPB for agents. Pay per call in USDC (x402).
Related MCP Servers
AlicenseNot gradedqualityCmaintenanceProvides AI assistants with live, authenticated access to official Mexican data sources including CURP, RFC, postal codes, phone numbers, SPEI payments, CFDI status, DOF semantic search, and geocoding via INEGI/INE.MIT- FlicenseNot gradedqualityDmaintenanceEnables AI agents to search Mexican federal and state statutes, Supreme Court theses, and precedents, returning verifiable citations with dated validity, public URLs, and explicit indication of whether case law is binding jurisprudence or merely persuasive.-
- AlicenseAqualityBmaintenanceEnables AI agents to validate Mexican RFC, CURP, CLABE and NSS identifiers with real check digits, parse CFDI 4.0 invoices with labelled SAT catalogue codes and verified totals, and query the SAT's public status service to see whether an invoice is still valid. It also generates coherent test people and companies, all read-only and without API keys, certificates or PAC contracts.9280 npm1MIT
- AlicenseAqualityBmaintenanceEnables AI assistants and agents to query official Mexican economic data from Banxico, including USD/MXN exchange rates, inflation (INPC), UDIS, and interest rates.630 PyPI6MIT