@climeqai/mcp-server
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CLIMEQ_API_KEY | Yes | M2M API Key (sust_<48_hex>) created in Security → API Keys. Required for all tools except climeq_verify_dpp. | |
| CLIMEQ_BASE_URL | No | Target ClimeqAI API base URL. | https://app.climeqai.com |
| CLIMEQ_TIMEOUT_MS | No | HTTP request timeout in milliseconds. | 30000 |
| CLIMEQ_DATA_VERSION | No | Default emission factor catalog version selector. | ^2026.1 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
ClimeqAI & VALENQ Engine Carbon Intelligence MCP Server. Use climeq_valenq_* for unstructured ERP/BOM mapping, climeq_calculate_* for GHG Protocol Scope 1/2/3 & ISO 14067/14083 calculations, climeq_estimate_cbam_liability for EU CBAM Regulation 2023/956, and climeq_verify_dpp for GS1 Digital Product Passports.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| climeq_search_factorsB | Search ClimeqAI governed global emission factor datasets and organization-owned private factors with optional filters for region, year, category, source, unitType, and dataVersion. |
| climeq_list_unit_typesA | List all physical unit families (Energy, Weight, Volume, Distance, WeightOverDistance, PassengerOverDistance, Area, Number, Time) and supported ISO 4217 currencies accepted by ClimeqAI. |
| climeq_list_regionsA | Discover canonical ISO-3166 country codes, continental/sub-national zones, and hierarchical geographic fallback chains. |
| climeq_list_data_versionsA | List ClimeqAI emission factor catalog releases, release statistics, datasets, and markdown changelogs. |
| climeq_list_private_factorsB | List supplier-specific EPD or primary emission factors owned by the authenticated organization. |
| climeq_create_private_factorC | Create a tenant-isolated private emission factor (e.g., verified supplier EPD) usable immediately in calculations and VALENQ Engine ( |
| climeq_valenq_suggestA | VALENQ Engine Mapping Agent v1 ( |
| climeq_valenq_estimateC | VALENQ Engine Mapping Agent v1 ( |
| climeq_valenq_estimate_batchB | VALENQ Engine Batch Mapping & Estimation: Autonomously map and calculate GHG emissions for up to 100 unstructured ERP/BOM line items in a single request. |
| climeq_estimate_by_classificationB | Calculate physical or spend-based GHG emissions from standard industry/customs taxonomy codes (UNSPSC, NAICS, ISIC, NACE, MCC, HS_CODE). |
| climeq_calculate_emissionB | Core ClimeqAI GHG calculation engine supporting deterministic emissionFactorId/activityCode, strict regionFallback/yearFallback, custom tenant rules, optional ledger persistence ( |
| 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). |
| 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. |
| 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. |
| 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. |
| climeq_calculate_procurement_spendC | Calculate Scope 3 Category 1 spend-based emissions using EXIOBASE Basic Price margin stripping and IMF WEO CPI inflation adjustment. |
| climeq_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. |
| climeq_calculate_commutingC | Calculate Scope 3 Category 7 annual employee commuting and teleworking (work-from-home) electricity emissions. |
| 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. |
| climeq_screen_pcf_aiA | AI BOM-less Product Carbon Footprint screening: Estimate product mass composition and Cradle-to-Gate CO2e when no Bill of Materials is available. |
| climeq_estimate_cbam_liabilityA | 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. |
| climeq_calculate_cloud_carbonB | Calculate AWS, Azure, or GCP cloud workload operational (PUE-adjusted) and Scope 3 hardware embodied carbon emissions. |
| climeq_verify_dppA | Publicly resolve an EU ESPR Digital Product Passport via GS1 Digital Link ( |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| audit-erp-spend-batch | Map and calculate Scope 3 emissions for a batch of unstructured ERP purchase order lines using VALENQ Engine. |
| cbam-import-liability-check | Estimate EU CBAM (Regulation 2023/956) embedded emissions and EUR certificate cost for imported goods. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| ClimeqAI & VALENQ Engine M2M API Architecture Overview | |
| ClimeqAI API Key Scopes & Deterministic Error Codes |
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.