Banxico MCP Server

A Model Context Protocol (MCP) server for accessing the Bank of Mexico (Banxico) SIE API to retrieve USD/MXN exchange rate data and other economic indicators.

Features

• Real-time Exchange Rates: Get the latest USD/MXN exchange rate from Banxico

• Historical Data: Retrieve historical exchange rate data with customizable limits

• Series Metadata: Access detailed information about economic data series

• Date Range Queries: Get exchange rate data for specific date ranges

• MCP Compatible: Works with Claude Desktop, Gemini CLI, and other MCP clients

Related MCP server: mcp-inegi

Prerequisites

1. Python 3.10+ installed on your system

2. uvx (recommended) or uv package manager

3. Banxico API Token - Get one from Banxico SIE API

Installation Methods

Option 1: Direct from GitHub (Auto-Updates) ⭐ Recommended

This method automatically gets the latest updates when you restart your MCP client:

Configuration for MCP clients:

"banxico": {
  "command": "uvx",
  "args": [
    "--from",
    "git+https://github.com/cfocoder/banxico_mcp",
    "banxico-mcp-server"
  ],
  "env": {
    "BANXICO_API_TOKEN": "your_token_here"
  }
}

No manual installation needed! uvx will automatically download and run the latest version.

Option 2: Download Single File (Manual Updates)

If you prefer to download the file locally:

1. Install uvx (if not already installed):

   pip install uv

2. Download the server file:

   curl -O https://raw.githubusercontent.com/cfocoder/banxico_mcp/main/banxico_mcp_server.py

3. Configuration for MCP clients:

   "banxico": {
     "command": "uvx",
     "args": [
       "--python", "3.12",
       "--from", "fastmcp",
       "--with", "httpx",
       "--",
       "python",
       "/absolute/path/to/banxico_mcp_server.py"
     ],
     "env": {
       "BANXICO_API_TOKEN": "your_token_here"
     }
   }

   To get updates: Re-download the file when new features are added.

Option 3: Traditional Installation

1. Clone the repository:

   git clone https://github.com/cfocoder/banxico_mcp.git
   cd banxico_mcp

2. Install dependencies:

   pip install fastmcp httpx

3. Run the server:

   BANXICO_API_TOKEN=your_token_here python banxico_mcp_server.py

Deployment with Docker/Coolify

Deploy as HTTP MCP Server (Coolify, Docker, Cloud)

This MCP server can run as a persistent HTTP service:

docker run -p 3333:3333 \
  -e BANXICO_API_TOKEN=xxx \
  -e MCP_PORT=3333 \
  cfocoder/banxico_mcp

Key points:

• ✅ Not just uvx - Can run as a long-lived service

• ✅ HTTP endpoint - /health available for monitoring

• ✅ Configurable port - Set via MCP_PORT environment variable

• ✅ Graceful shutdown - Responds to SIGTERM signals

• ✅ Perfect for Coolify - Simple Docker deployment

Quick Start with Docker Compose (Local Testing)

1. Clone and setup:

   git clone https://github.com/cfocoder/banxico_mcp.git
   cd banxico_mcp
   cp .env.example .env
   # Edit .env with your BANXICO_API_TOKEN and desired MCP_PORT

2. Run with Docker Compose:

   docker-compose up

3. Test the server:

   curl http://localhost:8000/health

Deployment in Coolify (Oracle Cloud)

1. Push to GitHub - Coolify will pull from your repository

2. Create new Docker service in Coolify - Select "Docker" type

3. Configure environment variables:

   • BANXICO_API_TOKEN: Your Banxico API token

   • MCP_PORT: Port number (default: 8000, change to avoid conflicts)

4. Expose port - Configure port mapping in Coolify dashboard

5. Health checks - Coolify will automatically use the /health endpoint

The Docker image will build automatically with production-ready features including health checks, non-root user, and graceful shutdown handling.

Configuration

Get Your Banxico API Token

1. Visit Banxico Token Registration

2. Fill out the form to request an API token

3. You'll receive your token via email

Configure MCP Clients

The server works with any MCP-compatible client. Use Option 1 from "Installation Methods" above (auto-updates from GitHub) for the easiest setup.

For local configuration, use the uvx commands shown in Installation Methods and substitute your Banxico API token in the env section.

Available Tools

Usage Examples

Once configured with your MCP client, you can ask:

Exchange Rates:

• "What's the current USD to MXN exchange rate?"

• "Show me the USD/MXN exchange rate for the last 10 days"

• "Get the exchange rate data from 2024-01-01 to 2024-01-31"

• "What's the metadata for the USD/MXN series?"

Inflation Data:

• "What's the current monthly inflation rate in Mexico?"

• "Show me the annual inflation data for the last year"

• "Get the accumulated inflation for the last 6 months"

Interest Rates:

• "What are the current CETES 28-day rates?"

• "Show me the CETES rates for the last month"

Financial Indicators:

• "What are the current UDIS values?"

• "Show me Banxico's reserve assets"

• "Get the latest financial indicators from Banxico"

Labor Market:

• "What's the current unemployment rate in Mexico?"

• "Show me unemployment trends for the last year"

• "How has unemployment changed over the last 2 years?"

API Reference

The server uses the Banxico SIE API with the following endpoints:

Exchange Rates:

• Latest Data: /series/SF63528/datos/oportuno

• Historical Data: /series/SF63528/datos

• Series Metadata: /series/SF63528

• Date Range: /series/SF63528/datos/{start_date}/{end_date}

Inflation Data:

• Monthly Inflation: /series/SP30577/datos

• Accumulated Inflation: /series/SP30579/datos

• Annual Inflation: /series/SP30578/datos

Financial Indicators:

• UDIS: /series/SP68257/datos

• CETES 28-day: /series/SF282/datos

• Banxico Reserves: /series/SF308843/datos

Labor Market:

• Unemployment Rate: /series/SL1/datos

Development

Project Structure

banxico-mcp-server/
├── Dockerfile               # Production Docker image
├── docker-compose.yml       # Local testing with Docker
├── .dockerignore           # Docker build optimization
├── .env.example            # Environment template
├── banxico_mcp_server.py   # Main MCP server
├── pyproject.toml          # Package configuration
├── README.md               # This file
├── LICENSE                 # MIT License
├── CONTRIBUTING.md         # Development guidelines
└── docs/
    └── EXTENDING.md        # Guide for adding new endpoints

Testing

To test the server without an MCP client:

# Set your token
export BANXICO_API_TOKEN=your_token_here

# Run the server with a timeout to test startup
timeout 5s python banxico_mcp_server.py && echo "Server starts successfully"

Adding New Tools

See EXTENDING.md for detailed instructions on adding new Banxico API endpoints.

Troubleshooting

Common Issues

1. "BANXICO_API_TOKEN environment variable not set"

   • Ensure your API token is properly configured in the MCP client settings

2. "Failed to retrieve data"

   • Check your internet connection

   • Verify your API token is valid

   • Ensure the Banxico API is accessible

3. Server doesn't start

   • Verify Python 3.10+ is installed

   • Check that uvx or required dependencies are available

Debug Mode

Run with debug logging:

BANXICO_API_TOKEN=your_token PYTHONPATH=. python -c "
import logging
logging.basicConfig(level=logging.DEBUG)
from banxico_mcp_server import mcp
mcp.run()
"

Contributing

1. Fork the repository

2. Create a feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Bank of Mexico (Banxico) for providing the SIE API

• Model Context Protocol for the protocol specification

• FastMCP for the excellent MCP server framework

Related Projects

• MCP Servers Collection

• Claude Desktop MCP Guide

• Gemini CLI Documentation