This MCP server exposes Climatiq’s carbon emission calculations as MCP resources and prompts that AI assistants can query in real time. It supports a range of tools to compute emissions across electricity usage, travel, cloud computing, freight, procurement, and hotel stays, among others. Use cases include converting energy consumption into CO2 emissions, estimating travel footprints for trips by car, plane, or train, and retrieving emission factors from Climatiq’s database. The server also provides a prompt for generating natural language explanations of climate impact, enabling conversational AI to communicate results clearly. Resources are exposed with climatiq://calculation/{id}, and each resource includes both the factor details and the calculation results for traceability.

Prerequisites:

• Python 3.x installed
• Access to the Climatiq API (API key)
• Optional: uv (for virtual environment and dependency management) as described below

From source installation (recommended when cloning the repo):

1. Clone the repository: git clone https://github.com/your-org/climatiq-mcp-server.git cd climatiq-mcp-server

2. Create and activate a virtual environment using uv: uv venv

   On macOS/Linux:

   source .venv/bin/activate

   On Windows:

   .\venv\Scripts\activate

3. Install dependencies (development extras included): uv sync --dev --extra all

4. Install Climatiq MCP server package (optional when using local source): uv pip install climatiq-mcp-server

Using uv directly to install the package (alternative): uv pip install climatiq-mcp-server

Configuration:

• Set the Climatiq API key via environment variable CLIMATIQ_API_KEY or in a .env file in the project directory: CLIMATIQ_API_KEY=your_climatiq_api_key

Run the MCP server:

• From the project root, start the server with: climatiq-mcp-server

Tips and common issues:

• Ensure your CLIMATIQ_API_KEY is valid and active in Climatiq’s dashboard.
• If starting the server fails due to missing environment variables, re-check the .env file or export the key in your shell before launching.
• The server exposes multiple tools (electricity-emission, travel-emission, search-emission-factors, custom-emission-calculation, cloud-computing-emission, freight-emission, procurement-emission, hotel-emission, travel-spend). You can use the MCP prompts to call these tools within AI assistant workflows.
• When integrating with Claude or other assistants, configure the mcpServers entry with the CLI command name and ensure the API key is provided in the environment section.
• For troubleshooting API key issues, verify the key in your Climatiq dashboard and test with a simple API call or the provided simple_test.py utility script.