Model Context Protocol (MCP) server that exposes Climatiq’s carbon-calculation API to AI assistants (electricity, travel, cloud, freight, procurement, hotel, custom factors, etc.).
https://github.com/jagan-shanmugam/climatiq-mcp-serverBuilding sustainability features shouldn't require becoming a carbon accounting expert. This MCP server puts Climatiq's comprehensive emissions database directly into your AI assistant's toolkit, turning complex carbon calculations into simple conversations.
You know the drill: your product needs carbon footprint calculations, so you dive into emission factor databases, try to figure out regional variations, and end up with a mess of hardcoded values that go stale. Meanwhile, your AI assistant sits there, perfectly capable of handling the complexity—if only it had access to real emissions data.
This MCP server changes that. Instead of building carbon calculation infrastructure from scratch, you get instant access to Climatiq's professional-grade emission factors through your existing AI workflows.
Point your AI assistant at actual emission calculations without the typical integration overhead:
# Instead of this mess:
emission_factor = lookup_electricity_factor("US", "2023", "residual_mix")
carbon_kg = energy_kwh * emission_factor * grid_loss_factor
# ...plus regional adjustments, data validation, error handling
# You get this:
"Calculate emissions for 1,000 kWh of electricity usage in California"
# AI assistant handles the complexity, returns accurate results
The server exposes 9 specialized tools covering the emission calculations you actually need:
Climatiq's API is powerful but requires understanding activity IDs, regional variations, and calculation methodologies. This MCP server handles that complexity, letting you focus on building features instead of becoming a carbon data expert.
# Direct API requires this knowledge:
curl -X POST "https://api.climatiq.io/v1/estimates" \
-H "Authorization: Bearer $API_KEY" \
-d '{
"emission_factor": {
"activity_id": "passenger_vehicle-vehicle_type_car-fuel_source_na",
"region": "US",
"year": 2022
},
"parameters": {
"distance": 100,
"distance_unit": "km"
}
}'
# MCP server lets your AI handle it:
"What are the emissions from driving 100km in a car in the US?"
Building a corporate carbon tracker? Your AI assistant can calculate emissions from employee travel, office electricity usage, and cloud infrastructure with natural language queries.
Adding sustainability features to an e-commerce platform? Get shipping emission calculations for different carrier options, helping customers make informed choices.
Developing a carbon budgeting tool? Access thousands of emission factors for procurement categories, from office supplies to manufacturing equipment.
Creating travel planning features? Compare emission impacts across different transportation modes with real-time calculations.
# Install via uv
uv pip install climatiq-mcp-server
# Set your Climatiq API key
export CLIMATIQ_API_KEY=your_api_key
# Start the server
climatiq-mcp-server
Add to your Claude Desktop config:
{
"mcpServers": {
"climatiq-mcp-server": {
"command": "climatiq-mcp-server",
"env": {
"CLIMATIQ_API_KEY": "your_api_key"
}
}
}
}
This isn't just a simple API wrapper. The server includes:
The included utilities let you test calculations, explore the API, and even run calculations outside the MCP context when needed.
Built with FastAPI and proper error handling, this server is ready for real applications. The codebase includes comprehensive examples, from simple API tests to full Jupyter notebooks demonstrating advanced usage patterns.
The developer put serious thought into making this maintainable—clear separation between MCP protocol handling and Climatiq API integration, proper logging, and multiple deployment options.
Stop building carbon calculation infrastructure from scratch. This MCP server gives your AI assistant access to professional-grade emissions data, letting you build sustainability features that actually work.