Climatiq

You run Climatiq MCP Server to empower AI assistants with real-time carbon emissions calculations by connecting to Climatiq’s API. This server exposes calculation results as resources and lets you generate natural-language climate explanations, enabling you to deliver climate insights alongside AI-driven conversations.

How to use

Start the server and provide your Climatiq API key to enable calculations such as electricity, travel, and other emission factors. Once running, point your MCP client at the server to invoke tools like electricity-emission, travel-emission, and search-emission-factors. Each calculation returns a resource with a climatiq://calculation/{id} URI that contains the emission factor details and results. Use climate-impact-explanation to produce natural language explanations of the results for end users.

How to install

Prerequisites: you need Python tooling and a way to manage virtual environments. You will also use uv to manage environments and install the MCP server package.

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

# Create and activate a virtual environment
uv venv

# Activate the virtual environment
# On macOS/Linux:
source .venv/bin/activate
# On Windows:
.venv\Scripts\activate

# Install dependencies with development extras
uv sync --dev --extra all

Additional setup and running the server

Configure your Climatiq API key before starting the server. You can set it via an environment variable, a .env file, or inline during installation. The run command starts the MCP server so your AI assistant can access Climatiq calculations.

# Set the API key in your environment
export CLIMATIQ_API_KEY=your_climatiq_api_key

# Or create a .env file in the project root
# CLIMATIQ_API_KEY=your_climatiq_api_key

# Start the MCP server after configuration
climatiq-mcp-server

Configuration and security

Provide your API key securely and avoid exposing it in logs or in client configurations. The server uses this key to authenticate with Climatiq and perform emission calculations.

If you are integrating with an AI assistant, ensure the MCP server endpoint is reachable by the assistant and that the API key is loaded in the server environment before making requests.

Examples and utilities

The server exposes useful tools to perform a wide range of emissions calculations and to search emission factors. You can also generate climate explanations for end users.

Key tools and prompts available include set-api-key, electricity-emission, travel-emission, search-emission-factors, custom-emission-calculation, cloud-computing-emission, freight-emission, procurement-emission, hotel-emission, travel-spend, and climate-impact-explanation.

Troubleshooting

If you encounter API key issues, verify that CLIMATIQ_API_KEY is set correctly in your environment or .env file. Ensure the key is active in Climatiq’s dashboard and that the server process has access to it. You can run a simple internal test to verify API key integrity.

Notes

The MCP server is designed to enable real-time climate calculations within AI assistants. You will typically deploy it as a local stdio service that your client can invoke, with the API key configured securely in the environment.

Available tools

set-api-key

Configure the Climatiq API key for the MCP server at runtime or startup.

electricity-emission

Calculate carbon emissions from electricity consumption based on activity factors.

travel-emission

Calculate emissions from travel by car, plane, or train.

search-emission-factors

Search for emission factors in the Climatiq database.

custom-emission-calculation

Perform custom calculations using specific emission factors.

cloud-computing-emission

Calculate emissions from cloud computing resources usage.

freight-emission

Calculate emissions from freight transportation.

procurement-emission

Calculate emissions from procurement spending.

hotel-emission

Calculate emissions from hotel stays.

travel-spend

Calculate emissions from travel expenses.

climate-impact-explanation

Generate natural language explanations about the climate impact of calculations.