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