Climatiq MCP Server

🚀 Climatiq MCP Server

A Model Context Protocol (MCP) server for calculating carbon emissions by accessing the Climatiq API. This enables AI assistants to perform real-time carbon emission calculations and provide insights into climate impacts.

🚀 Quick Start

The Climatiq MCP Server is a powerful tool that allows AI assistants to calculate carbon emissions in real - time by accessing the Climatiq API. This README will guide you through its features, installation, usage, and more.

🎥 Demonstration

• View the video link
• View another video link

✨ Features

Tools

This server supports the following tools:

1. electricity (Electricity consumption)

   • Input parameters: energy, unit, region
   • Output: Carbon emissions from electricity supply

2. travel (Travel)

   • Supported distance units: kilometers (km) and miles (mi)
   • Supported modes: car, bus, train
   • Input parameters: distance, unit, mode

3. emission - factor - search (Emission factor search)

   • Find activity IDs that match the given conditions

Prompts

The following prompts are provided to generate natural - language explanations:

1. Provide an overview of carbon emission calculations
2. Describe the sources of carbon emissions in detail
3. Offer suggestions for reducing carbon footprints

📦 Installation

Environment Variables

Set the following environment variable or specify the API key in the code:

CLIMATIQ_API_KEY=your_api_key_here

Installation Steps

Install this package using pip:

pip install climatiq-mcp-server

💻 Usage Examples

Basic Usage

Electricity Consumption Calculation

from climatiq_mcp_server import ElectricityTool

tool = ElectricityTool()
result = tool.invoke(
    energy=1000,
    unit='kWh',
    region='US'
)
print(result)

Travel Emission Calculation

from climatiq_mcp_server import TravelTool

tool = TravelTool()
result = tool.invoke(
    distance=100,
    unit='km',
    mode='car'
)
print(result)

⚠️ Other Notes

• All tools support asynchronous calls and timeout settings.
• Detailed error - handling logs are provided.
• Result caching is supported to improve performance.

📚 Documentation

For detailed documentation, please visit docs/README.md.

📄 License

This project is licensed under the MIT License. Please refer to the LICENSE file for specific details.