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

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
   

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

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Gemini CLI

Add to ~/.gemini/settings.json:

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

Available Tools

Tool	Description	Parameters
get_latest_usd_mxn_rate()	Get the most recent USD/MXN exchange rate	None
get_usd_mxn_historical_data(limit)	Get historical exchange rate data	limit: Max data points (default: 30)
get_series_metadata(series_id)	Get metadata for a data series	series_id: Series ID (default: SF63528)
get_date_range_data(start_date, end_date, series_id)	Get data for specific date range	start_date, end_date: YYYY-MM-DD format
get_inflation_data(inflation_type, limit)	Get inflation data	inflation_type: 'monthly', 'accumulated', 'annual' (default: 'monthly')<br>limit: Max data points (default: 12)
get_udis_data(limit)	Get UDIS (Investment Units) values	limit: Max data points (default: 30)
get_cetes_28_data(limit)	Get CETES 28-day interest rates	limit: Max data points (default: 30)
get_banxico_reserves_data(limit)	Get Banxico Reserve Assets data	limit: Max data points (default: 30)
get_unemployment_data(limit)	Get unemployment rate data	limit: Max data points (default: 24)

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/
├── banxico_mcp_server.py    # Main server file
├── README.md                # This file
├── LICENSE                  # MIT License
├── CONTRIBUTING.md          # Development guidelines
└── docs/                    # Documentation and examples
    ├── EXTENDING.md         # Guide for adding new endpoints
    └── examples/            # Configuration examples
        ├── claude-desktop.md
        ├── continue.md
        ├── env-template.md
        ├── gemini-cli.md
        └── vscode-cline.md

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