Supports loading Climatiq API key from a .env configuration file for secure credential management.
Provides repository access for the MCP server code and includes demo examples hosted on GitHub assets.
Includes example Jupyter notebook for demonstrating Climatiq API usage and carbon calculation capabilities.
Climatiq MCP Server
A Model Context Protocol (MCP) server for accessing the Climatiq API to calculate carbon emissions. This allows AI assistants to perform real-time carbon calculations and provide climate impact insights.
Demo
https://github.com/user-attachments/assets/c253d6d1-ccf6-4c14-965e-6023ba2a0296
https://github.com/user-attachments/assets/d61c1181-acf6-4d9f-9a48-537fc64ac4c3
Features
This MCP server integrates with the Climatiq API to provide carbon emission calculations for AI assistants:
Tools
set-api-key: Configure the Climatiq API key used for authentication
electricity-emission: Calculate carbon emissions from electricity consumption
travel-emission: Calculate carbon emissions from travel by car, plane, or train
search-emission-factors: Search for specific 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
Resources
Carbon calculation results are exposed as resources with a
climatiq://calculation/{id}
URI schemeEach resource contains detailed information about an emission factor and calculation results
Prompts
climate-impact-explanation: Generate natural language explanations about the climate impact of specific emission calculations
Installation
From Source
This project uses uv
for virtual environment and dependency management. Make sure to install uv first.
Using uv
API Key Configuration
The server requires a Climatiq API key to function. You have several options to provide it:
Environment Variable: Set the
CLIMATIQ_API_KEY
environment variable before starting the serverexport CLIMATIQ_API_KEY=your_climatiq_api_keyConfiguration During Installation:
CLIMATIQ_API_KEY=your_climatiq_api_key uv pip install climatiq-mcp-serverset-api-key Tool: Use the
set-api-key
tool to configure it during runtime within the AI assistantConfiguration File: Create a
.env
file in the project directory:CLIMATIQ_API_KEY=your_climatiq_api_key
To get a Climatiq API key:
Sign up at app.climatiq.io
Follow the instructions at Getting API Keys
Running the Server
The server can be started directly from the command line:
Setup in AI Assistants
Claude Desktop
On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
Examples and Utilities
Examples Directory
The examples/
directory contains:
climatiq.ipynb: A Jupyter notebook demonstrating direct API usage with Climatiq
simple_test.py: A simple utility for testing the API integration directly without MCP protocol
Utility Scripts
The utils/
directory contains several helpful scripts:
Test Client
The test_client.py
script tests all the tools, prompts, and resources:
LLM Example Client
The llm_example_client.py
script demonstrates how a Large Language Model (like Claude) could interact with the Climatiq MCP server:
Key features:
Complete API wrapper with error handling and timeout management
Resource and result caching to preserve calculation history
Example prompts showing how to generate natural language explanations
Demonstrates electricity emission, travel emission, and emission factor search capabilities
CLI Tool
A command-line interface tool for direct API access without the MCP server complexity:
Run MCP Server Script
Use the run_mcp_server.py
script to directly run the server without installing:
Key Concepts
Activity IDs
An Activity ID is a key concept in Climatiq's API that groups similar emission factors together:
Each emission factor in the Climatiq database has an activity ID
Activity IDs group emission factors describing the same activity across regions, years, sources, etc.
Examples:
electricity-supply_grid-source_residual_mix
(electricity),passenger_vehicle-vehicle_type_car
(car travel)
Calculation Methods
The Climatiq MCP server supports multiple calculation methods:
Distance-based method for travel emissions
Advanced travel calculations with origin-destination pairs
Spend-based method for when you only have expenditure data
Direct calculations using specific emission factors
Troubleshooting
API Key Issues
Ensure
CLIMATIQ_API_KEY
is set correctly in your environment or .env fileVerify the API key is active in your Climatiq dashboard
Use
examples/simple_test.py
to check if your API key works correctly
Advanced Usage
For detailed documentation on using specific tools and advanced features, see the docs/README.md file.
About Climatiq
Climatiq provides a powerful API for carbon intelligence, allowing you to calculate emissions from electricity usage, transportation, procurement, and more. This MCP server makes those capabilities accessible to AI assistants through the Model Context Protocol.
For more information about Climatiq, visit climatiq.io.
License
This project is licensed under the MIT License - see the LICENSE file for details.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
A Model Context Protocol server that enables AI assistants to perform real-time carbon emissions calculations and provide climate impact insights by interfacing with the Climatiq API.
Related MCP Servers
- AsecurityAlicenseAqualityA customizable Model Context Protocol server implementation that enables AI models to interact with external tools including weather queries, Google search, and camera control functionality.Last updated -114Apache 2.0
- AsecurityFlicenseAqualityA Model Context Protocol server that provides real-time weather information and 5-day forecasts to AI assistants, supporting multiple languages and flexible units.Last updated -32
- -securityFlicense-qualityA Model Context Protocol (MCP) server that enables AI assistants and LLMs to access real-time weather data and forecasts by connecting to the OpenWeatherMap API.Last updated -
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants to fetch current weather, forecasts, and search for locations using WeatherAPI service through stdio communication.Last updated -3MIT License