Climatiq MCP Server

Climatiq MCP Server

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.

jagan-shanmugam

Research & Data
Visit Server

README

Climatiq MCP Server

License: MIT

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 scheme
  • Each 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.

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

# Create 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

Using uv

uv pip install climatiq-mcp-server

API Key Configuration

The server requires a Climatiq API key to function. You have several options to provide it:

  1. Environment Variable: Set the CLIMATIQ_API_KEY environment variable before starting the server

    export CLIMATIQ_API_KEY=your_climatiq_api_key
    
  2. Configuration During Installation:

    CLIMATIQ_API_KEY=your_climatiq_api_key uv pip install climatiq-mcp-server
    
  3. set-api-key Tool: Use the set-api-key tool to configure it during runtime within the AI assistant

  4. Configuration File: Create a .env file in the project directory:

    CLIMATIQ_API_KEY=your_climatiq_api_key
    

To get a Climatiq API key:

  1. Sign up at app.climatiq.io
  2. Follow the instructions at Getting API Keys

Running the Server

The server can be started directly from the command line:

climatiq-mcp-server

Setup in AI Assistants

Claude Desktop

On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

<details> <summary>Configuration Example</summary>

"mcpServers": {
  "climatiq-mcp-server": {
    "command": "climatiq-mcp-server",
    "env": {
      "CLIMATIQ_API_KEY": "your_climatiq_api_key"
    }
  }
}

</details>

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
# Run the simple test
python examples/simple_test.py

Utility Scripts

The utils/ directory contains several helpful scripts:

Test Client

The test_client.py script tests all the tools, prompts, and resources:

python utils/test_client.py

LLM Example Client

The llm_example_client.py script demonstrates how a Large Language Model (like Claude) could interact with the Climatiq MCP server:

python utils/llm_example_client.py

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:

# For electricity emissions
python utils/climatiq_cli.py electricity --energy 1000 --unit kWh --region US

# For travel emissions
python utils/climatiq_cli.py travel --mode car --distance 100 --unit km --region US

Run MCP Server Script

Use the run_mcp_server.py script to directly run the server without installing:

python utils/run_mcp_server.py

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:

  1. Distance-based method for travel emissions
  2. Advanced travel calculations with origin-destination pairs
  3. Spend-based method for when you only have expenditure data
  4. Direct calculations using specific emission factors

Troubleshooting

API Key Issues

  1. Ensure CLIMATIQ_API_KEY is set correctly in your environment or .env file
  2. Verify the API key is active in your Climatiq dashboard
  3. 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.

Recommended Servers

Crypto Price & Market Analysis MCP Server

Crypto Price & Market Analysis MCP Server

A Model Context Protocol (MCP) server that provides comprehensive cryptocurrency analysis using the CoinCap API. This server offers real-time price data, market analysis, and historical trends through an easy-to-use interface.

Featured
TypeScript
MCP PubMed Search

MCP PubMed Search

Server to search PubMed (PubMed is a free, online database that allows users to search for biomedical and life sciences literature). I have created on a day MCP came out but was on vacation, I saw someone post similar server in your DB, but figured to post mine.

Featured
Python
dbt Semantic Layer MCP Server

dbt Semantic Layer MCP Server

A server that enables querying the dbt Semantic Layer through natural language conversations with Claude Desktop and other AI assistants, allowing users to discover metrics, create queries, analyze data, and visualize results.

Featured
TypeScript
mixpanel

mixpanel

Connect to your Mixpanel data. Query events, retention, and funnel data from Mixpanel analytics.

Featured
TypeScript
Sequential Thinking MCP Server

Sequential Thinking MCP Server

This server facilitates structured problem-solving by breaking down complex issues into sequential steps, supporting revisions, and enabling multiple solution paths through full MCP integration.

Featured
Python
Nefino MCP Server

Nefino MCP Server

Provides large language models with access to news and information about renewable energy projects in Germany, allowing filtering by location, topic (solar, wind, hydrogen), and date range.

Official
Python
Vectorize

Vectorize

Vectorize MCP server for advanced retrieval, Private Deep Research, Anything-to-Markdown file extraction and text chunking.

Official
JavaScript
Mathematica Documentation MCP server

Mathematica Documentation MCP server

A server that provides access to Mathematica documentation through FastMCP, enabling users to retrieve function documentation and list package symbols from Wolfram Mathematica.

Local
Python
kb-mcp-server

kb-mcp-server

An MCP server aimed to be portable, local, easy and convenient to support semantic/graph based retrieval of txtai "all in one" embeddings database. Any txtai embeddings db in tar.gz form can be loaded

Local
Python
Research MCP Server

Research MCP Server

The server functions as an MCP server to interact with Notion for retrieving and creating survey data, integrating with the Claude Desktop Client for conducting and reviewing surveys.

Local
Python