Banxico MCP Server

Instructions

Implementation Reference

• banxico_mcp_server.py:442-481 (handler)

  Primary handler for get_inflation_data tool. Registered via @mcp.tool() decorator. Maps inflation_type to Banxico series IDs (SP30577 monthly, SP30579 accumulated, SP30578 annual), fetches data via API, applies limit to recent points, formats output using helper.
  @mcp.tool() async def get_inflation_data(inflation_type: str = "monthly", limit: Optional[int] = 12) -> str: """ Get inflation data from Banxico. Args: inflation_type: Type of inflation data ('monthly', 'accumulated', 'annual') limit: Maximum number of recent data points (default: 12) Returns: Formatted inflation data with percentages """ if not BANXICO_TOKEN: return "Error: BANXICO_API_TOKEN environment variable not set. Please configure your API token." # Map inflation types to series IDs series_map = { "monthly": "SP30577", # Monthly Inflation "accumulated": "SP30579", # Accumulated Inflation "annual": "SP30578" # Annual Inflation } if inflation_type not in series_map: return f"Invalid inflation type: {inflation_type}. Available types: {list(series_map.keys())}" series_id = series_map[inflation_type] endpoint = f"series/{series_id}/datos" data = await make_banxico_request(endpoint, BANXICO_TOKEN) if not data: return f"Failed to retrieve {inflation_type} inflation data. Please check your API token and network connection." # Apply limit if specified if limit and data.get("bmx", {}).get("series"): for series in data["bmx"]["series"]: if "datos" in series and len(series["datos"]) > limit: series["datos"] = series["datos"][-limit:] return format_inflation_data(data)
• banxico_mcp_server.py:125-169 (helper)

  Helper function specifically for formatting inflation data: adds % symbols, shows recent data points (up to 10), structures output with emojis and series info.
  def format_inflation_data(data: dict[str, Any]) -> str: """ Format inflation data with percentage symbols and better labeling. Args: data: Raw JSON response from Banxico API Returns: Formatted string with inflation data including percentage symbols """ if not data or "bmx" not in data: return "No inflation data available" series_list = data["bmx"].get("series", []) if not series_list: return "No inflation series found" result = [] for series in series_list: title = series.get("titulo", "Unknown Series") series_id = series.get("idSerie", "Unknown ID") result.append(f"📊 {title} (ID: {series_id})") datos = series.get("datos", []) if not datos: result.append(" No data points available") else: result.append(f" Total data points: {len(datos)}") # Show recent data points with percentage formatting display_count = min(len(datos), 10) for dato in datos[-display_count:]: fecha = dato.get("fecha", "Unknown date") valor = dato.get("dato", "N/A") # Add percentage symbol for inflation data if valor != "N/A" and valor is not None: try: valor_num = float(valor) valor = f"{valor_num}%" except (ValueError, TypeError): pass result.append(f" {fecha}: {valor}") result.append("") # Empty line between series return "\n".join(result)
• banxico_mcp_server.py:43-69 (helper)

  Shared async helper for making HTTP requests to Banxico SIE API, used by get_inflation_data and other tools. Handles errors, authentication via token, and returns JSON or None.
  async def make_banxico_request(endpoint: str, token: str) -> dict[str, Any] | None: """ Make a request to the Banxico SIE API with proper error handling. Args: endpoint: The API endpoint to call (without base URL) token: The Banxico API token Returns: JSON response data or None if request failed """ url = f"{BANXICO_API_BASE}/{endpoint}" headers = {"User-Agent": USER_AGENT} params = {"token": token} try: async with httpx.AsyncClient() as client: response = await client.get(url, headers=headers, params=params, timeout=30.0) response.raise_for_status() return response.json() except httpx.HTTPError as e: logger.error(f"HTTP error occurred: {e}") return None except Exception as e: logger.error(f"An error occurred: {e}") return None