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

Python 3.10+ installed on your system
uvx (recommended) or uv package manager
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:

Install uvx (if not already installed):
pip install uv
Download the server file:
curl -O https://raw.githubusercontent.com/cfocoder/banxico_mcp/main/banxico_mcp_server.py
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

Clone the repository:
git clone https://github.com/cfocoder/banxico_mcp.git cd banxico_mcp
Install dependencies:
pip install fastmcp httpx
Run the server:
BANXICO_API_TOKEN=your_token_here python banxico_mcp_server.py

Configuration

Get Your Banxico API Token

Visit Banxico Token Registration
Fill out the form to request an API token
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')`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

"BANXICO_API_TOKEN environment variable not set"
- Ensure your API token is properly configured in the MCP client settings
"Failed to retrieve data"
- Check your internet connection
- Verify your API token is valid
- Ensure the Banxico API is accessible
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

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
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

Deploy Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

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

Related Resources

Reddit Discussion about this server

Related MCP Servers

OKX MCP Server
esshka
A
security
F
license
A
quality
Provides real-time cryptocurrency price data from OKX exchange through a Model Context Protocol interface, allowing access to historical candlestick data and current market prices for any trading instrument.
Last updated -
2
8
13
Global MCP Stock Server
sakura-ku
-
security
F
license
-
quality
Provides real-time access to global stock market data including current prices, historical charts, and company financial information through a Model Context Protocol (MCP) server for AI assistants.
Last updated -
Binance Bitcoin MCP Tool
MilesCool
A
security
A
license
A
quality
Provides an MCP server that allows large language models to access real-time and historical Bitcoin market data from Binance, including current prices, order book data, recent trades, and price history through a standardized interface.
Last updated -
1
9
2
MIT License
MCP Yahoo Finance
leoncuhk
A
security
F
license
A
quality
Provides tools to get financial data (stock prices, company information) and generate financial visualizations through the Model Context Protocol.
Last updated -
10
4

View all related MCP servers

Appeared in Searches

Information on Working as an Actuary

Banxico MCP Server