mcp-banxico
Servidor MCP que permite a asistentes de IA consultar datos económicos oficiales de México desde el SIE de Banxico.
Consultar tipo de cambio USD/MXN (FIX o liquidación), hoy o en rango de fechas.
Consultar inflación anual o mensual (INPC).
Consultar valor de UDIS, opcionalmente en fecha específica.
Consultar tasas de interés: TIIE 28 días o tasa objetivo.
Consultar reservas internacionales netas.
Consultar cualquier serie económica del catálogo SIE por ID, con rango de fechas opcional.
Usarse vía endpoint remoto sin token o localmente con token propio (stdio/HTTP).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-banxico What's the current USD/MXN exchange rate?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🇲🇽 mcp-banxico
Servidor comunitario de Model Context Protocol (MCP) para conectar asistentes de Inteligencia Artificial (Claude Desktop, Cursor, Cline, Gemini CLI) con el Sistema de Información Económica (SIE) del Banco de México (Banxico).
Permite a tus modelos y agentes de IA consultar en tiempo real el tipo de cambio oficial (USD/MXN), inflación (INPC), valor de las UDIS, tasas de interés interbancarias (TIIE) y cualquier serie económica oficial de México.
Proyecto independiente. No está afiliado ni respaldado por el Banco de México. Consume la API pública del SIE. Si lo instalas en local necesitas tu propio token gratuito; el endpoint remoto de más abajo no lo requiere.
▶️ Demo en video

Diez minutos sin cortes: un modelo local (Qwen 2.5 en Ollama) y Claude Desktop pasan de "no tengo acceso en tiempo real" a responder con el tipo de cambio oficial. El momento clave está en el minuto 2:52.
Related MCP server: mcp-inegi
📈 Datos en vivo
banxico-mcp.duckdns.org: tipo de cambio (dólar, euro, libra, dólar canadiense y yen), tasas de interés, curva de CETES, inflación, UDIS y reservas internacionales, 22 indicadores oficiales que se actualizan cada día hábil. Cada uno se puede descargar en CSV. Vive en el mismo dominio que el endpoint remoto de este servidor.
🏗️ Arquitectura
flowchart LR
subgraph Clientes["Clientes MCP / AI"]
Claude["Claude Desktop"]
Cursor["Cursor IDE"]
Cline["Cline / VS Code"]
Agents["AI Agents"]
end
subgraph Server["mcp-banxico"]
MCP["MCP Protocol (stdio)"]
Tools["Herramientas Económicas"]
end
subgraph Banxico["Banco de México"]
SIE["API SIE Banxico"]
end
Clientes <-->|JSON-RPC / stdio| MCP
MCP --> Tools
Tools <-->|HTTPS + Token| SIE⚡ Instalación y Uso Rápido
Opción 0: Endpoint remoto (sin instalar nada, sin token)
Hay una instancia pública hospedada. No requiere instalación ni que saques tu propio token de Banxico:
https://banxico-mcp.duckdns.org/mcpTransporte streamable-http. En Claude Desktop:
{
"mcpServers": {
"banxico": {
"type": "streamable-http",
"url": "https://banxico-mcp.duckdns.org/mcp"
}
}
}Es un servicio comunitario en infraestructura propia, con límite de peticiones por IP. Para uso intensivo o en producción, instálalo localmente con tu token: así no dependes de que esta instancia esté disponible.
Probarlo a mano (curl o Postman)
El endpoint habla JSON-RPC 2.0 sobre HTTP POST. Son dos peticiones: una para abrir sesión y otra para llamar la herramienta.
1. Abrir sesión. La respuesta trae el header mcp-session-id:
curl -i -X POST https://banxico-mcp.duckdns.org/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-06-18",
"capabilities": {},
"clientInfo": { "name": "curl", "version": "1" }
}
}'2. Llamar una herramienta, pasando ese id en el header:
curl -X POST https://banxico-mcp.duckdns.org/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'mcp-session-id: EL_ID_DEL_PASO_1' \
-d '{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": { "name": "tipo_cambio_usd", "arguments": {} }
}'Respuesta (el contenido viaja como evento SSE, en la línea data:):
{
"serie": "TIPO_CAMBIO_FIX",
"id_serie": "SF43718",
"nombre": "Tipo de cambio FIX (Pesos por Dólar)",
"unidad": "Pesos por dólar",
"fecha": "28/09/2026",
"valor": "17.8413"
}Otros ejemplos de params:
{ "name": "inflacion_mexico", "arguments": { "tipo": "anual" } }
{ "name": "valor_udis", "arguments": {} }
{ "name": "tasa_interes_banxico", "arguments": { "tipo": "objetivo" } }
{ "name": "reservas_internacionales", "arguments": {} }
{ "name": "consultar_serie_sie", "arguments": { "id_serie": "SF43718",
"fecha_inicio": "2026-09-01",
"fecha_fin": "2026-09-28" } }Dos cosas que confunden al probar desde Postman. El header
mcp-session-ides obligatorio a partir de la segunda petición: sin él la respuesta es400. Y si mandasAccept: application/jsona secas obtienes406— el servidor exige aceptar ambos tipos, o puedes omitir el header por completo.
Opción 1: Con uvx (Recomendado para Claude Desktop y Cursor)
uvx mcp-banxicoOpción 2: Con pip
pip install mcp-banxico
mcp-banxico🛠️ Configuración en Clientes de IA
1. Claude Desktop
Agrega la siguiente configuración a tu archivo claude_desktop_config.json:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"banxico": {
"command": "uvx",
"args": ["mcp-banxico"],
"env": {
"BANXICO_TOKEN": "TU_TOKEN_DE_BANXICO_AQUI"
}
}
}
}2. Cursor IDE
En Settings -> Features -> MCP Servers -> Add new MCP server:
Name:
banxicoType:
commandCommand:
uvx mcp-banxico
📊 Herramientas Disponibles para la IA
Herramienta | Serie Banxico | Descripción |
|
| Consulta el tipo de cambio oficial peso/dólar (FIX o liquidación), hoy o en un rango de fechas. |
|
| Consulta la inflación general anual o mensual de México basada en el INPC. |
|
| Consulta el valor oficial de las Unidades de Inversión (UDIS) en pesos mexicanos. |
|
| Consulta la TIIE a 28 días o la Tasa Objetivo de fondeo interbancario. |
|
| Saldo de la reserva internacional del Banco de México, en millones de USD. |
| Cualquiera | Consulta avanzada para cualquier ID de serie del catálogo general de Banxico. |
🌐 Hospedar tu propia instancia remota
mcp-banxico --transport streamable-http \
--host 127.0.0.1 --port 8005 \
--allowed-host tu-dominio.example--allowed-host es obligatorio detrás de un proxy inverso: el transporte HTTP
valida el header Host contra ataques de DNS rebinding y, sin declarar el
nombre público, responde 421 a todas las peticiones.
La caché en memoria (1 h por defecto, BANXICO_CACHE_TTL para ajustarla)
evita que el token compartido agote su límite en el SIE.
🔑 Cómo obtener tu Token de Banxico
Banxico proporciona acceso público y gratuito a su API:
Ingresa a: Portal de Tokens de Banxico SIE
Ingresa tu correo y solicita tu token. Te llegará inmediatamente.
Configúralo en tu entorno:
export BANXICO_TOKEN="tu_token_aqui"
🧪 Verificación Local
Puedes probar que tu token y la conexión funcionen correctamente ejecutando:
mcp-banxico --testSalida esperada:
============================================================
mcp-banxico v0.1.0 - Verificación de Conexión a Banxico SIE
============================================================
Consultando tipo de cambio FIX (serie SF43718)...
-> Éxito: Fecha 18/09/2026, Valor: $19.92 MXN por USD💻 Desarrollo y Pruebas
Para contribuir localmente:
git clone https://github.com/nanisadw3/mcp-banxico.git
cd mcp-banxico
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytest --cov=mcp_banxico📄 Licencia
Distribuido bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.
Desarrollado con ❤️ en México por Inaki Sobera (nanisadw3).
Available Tools
6 toolsconsultar_serie_sieAInspect
Consulta avanzada para obtener observaciones de cualquier serie económica del catálogo SIE de Banxico.
Args: id_serie: Identificador de la serie oficial (por ejemplo: 'SF43718', 'SP68257', 'SF61745'). fecha_inicio: Fecha inicial en formato YYYY-MM-DD o DD/MM/YYYY (opcional). fecha_fin: Fecha final en formato YYYY-MM-DD o DD/MM/YYYY (opcional).
Inputs: id_serie (required), fecha_fin, fecha_inicio. Returns: result
inflacion_mexicoAInspect
Consulta la inflación oficial en México según el INPC de Banxico.
Args: tipo: Tipo de medición de inflación. Opciones: 'anual' (por defecto) o 'mensual'.
Inputs: tipo. Returns: result
reservas_internacionalesAInspect
Consulta el saldo de reservas internacionales netas del Banco de México (en millones de dólares).
Inputs: no named parameters. Returns: result
tasa_interes_banxicoAInspect
Consulta las tasas de interés interbancarias y de política monetaria en México.
Args: tipo: Tipo de tasa. Opciones: 'tiie_28' (TIIE a 28 días) o 'objetivo' (Tasa de referencia/fondeo).
Inputs: tipo. Returns: result
tipo_cambio_usdAInspect
Consulta el tipo de cambio oficial peso mexicano vs dólar estadounidense (USD/MXN).
Args: tipo: Modalidad del tipo de cambio. Opciones: 'FIX' (por defecto) o 'LIQUIDACION'. fecha_inicio: Fecha inicial en formato YYYY-MM-DD o DD/MM/YYYY (opcional). fecha_fin: Fecha final en formato YYYY-MM-DD o DD/MM/YYYY (opcional).
Inputs: tipo, fecha_fin, fecha_inicio. Returns: result
valor_udisAInspect
Consulta el valor oficial de las Unidades de Inversión (UDIS) en pesos mexicanos.
Args: fecha: Fecha específica a consultar en formato YYYY-MM-DD o DD/MM/YYYY (opcional).
Inputs: fecha. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each specific tool targets a distinct economic indicator, so there is little risk of confusing exchange rates, inflation, UDIs, interest rates, or reserves. The only overlap comes from consultar_serie_sie, which can technically retrieve the same series as the convenience wrappers, but its advanced generic purpose is clearly stated.
Tool names mostly follow a consistent Spanish snake_case noun-style pattern, such as tipo_cambio_usd, inflacion_mexico, and reservas_internacionales. The exception is consultar_serie_sie, which uses a verb-first pattern, creating a minor but noticeable naming deviation.
Six tools is a well-scoped set for a Banxico data server. It covers the major economic indicators users are likely to need without redundancy or excessive fragmentation.
The toolset covers the main Banxico indicators well: exchange rate, inflation, UDIs, interest rates, and international reserves. The generic consultar_serie_sie tool adds broad coverage of the full SIE catalog, though agents cannot search or discover series IDs without prior knowledge, which is a minor gap.
Maintenance
Related MCP Connectors
Banxico MCP — Banco de México (Mexico's central bank) via the SIE API.
Live & historical FX rates and currency conversion for AI agents. No API keys.
Live & historical FX rates and currency conversion for AI agents. No API keys.
Official Mexican data for AI agents: CURP, RFC, CFDI, postal codes, phone, SPEI/CEP, DOF, geocoding.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables access to Bank of Mexico (Banxico) economic data including real-time and historical USD/MXN exchange rates, inflation data, interest rates, and other financial indicators. Supports querying current rates, historical data with date ranges, and economic metadata through natural language.9MIT
- AlicenseNot gradedqualityCmaintenanceProvides access to Mexico's INEGI (national statistics office) indicators API, enabling AI agents to query statistical data through natural language or direct tool calls.88 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables querying Mexican stock market data (BMV, BIVA) including issuers, intraday quotes, historical prices, financials, indices, rates, currencies, commodities, and news through natural language.4MIT
- AlicenseBqualityCmaintenanceEnables querying Mexico's central bank macroeconomic indicators — policy rate, TIIE 28/91, Cetes 28, and UDIS values — plus UDI-to-peso conversion and inflation variation calculations over date ranges. Use-case-oriented tools batch series requests, cache results, and tolerate asynchronous publication quirks to stay within official API quotas.17MIT