MéxicoAPI
Official Mexican data for assistants: FIX rate, UDIS, business days, UMA, ISR, ID checks
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.2.1
- Listing updated
- 4 days ago
Similar MCP servers
About MéxicoAPI
MéxicoAPI is an MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
MéxicoAPI is built so an assistant looks up published Mexican figures rather than inventing them. It runs on your own machine over stdio, is read-only, and every result carries the official source, a cut-off date and where the data came from: the public API, the bundled mexicoapi package, or a local cache for postal codes. Results include a Spanish text and structured content that follows each tool's output schema.
Tools cover the INEGI municipality catalogue, state lists, CLABE and bank code checks, RFC, CURP and NSS format validation, the FIX exchange rate, UDI values, non-working days under the labour law, banking and tax calendars, UMA, minimum wage and ISR tables, and postal codes. Validators check format and check digits only and say they do not prove an account or person exists. Date arithmetic warns about what it does not account for.
Time-sensitive data falls back to the packaged copy if the API is down, and MEXICOAPI_SIN_RED forces fully offline answers. MEXICOAPI_BASE points at your own deployment. It needs Node 22.13 or later.
Install
Run in a terminal
claude mcp add mexicoapi-mcp -- npx -y mexicoapi-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"mexicoapi-mcp": {
"command": "npx",
"args": [
"-y",
"mexicoapi-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mexicoapi-mcp": {
"command": "npx",
"args": [
"-y",
"mexicoapi-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mexicoapi-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mexicoapi-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mexicoapi-mcp": {
"command": "npx",
"args": [
"-y",
"mexicoapi-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mexicoapi-mcp": {
"command": "npx",
"args": [
"-y",
"mexicoapi-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
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.
Tools this server provides (15)
Taken from the project documentation; the running server may differ.
- buscar_municipio
- Search municipalities by name in the INEGI catalogue
- municipio
- Get a municipality by geostatistical key
- estados
- List the 32 federal entities
- municipios_de_estado
- List municipalities of a state
- validar_clabe
- Validate a CLABE check digit and bank
- banco_por_codigo
- Look up a SPEI bank by 3-digit code
- validar_rfc
- Validate RFC format
- validar_curp
- Validate CURP format and check digit
- validar_nss
- Validate an IMSS NSS
- tipo_de_cambio_fix
- Get the FIX exchange rate
- udis
- Get the UDI value for a day
- dias_inhabiles
- List non-working days for a year
- sumar_dias_habiles
- Add working days to a date
- constantes
- Get UMA, minimum wage and ISR tables
- codigo_postal
- Look up a postal code
What it does
- Sourced results
- Each answer includes the official source, cut-off date and data origin.
- Offline mode
- Setting MEXICOAPI_SIN_RED answers from the bundled package without network access.
- Identifier validators
- Check CLABE, RFC, CURP and NSS format and check digits.
- Business-day maths
- Add working days using labour-law, banking or tax-authority calendars with warnings.
- Financial constants
- Look up FIX, UDIS, UMA, minimum wage and ISR tables.
- Municipality and postal data
- Search INEGI municipalities and read postal-code settlements.
Good for
- Validate a CLABE or RFC captured in a form
- Convert a deadline into a due date using the banking calendar
- Look up the FIX rate that applies to a given operation
- Find the municipality key for a place name
- Cite the official source behind a tax or wage figure
MéxicoAPI FAQ
Does it change anything?
No. All tools are read-only and declare readOnlyHint.
Does it work offline?
Yes, with MEXICOAPI_SIN_RED set, answers come from the bundled data package.
Does a valid RFC mean the person exists?
No. Validators check format and check digit and say they do not confirm existence.
Which Node version is needed?
Node 22.13 or later.
How do I add MéxicoAPI to Claude Code?
Run this command in your terminal: claude mcp add mexicoapi-mcp -- npx -y mexicoapi-mcp
What are the best alternatives to MéxicoAPI?
The closest alternatives to MéxicoAPI are Hexadata Tools, Lex API MX, calcu.mx — calculadoras de México, MexCheck and DOF: Diario Oficial de la Federación.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.