Banxico (Banco de México)

io.github.nanisadw3Published by GitHub account nanisadw3v0.2.0Updated Oct 24, 2026

Mexico's official economic data from Banxico: USD/MXN, inflation, UDIS, TIIE and reserves.

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Community MCP server giving assistants read-only access to Banco de México's official economic data: USD/MXN, inflation, UDIS, interest rates and reserves.

What you can do
Look up the official USD/MXN exchange rate (FIX or settlement), for today or a date range, and Mexico's INPC inflation, annual or monthly, plus the current UDIS value in pesos and Banxico's interbank and policy interest rates (TIIE 28 days or target rate). Read the net international reserves balance in millions of USD. Query any series in Banxico's SIE catalog by series ID with optional start and end dates.
When to use it
Useful when an assistant needs current or historical Mexican macroeconomic figures, such as exchange rates, inflation, UDIS or interest rates, instead of relying on stale training data. Suited to finance, reporting and research questions about Mexico.
Requirements
Either the public remote endpoint over streamable HTTP, which needs no token, or a local install via uvx or pip (Python package mcp-banxico). Local use requires a free Banxico SIE API token in the BANXICO_TOKEN environment variable. Network access to Banxico's API is needed.
Before you install
Local installs need your own BANXICO_TOKEN, which is sent to Banxico's API; keep it out of shared config files. The public remote instance is a community service on the author's own infrastructure with per-IP rate limits and no availability guarantee; the README recommends local install for heavy or production use. The project is independent and not affiliated with Banco de México.

Installation

In SourceWeft

  1. Open Banxico (Banco de México) in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.nanisadw3%2Fbanxico/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "banxico-banco-de-m-xico": {
      "type": "http",
      "url": "https://banxico-mcp.duckdns.org/mcp"
    }
  }
}

README

🇲🇽 mcp-banxico

[PyPI] [Python] [License: MIT] [MCP] [Tests]

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

[Así conecté Claude al Banco de México]

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.

📈 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

mermaid
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/mcp

Transporte streamable-http. En Claude Desktop:

json
{  "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:

bash
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:

bash
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:):

json
{  "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:

json
{ "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-id es obligatorio a partir de la segunda petición: sin él la respuesta es 400. Y si mandas Accept: application/json a secas obtienes 406 — el servidor exige aceptar ambos tipos, o puedes omitir el header por completo.

Opción 1: Con uvx (Recomendado para Claude Desktop y Cursor)

bash
uvx mcp-banxico

Opción 2: Con pip

bash
pip install mcp-banxicomcp-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.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
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: banxico
  • Type: command
  • Command: uvx mcp-banxico

📊 Herramientas Disponibles para la IA

HerramientaSerie BanxicoDescripción
tipo_cambio_usdSF43718 / SF60653Consulta el tipo de cambio oficial peso/dólar (FIX o liquidación), hoy o en un rango de fechas.
inflacion_mexicoSP30578 / SP30577Consulta la inflación general anual o mensual de México basada en el INPC.
valor_udisSP68257Consulta el valor oficial de las Unidades de Inversión (UDIS) en pesos mexicanos.
tasa_interes_banxicoSF43783 / SF61745Consulta la TIIE a 28 días o la Tasa Objetivo de fondeo interbancario.
reservas_internacionalesSF43707Saldo de la reserva internacional del Banco de México, en millones de USD.
consultar_serie_sieCualquieraConsulta avanzada para cualquier ID de serie del catálogo general de Banxico.

🌐 Hospedar tu propia instancia remota

bash
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:

  1. Ingresa a: Portal de Tokens de Banxico SIE
  2. Ingresa tu correo y solicita tu token. Te llegará inmediatamente.
  3. Configúralo en tu entorno:
    bash
    export BANXICO_TOKEN="tu_token_aqui"

🧪 Verificación Local

Puedes probar que tu token y la conexión funcionen correctamente ejecutando:

bash
mcp-banxico --test

Salida esperada:

text
============================================================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:

bash
git clone https://github.com/nanisadw3/mcp-banxico.gitcd mcp-banxicopython -m venv .venvsource .venv/bin/activatepip 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).

Source: README.md at commit 2723b07

Tools

6

tipo_cambio_usd

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).

Parameterstipofecha_finfecha_inicio

inflacion_mexico

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'.

Parameterstipo

valor_udis

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).

Parametersfecha

tasa_interes_banxico

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).

Parameterstipo

reservas_internacionales

Consulta el saldo de reservas internacionales netas del Banco de México (en millones de dólares).

Takes no parameters.

consultar_serie_sie

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).

Parametersid_serierequiredfecha_finfecha_inicio

Version history

3
  1. v0.2.0LatestSep 29, 2026
  2. v0.1.3Sep 26, 2026
  3. v0.1.2Sep 25, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts