Skip to main content
Glama

MéxicoAPI

OpenSSF Best Practices

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 mexicoapi y mexicoapi-mcp está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

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

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 tools
banco_por_codigoBanco por códigoA
Read-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 municipioA
Read-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 postalA
Read-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 ISRA
Read-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ábilesA
Read-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

estadosEstadosA
Read-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 claveA
Read-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 estadoA
Read-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ábilesA
Read-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 FIXA
Read-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 UDIA
Read-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 CLABEA
Read-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 CURPA
Read-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 NSSA
Read-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 RFCA
Read-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

    A4.1/5.0

    Scored across 15 tools

    Disambiguation4/5

    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.

    Naming Consistency3/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides 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
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      -
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      9
      280 npm
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants and agents to query official Mexican economic data from Banxico, including USD/MXN exchange rates, inflation (INPC), UDIS, and interest rates.
      6
      30 PyPI
      6
      MIT