--- title: Climatiq MCP TypeScript Interface emoji: 🌍 colorFrom: green colorTo: blue sdk: docker app_port: 7860 pinned: false license: mit ---
🌍 Climatiq MCP TypeScript Interface
A TypeScript-based Model Context Protocol (MCP) server with web interface for calculating CO2 emissions using the Climatiq API.
🚀 Features
- 🔍 Search Emission Factors: Find emission factors by keyword, region, and category
- 🧮 Calculate Emissions: Calculate CO2 emissions using specific emission factors
- 🌍 Multi-region Support: Support for global emission factors (FR, DE---
title: Climatiq MCP Interface emoji: 🌍 colorFrom: green colorTo: blue sdk: gradio sdk_version: 4.44.0 app_file: app.py pinned: false license: mit ---
🌍 Climatiq MCP Interface
A Gradio-based web interface to test the Climatiq MCP (Model Context Protocol) server functionality for calculating CO2 emissions.
🚀 Features
- 🔍 Search Emission Factors: Find emission factors by keyword, region, and category
- 🧮 Calculate Emissions: Calculate CO2 emissions using specific emission factors
- 🌍 Multi-region Support: Support for global emission factors (FR, DE, US, etc.)
- 📊 Interactive Results: View detailed emission breakdowns and factor information
- ⚡ Quick Examples: Pre-configured examples for common use cases
🛠️ How to Use
1. Configure API Key
This Space requires a Climatiq API key. To set it up:
- Go to Climatiq.io and create an account
- Get your API key from the dashboard
- In this Space's Settings → Repository secrets, add:
- Name:
CLIMATIQ_API_KEY - Value: Your Climatiq API key
2. Search for Emission Factors
- Enter search terms like "electricity", "concrete", "transport"
- Filter by region (FR, DE, US, etc.) and category
- Browse the results table to find appropriate emission factors
3. Calculate Emissions
- Copy the Activity ID from search results
- Enter your activity data (amount, unit, unit type)
- Specify the region if needed
- Click "Calculate Emissions" to get CO2eq results
📋 Example Use Cases
Electricity Emissions
Search: "electricity france"
Activity ID: electricity-supply_grid-source_production_mix
Amount: 100 kWh (Energy) - Region: FR
Result: ~3-6 kg CO2eq (low carbon due to nuclear)Natural Gas Emissions
Search: "natural gas industrial"
Activity ID: fuel-type_natural_gas-fuel_use_industrial
Amount: 10 m³ (Volume) - Region: CA
Result: ~20 kg CO2eqTransport Emissions
Search: "truck transport"
Select appropriate truck type from results
Amount: 100 km (Distance)
Result: Varies by vehicle type and load🔧 Technical Details
This interface connects to the Climatiq API to:
- Search their database of 100,000+ emission factors
- Calculate accurate CO2 equivalent emissions
- Support various unit types (Energy, Weight, Volume, Distance, Number)
- Provide detailed emission breakdowns (CO2, CH4, N2O)
📚 About Climatiq MCP
This interface demonstrates the capabilities of a Model Context Protocol (MCP) server for Climatiq, which can be integrated with AI assistants like Claude to provide real-time emission calculations in conversations.
🔗 Links
📄 License
MIT License - Feel free to use and modify for your sustainability projects!
