Climatiq MCP Server

Name: Climatiq MCP Server
Author: jagan-shanmugam

@jagan-shanmugam

About 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.

#mcp #climate-data #llm #anthropic-claude

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "climatiq-mcp-server": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Tools

Configure the Climatiq API key used for authentication

Calculate carbon emissions from electricity consumption

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

Search for specific emission factors in the Climatiq database

Perform custom calculations using specific emission factors

Calculate emissions from cloud computing resources usage

Calculate emissions from freight transportation

Calculate emissions from procurement spending

Calculate emissions from hotel stays

Calculate emissions from travel expenses

Overview

What is Climatiq MCP Server?

A Model Context Protocol (MCP) server that integrates with the Climatiq API to allow AI assistants to perform real-time carbon emission calculations and provide climate impact insights.

How to use Climatiq MCP Server?

Install via uv or from source. Provide a Climatiq API key via the CLIMATIQ_API_KEY environment variable, a .env file, or the set-api-key tool at runtime. Start the server with the climatiq-mcp-server command. Configure in AI assistants by adding the command and environment variable to their MCP settings.

Key features of Climatiq MCP Server

Set and manage the Climatiq API key during runtime
Calculate emissions from electricity, travel, cloud, freight, procurement, and hotel stays
Search for specific emission factors in the Climatiq database
Perform custom calculations using any emission factor by activity ID
Expose calculation results as resources with climatiq://calculation/{id} URIs
Generate natural-language explanations of emissions via the climate-impact-explanation prompt

Use cases of Climatiq MCP Server

An AI assistant calculates the carbon footprint of a business flight
A developer queries emissions from cloud computing resource usage
A procurement analyst estimates emissions from supplier spending data
A traveller evaluates the environmental impact of hotel stays
A sustainability team searches for region-specific emission factors for reporting

FAQ from Climatiq MCP Server

How do I get a Climatiq API key?

What is an Activity ID?

An Activity ID groups similar emission factors that describe the same activity across different regions, years, and sources. For example, electricity-supply_grid-source_residual_mix groups electricity emission factors.

What calculation methods does the server support?

It supports distance-based, advanced travel with origin-destination pairs, spend-based, and direct calculation methods using specific emission factors.

How can I test if my API key works?

Use the examples/simple_test.py script or the test_client.py utility to verify API connectivity without the full MCP workflow.

What runtime dependencies are required?

The server requires uv for virtual environment management and the Climatiq API key. It is installed via uv pip install climatiq-mcp-server or run directly from source.