DataBursatil MCP Server
MCP server to access the DataBursatil API, which provides data from the Mexican stock market (BMV, BIVA).
Requirements
- Python 3.10 or higher
- uv (recommended) or pip
- DataBursatil API token (get one at databursatil.com)
Installation
With uv (recommended)
# Clone or download the project
cd databursatil-mcp
# Install dependencies
uv sync
With pip
cd databursatil-mcp
pip install -e .
Configuration
The server requires a DataBursatil authentication token. Configure the DATABURSATIL_TOKEN environment variable:
# Linux/macOS
export DATABURSATIL_TOKEN="your_30_character_token"
# Windows (PowerShell)
$env:DATABURSATIL_TOKEN = "your_30_character_token"
# Windows (CMD)
set DATABURSATIL_TOKEN=your_30_character_token
Configuration in Claude
Add the following configuration to your claude_desktop_config.json file:
Configuration in Claude Code
{
"mcpServers": {
"databursatil": {
"command": "uv",
"args": ["--directory", "/path/to/databursatil-mcp", "run", "databursatil-mcp"],
"env": {
"DATABURSATIL_TOKEN": "your_token_here"
}
}
}
}
Available Tools
1. get_emisoras
Gets general information about issuers and their series.
Usage example:
"Show me issuers starting with A"
"List all issuers in the global market"
2. get_intradia
Gets intraday quotes during trading hours.
Usage example:
"Show me intraday prices for AMXL* in 5-minute intervals for today"
3. get_cotizaciones
Gets current prices of issuers.
Available concepts:
Usage example:
"What is the current price of AMXL* and FEMSAUBD?"
"Show me the volume and percentage change for GFNORTEO"
4. get_top
Gets ranking of issuers by different criteria.
Usage example:
"What are the top 10 stocks gaining today on the BMV?"
"Top 5 issuers with highest volume this week"
5. get_historicos
Gets historical closing prices.
Usage example:
"Show me the price history for AMXL* for the last month"
"BIMBOA closing prices for 2024"
6. get_financieros
Gets financial statements of issuers.
Usage example:
"Show me FEMSA's balance sheet for Q1 2025"
"AMXL quarterly results for Q4 2024"
7. get_indices
Gets stock market index prices.
Usage example:
"How is the IPC today?"
"Show me all stock market indices"
8. get_tasas
Gets Mexican money market rates.
Usage example:
"What is the 28-day TIIE rate?"
"Show all reference rates"
9. get_divisas
Gets currency exchange rates.
Usage example:
"What's the dollar exchange rate?"
"Euro to peso exchange rate"
10. get_commodities
Gets commodity prices.
Usage example:
"WTI oil price"
"How is gold doing today?"
11. get_noticias
Gets business and economy news.
No required parameters.
Usage example:
"What are the latest financial news?"
12. get_cables
Gets news wires from Mexican issuers.
Usage example:
"Show me today's issuer bulletins"
"Market flash news"
13. get_descargas
Downloads end-of-day facts or valuations.
Usage example:
"Download last Friday's facts"
"Government valuations for January 15"
14. get_hechos
Gets filtered individual operations.
Usage example:
"Show me AMXL* operations for today between 9:00 and 11:00"
15. get_creditos
Shows available credits for the token.
No required parameters.
Usage example:
"How many credits do I have left?"
Development
Test the server locally
# With MCP inspector
uv run mcp dev src/databursatil_mcp/server.py
# Run directly
uv run databursatil-mcp
Common Errors
License
MIT