🇲🇽 mcp-banxico

Servidor oficial 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.

🏗️ 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

No necesitas clonar el repositorio para usarlo. Puedes ejecutarlo directamente desde este repositorio:

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

uvx --from git+https://github.com/nanisadw3/mcp-banxico mcp-banxico

Opción 2: Con pip

pip install git+https://github.com/nanisadw3/mcp-banxico
mcp-banxico

Nota: el paquete aún no está publicado en PyPI. Cuando lo esté, bastará con uvx mcp-banxico o pip install 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.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "banxico": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/nanisadw3/mcp-banxico", "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 --from git+https://github.com/nanisadw3/mcp-banxico mcp-banxico

📊 Herramientas Disponibles para la IA

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

   export BANXICO_TOKEN="tu_token_aqui"
   

🧪 Verificación Local

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

mcp-banxico --test

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