Climatiq MCP Server

Instructions

Implementation Reference

• src/climatiq_mcp_server/tools.py:638-681 (handler)

  The `hotel_emission_tool` function implements the core logic for calculating CO2e emissions from hotel stays using the Climatiq API.

  async def hotel_emission_tool(config, arguments, server, climatiq_request):
      """
      Calculate carbon emissions from hotel stays.
      
      This tool estimates the greenhouse gas emissions associated with hotel accommodations
      based on the number of nights stayed and the location of the hotel. It provides
      valuable data for calculating business travel emissions.
      """
      hotel_nights = arguments.get("hotel_nights")
      location = arguments.get("location")
      year = arguments.get("year")
      
      if not hotel_nights or not location:
          raise ValueError("Missing required parameters for hotel emission calculation")
          
      # Construct the request to the Climatiq API
      request_data = {
          "hotel_nights": hotel_nights,
          "location": location
      }
      
      if year:
          request_data["year"] = year
          
      try:
          result = await climatiq_request("/travel/v1-preview1/hotel", request_data)
          
          # Store in cache
          cache_id = f"hotel_{hotel_nights}_{id(result)}"
          
          co2e = result.get("co2e", 0)
          co2e_unit = result.get("co2e_unit", "kg")
          location_name = result.get("location", {}).get("name", "unknown location")
          
          result_text = f"Hotel stay for {hotel_nights} nights in {location_name} "
          result_text += f"results in {co2e} {co2e_unit} of CO2e emissions."
          result_text += f"\n\nDetailed results are available as a resource with ID: {cache_id}"
          
          return result_text, result, cache_id
          
      except ValueError as e:
          error_text = f"Error calculating hotel emissions: {str(e)}"
          return error_text, None, None

• src/climatiq_mcp_server/tools.py:864-876 (registration)

  Tool registration in `get_tool_definitions()` including name, description, and input schema.

  types.Tool(
      name="hotel-emission",
      description="Calculate carbon emissions from hotel stays based on the number of nights stayed and the location of the hotel.",
      inputSchema={
          "type": "object",
          "properties": {
              "hotel_nights": {"type": "number", "description": "Number of nights stayed"},
              "location": {"type": "string", "description": "Location of the hotel"},
              "year": {"type": "number", "description": "Year of the hotel stay"},
          },
          "required": ["hotel_nights", "location"],
      },
  ),

• src/climatiq_mcp_server/tools.py:864-876 (schema)

  Input schema definition for the hotel-emission tool, specifying required parameters: hotel_nights and location.

  types.Tool(
      name="hotel-emission",
      description="Calculate carbon emissions from hotel stays based on the number of nights stayed and the location of the hotel.",
      inputSchema={
          "type": "object",
          "properties": {
              "hotel_nights": {"type": "number", "description": "Number of nights stayed"},
              "location": {"type": "string", "description": "Location of the hotel"},
              "year": {"type": "number", "description": "Year of the hotel stay"},
          },
          "required": ["hotel_nights", "location"],
      },
  ),

• src/climatiq_mcp_server/server.py:262-263 (handler)

  Dispatch logic in `@server.call_tool()` handler that routes 'hotel-emission' calls to the hotel_emission_tool function.

  elif name == "hotel-emission":
      result_text, result, cache_id = await hotel_emission_tool(config, arguments, server, climatiq_request)