Climatiq MCP Server
@jagan-shanmugam
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.
概览
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?
Sign up at app.climatiq.io and follow the instructions at Getting API Keys.
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.
