@climeqai/mcp-server
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@climeqai/mcp-server Calculate Scope 1 and 2 emissions for our January electricity and fuel bills."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@climeqai/mcp-server — Official ClimeqAI & VALENQ Engine MCP Server
Official zero-dependency Model Context Protocol (MCP) stdio server connecting Claude Desktop, Cursor, Windsurf, VS Code GitHub Copilot, Google Antigravity, and custom AI agents directly to ClimeqAI — the Autonomous Sustainability Operating System powered by VALENQ Engine.
Website: https://climeqai.com
Live Platform (Free Core Tier): https://climeqai.com/signup
API & MCP Documentation: https://climeqai.com/docs?lang=en
OpenAPI 3.1 Schema:
schemas/openapi.json(https://app.climeqai.com/assets/api/openapi.json)Postman Collection v2.1:
schemas/climeqai.postman_collection.json(https://app.climeqai.com/assets/api/climeqai.postman_collection.json)
Key Capabilities
VALENQ Engine Autonomous Mapping (
v1): Map unstructured ERP invoice lines, utility bills, and Bill-of-Materials (BOM) items to verified scientific emission factors with confidence scoring, data quality indicators, and automated inflation adjustment.Global & Custom Private Datasets: Search global emission factor libraries or register tenant-isolated custom private emission factors.
Domain & Enterprise Carbon Calculators: Deterministic Scope 1, 2, and 3 calculations across electricity (location-based and market-based renewable certificates), fuels/biofuels, district heat/steam, multimodal freight, procurement spend, air travel, commuting, and cloud infrastructure (
AWS,Azure,GCP).Product Impact Studio (LCA) & Cross-Border Carbon Declarations: Model cradle-to-gate and cradle-to-grave Product Carbon Footprints (from BOMs or BOM-less AI screening) and estimate cross-border embedded carbon liabilities.
Blockchain Digital Product Passports (DPP Vault): Verify QR-linked, blockchain-sealed Digital Product Passports (
climeq_verify_dpp) without requiring an API key.
Related MCP server: carbonstop-mcp
Quick Start
Option A: Zero-Install Single-File Setup (Recommended)
Download the standalone zero-dependency .mjs executable directly:
mkdir -p ~/.climeqai
curl -fsSL https://app.climeqai.com/assets/api/climeqai-mcp-server.mjs \
-o ~/.climeqai/climeqai-mcp-server.mjsOption B: Clone from GitHub
git clone https://github.com/climeqai/mcp-server.git
cd mcp-server
node --test ./test/mcp-server.test.mjsGetting Your API Key
Sign in or create a free account at https://app.climeqai.com/signup (ClimeqAI Core includes 250 monthly API/MCP requests free — no credit card required).
Navigate to Security → API Keys in the left sidebar.
Generate an M2M API Key (
sust_<48_hex_characters>).
(Note: The climeq_verify_dpp tool queries public GS1 Digital Product Passports and works even without an API key.)
MCP Client Configuration
1. Claude Desktop (claude_desktop_config.json) & Cursor (.cursor/mcp.json)
{
"mcpServers": {
"climeqai": {
"command": "node",
"args": ["/Users/YOUR_USERNAME/.climeqai/climeqai-mcp-server.mjs"],
"env": {
"CLIMEQ_API_KEY": "sust_your_48_character_hex_api_key",
"CLIMEQ_BASE_URL": "https://app.climeqai.com",
"CLIMEQ_DATA_VERSION": "^2026.1"
}
}
}
}2. VS Code / GitHub Copilot (.vscode/mcp.json)
{
"servers": {
"climeqai": {
"type": "stdio",
"command": "node",
"args": ["/Users/YOUR_USERNAME/.climeqai/climeqai-mcp-server.mjs"],
"env": {
"CLIMEQ_API_KEY": "${input:climeqApiKey}",
"CLIMEQ_BASE_URL": "https://app.climeqai.com"
}
}
}
}3. Google Antigravity (~/.gemini/config/mcp_config.json)
{
"mcpServers": {
"climeqai": {
"command": "node",
"args": ["/Users/YOUR_USERNAME/.climeqai/climeqai-mcp-server.mjs"],
"env": {
"CLIMEQ_API_KEY": "sust_your_48_character_hex_api_key",
"CLIMEQ_BASE_URL": "https://app.climeqai.com",
"CLIMEQ_DATA_VERSION": "^2026.1"
}
}
}
}Environment Variables
Variable | Required | Default | Description |
| Yes (except | — | M2M API Key ( |
| No |
| Target ClimeqAI API base URL |
| No |
| Default emission factor catalog version selector |
| No |
| HTTP request timeout in milliseconds |
Included MCP Tools (23 Tools)
Category | MCP Tool Name | REST Endpoint | Description |
Catalog & Discovery |
|
| Search global datasets and tenant-owned private factors |
Catalog & Discovery |
|
| List physical unit families & supported ISO 4217 currencies |
Catalog & Discovery |
|
| List ISO countries, zones & hierarchical geographic fallback chains |
Catalog & Discovery |
|
| List catalog release versions, factor counts & changelogs |
Private Factors |
|
| List tenant-private supplier EPD / primary factors |
Private Factors |
|
| Register a tenant-isolated supplier EPD factor |
VALENQ Engine v1 |
|
| Rank candidate factors with PACT |
VALENQ Engine v1 |
|
| Autonomous mapping + compound CPI ( |
VALENQ Engine v1 |
|
| Batch AI mapping & calculation for up to 100 ERP/BOM items |
VALENQ Engine v1 |
|
| Calculate from |
Core Ledger |
|
| Deterministic selector, custom rules, |
Energy |
|
| Scope 2 Location + AIB Residual Mix ( |
Energy |
|
| Scope 1 fuels, biofuel blends ( |
Energy |
|
| Scope 2 district heating, steam, cooling & distribution thermal losses |
Logistics & Spend |
|
| ISO 14083 / GLEC v3.2 multimodal freight & transshipment hubs |
Logistics & Spend |
|
| EXIOBASE Basic Price margin stripping + IMF WEO CPI deflation |
Travel & Commuting |
|
| IATA Great-Circle air travel with separate ISO 14083 |
Travel & Commuting |
|
| Scope 3.7 employee commuting & teleworking home electricity |
Product & Enterprise |
|
| ISO 14067 / WBCSD PACT BOM-based Product Carbon Footprint |
Product & Enterprise |
|
| AI BOM-less Product Carbon Footprint screening |
Product & Enterprise |
|
| EU CBAM ( |
Product & Enterprise |
|
| AWS, Azure & GCP operational + hardware embodied carbon |
GS1 / W3C DPP |
|
| Public GS1 Digital Link ( |
Example Prompts for Your AI Assistant
ERP Spend Batch Audit:
"Run these 15 SAP purchase order lines through
climeq_valenq_estimate_batchfor spend year 2026, highlight any lines withqualityLabel: reviewornotices, and summarize total tCO2e."EU CBAM Import Liability:
"Use
climeq_estimate_cbam_liabilityto compute the 2026 net payable CBAM certificate cost in EUR for 250 metric tons of hot-rolled steel coils (CN 7208) imported fromTR."Product Carbon Footprint (LCA) Screening:
"Use
climeq_screen_pcf_aito estimate the Cradle-to-Gate carbon footprint of a 1.45 kg enterprise aluminum laptop manufactured inTWand air-freighted toDE."Multimodal Freight Footprint:
"Calculate the well-to-wheel (
WTW) emissions for shipping 18 tons of machinery from Istanbul (TR) to Hamburg (DE) via road + container ship usingclimeq_calculate_intermodal_freight."
OpenAPI 3.1 & Client SDK Generation
This repository also includes the official OpenAPI 3.1 specification (schemas/openapi.json) and Postman Collection (schemas/climeqai.postman_collection.json):
# Generate TypeScript (Fetch) Client SDK
npx @openapitools/openapi-generator-cli generate \
-i ./schemas/openapi.json \
-g typescript-fetch \
-o ./sdk/typescript
# Generate Python (Pydantic v2) Client SDK
npx @openapitools/openapi-generator-cli generate \
-i ./schemas/openapi.json \
-g python \
-o ./sdk/pythonLicense
Licensed under the Apache License, Version 2.0. Copyright © 2026 ClimeqAI (https://climeqai.com).
Available Tools
23 toolsclimeq_calculate_air_travelA
Calculate Scope 3.6 business flight emissions from IATA airport codes with cabin class multipliers and separate ISO 14083 Radiative Forcing disclosure.
Inputs: origin (required), destination (required), persist, roundTrip, +3 more.
climeq_calculate_cloud_carbonB
Calculate AWS, Azure, or GCP cloud workload operational (PUE-adjusted) and Scope 3 hardware embodied carbon emissions.
Inputs: region (required), provider (required), persist, vcpuHours, +5 more.
climeq_calculate_commutingC
Calculate Scope 3 Category 7 annual employee commuting and teleworking (work-from-home) electricity emissions.
Inputs: employeesCount (required), oneWayCommuteDistanceKm (required), persist, travelMode, +5 more.
climeq_calculate_electricityB
Calculate GHG Protocol Scope 2 dual reporting (Location-Based + AIB Residual Mix Market-Based with GO/IREC/YEK-G/PPA certificates) and Scope 3 Category 3 FERA (WTT + T&D losses).
Inputs: amount (required), countryOrGridZone (required), unit, year, +5 more.
climeq_calculate_emissionB
Core ClimeqAI GHG calculation engine supporting deterministic emissionFactorId/activityCode, strict regionFallback/yearFallback, custom tenant rules, optional ledger persistence (persist), and SHA-256 anchorToBlockchain.
Inputs: unit (required), amount (required), year, scope, +11 more.
climeq_calculate_fuelB
Calculate Scope 1 direct combustion (TTW), biofuel blends (B5-B100, E5-E100, HVO100, SAF), hydrogen conversions, out-of-scope biogenic CO2, and Scope 3.3 upstream WTT.
Inputs: amount (required), fuelType (required), unit, region, +1 more.
climeq_calculate_heat_steamB
Calculate Scope 2 purchased district heating, steam, hot water, or cooling emissions plus distribution thermal losses and Scope 3.3 FERA.
Inputs: amount (required), unit, region, persist, +3 more.
climeq_calculate_intermodal_freightC
Calculate ISO 14083 / GLEC v3.2 multimodal freight emissions across Road, Sea, Air, and Rail legs, transshipment hubs, and refrigerated cargo.
Inputs: hubs, legs, persist, originCity, +7 more.
climeq_calculate_pcfB
Calculate ISO 14067 / WBCSD PACT Product Carbon Footprint (Cradle-to-Gate or Cradle-to-Grave) from a Bill of Materials (BOM), scrap rates, recycled content, and manufacturing energy.
Inputs: components (required), productName (required), boundaryType, manufacturing, +4 more.
climeq_calculate_procurement_spendC
Calculate Scope 3 Category 1 spend-based emissions using EXIOBASE Basic Price margin stripping and IMF WEO CPI inflation adjustment.
Inputs: amount (required), category (required), currency (required), persist, +2 more.
climeq_create_private_factorC
Create a tenant-isolated private emission factor (e.g., verified supplier EPD) usable immediately in calculations and VALENQ Engine (accessType: 'private').
Inputs: name (required), unit (required), co2eTotal (required), activityId (required), +7 more.
climeq_estimate_by_classificationB
Calculate physical or spend-based GHG emissions from standard industry/customs taxonomy codes (UNSPSC, NAICS, ISIC, NACE, MCC, HS_CODE).
Inputs: amount (required), unitOrCurrency (required), classificationCode (required), classificationType (required), +3 more.
climeq_estimate_cbam_liabilityARead-onlyIdempotent
Calculate EU CBAM (Regulation 2023/956) embedded direct/indirect/precursor emissions by CN code, 2026-2034 free allocation phase-out deduction, and net payable CBAM certificate cost in EUR.
Inputs: cnCode (required), originCountry (required), netMassTons, reportingYear, +6 more.
climeq_list_data_versionsARead-onlyIdempotent
List ClimeqAI emission factor catalog releases, release statistics, datasets, and markdown changelogs.
Inputs: no named parameters.
climeq_list_private_factorsBRead-onlyIdempotent
List supplier-specific EPD or primary emission factors owned by the authenticated organization.
Inputs: page, pageSize.
climeq_list_regionsARead-onlyIdempotent
Discover canonical ISO-3166 country codes, continental/sub-national zones, and hierarchical geographic fallback chains.
Inputs: search.
climeq_list_unit_typesARead-onlyIdempotent
List all physical unit families (Energy, Weight, Volume, Distance, WeightOverDistance, PassengerOverDistance, Area, Number, Time) and supported ISO 4217 currencies accepted by ClimeqAI.
Inputs: no named parameters.
climeq_screen_pcf_aiARead-onlyIdempotent
AI BOM-less Product Carbon Footprint screening: Estimate product mass composition and Cradle-to-Gate CO2e when no Bill of Materials is available.
Inputs: productName (required), totalWeightKg, transportMode, hsOrUnspscCode, +3 more.
climeq_search_factorsBRead-onlyIdempotent
Search ClimeqAI governed global emission factor datasets and organization-owned private factors with optional filters for region, year, category, source, unitType, and dataVersion.
Inputs: page, year, query, region, +5 more.
climeq_valenq_estimateC
VALENQ Engine Mapping Agent v1 (estimate): Autonomously map unstructured text to the best emission factor and calculate CO2e emissions, applying currency-aligned compound CPI deflation (applyInflationAdjustment) for monetary inputs and returning PACT DQI, uncertaintyRangeKg, top1Explanation, and notices[].
Inputs: text (required), unit (required), amount (required), year, +11 more.
climeq_valenq_estimate_batchBRead-onlyIdempotent
VALENQ Engine Batch Mapping & Estimation: Autonomously map and calculate GHG emissions for up to 100 unstructured ERP/BOM line items in a single request.
Inputs: items (required), dataVersion, includeOpenLcaPackage.
climeq_valenq_suggestARead-onlyIdempotent
VALENQ Engine Mapping Agent v1 (suggest): Rank candidate emission factors for unstructured invoice, ERP, or BOM descriptions without calculating emissions. Supports source/excludeSource, accessType ('public'|'private'|'all'), regionFallback, effort ('low'|'fast'|'high'|'thorough'), explainResults, PACT DQI, and structured notices[].
Inputs: text (required), unit, year, limit, +12 more.
climeq_verify_dppARead-onlyIdempotent
Publicly resolve an EU ESPR Digital Product Passport via GS1 Digital Link (gtin + serial) or passport uid without requiring an API key.
Inputs: uid, gtin, serial.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 23 tools
Most tools target a distinct scope/input type (electricity, fuel, freight, air travel, spend, PCF, CBAM, cloud), so an agent can generally pick correctly. The main gray zones are the generic climeq_calculate_emission vs climeq_valenq_estimate vs climeq_estimate_by_classification, and climeq_calculate_pcf vs climeq_screen_pcf_ai, where the boundary depends on input format rather than purpose.
All tools share a climeq_ prefix and snake_case with a predictable verb_noun shape (list_regions, calculate_fuel, verify_dpp), which is easy to parse. Minor deviation: the valenq_* trio uses a product namespace instead of a verb, and 'screen' vs 'calculate' vs 'estimate' are semantically close.
23 tools is on the heavy side, but the domain is genuinely broad (GHG Protocol scopes 1/2/3, PCF, CBAM, cloud, DPP) and each calculation tool covers a distinct methodology. Nothing looks like filler, though a couple of the general-purpose estimation tools could be folded into the core calculate tool.
Read paths for reference data and a wide set of calculation verbs are covered, but the private-factor lifecycle is create+list only with no update/delete, and there is no visible way to read back persisted calculations or ledger entries that climeq_calculate_emission writes. These are notable gaps that would force agents into dead ends for maintenance and reporting workflows.
Maintenance
Related MCP Connectors
Protocol-native energy infrastructure orchestration for AI data centers. Provides 46 MCP tools across 8 grid protocols (IEC-61850, DNP3, Modbus, OCPP, OpenADR, IEEE 2030.5, IEC 60870-5-104, ICCP) with 5 core API primitives: connect, dispatch, settle, comply, and intel. Enables AI agents to programmatically interact with substations, grid interfaces, and energy assets for real-time workload-grid coordination.
Pay-per-use tool marketplace for AI agents. Search, price-check, and call APIs via MCP.
10,000+ source-verified compliance nodes, 39 pillars, 25 MCP tools (EU AI Act, GDPR, NIST, MITRE).
The OpenRouter for tools. One MCP connection gives any AI agent 254 hosted tools, pay per call.
Related MCP Servers
FlicenseNot gradedqualityBmaintenanceEnables AI assistants to automatically call Carbonstop Cloud API for carbon footprint modeling, product query, and emission analysis through natural language.-
carbonstop-mcpofficial
AlicenseBqualityDmaintenanceMCP server enabling AI assistants to automatically perform carbon footprint modeling, product queries, and emission analysis via the Carbonstop Cloud API.810 npmMIT- AlicenseCqualityDmaintenance27 deterministic engineering compliance and calculation tools for the built environment (data-centre PUE and EED, EPBD, NIS2, Eurocode, UAE compliance), callable by AI agents via MCP and REST API. Free tier; every result cites the governing standard.27MIT
- AlicenseAqualityFmaintenanceProvides 14 MCP tools for AI agent infrastructure, enabling knowledge base queries, skill search, handoffs, blueprint validation, trust scoring, identity verification, SLA validation, and compliance checks.22MIT