Skip to main content
Glama
@climeqai/mcp-server

@climeqai/mcp-server

Official
by climeqai

@climeqai/mcp-server — Official ClimeqAI & VALENQ Engine MCP Server

MCP Protocol Version Node.js Zero Dependencies License

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.


Key Capabilities

  1. 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.

  2. Global & Custom Private Datasets: Search global emission factor libraries or register tenant-isolated custom private emission factors.

  3. 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).

  4. 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.

  5. 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

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.mjs

Option B: Clone from GitHub

git clone https://github.com/climeqai/mcp-server.git
cd mcp-server
node --test ./test/mcp-server.test.mjs

Getting Your API Key

  1. 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).

  2. Navigate to Security → API Keys in the left sidebar.

  3. 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

CLIMEQ_API_KEY

Yes (except climeq_verify_dpp)

—

M2M API Key (sust_<48_hex>) created in Security → API Keys

CLIMEQ_BASE_URL

No

https://app.climeqai.com

Target ClimeqAI API base URL

CLIMEQ_DATA_VERSION

No

^2026.1

Default emission factor catalog version selector

CLIMEQ_TIMEOUT_MS

No

30000

HTTP request timeout in milliseconds


Included MCP Tools (23 Tools)

Category

MCP Tool Name

REST Endpoint

Description

Catalog & Discovery

climeq_search_factors

GET /data/search

Search global datasets and tenant-owned private factors

Catalog & Discovery

climeq_list_unit_types

GET /data/unit-types

List physical unit families & supported ISO 4217 currencies

Catalog & Discovery

climeq_list_regions

GET /data/regions

List ISO countries, zones & hierarchical geographic fallback chains

Catalog & Discovery

climeq_list_data_versions

GET /data/versions

List catalog release versions, factor counts & changelogs

Private Factors

climeq_list_private_factors

GET /private-factors

List tenant-private supplier EPD / primary factors

Private Factors

climeq_create_private_factor

POST /private-factors

Register a tenant-isolated supplier EPD factor

VALENQ Engine v1

climeq_valenq_suggest

POST /mapping-agent/suggest

Rank candidate factors with PACT dqi, top1Explanation & notices[]

VALENQ Engine v1

climeq_valenq_estimate

POST /mapping-agent/estimate

Autonomous mapping + compound CPI (applyInflationAdjustment) estimation

VALENQ Engine v1

climeq_valenq_estimate_batch

POST /mapping-agent/estimate/batch

Batch AI mapping & calculation for up to 100 ERP/BOM items

VALENQ Engine v1

climeq_estimate_by_classification

POST /classifications/estimate

Calculate from UNSPSC, NAICS, ISIC, NACE, MCC, HS_CODE

Core Ledger

climeq_calculate_emission

POST /emissions/calculate

Deterministic selector, custom rules, persist & SHA-256 blockchain proof

Energy

climeq_calculate_electricity

POST /energy/electricity

Scope 2 Location + AIB Residual Mix (YEK-G/I-REC/GO) + Scope 3.3 FERA

Energy

climeq_calculate_fuel

POST /energy/fuel

Scope 1 fuels, biofuel blends (B7, HVO100, SAF) & H2

Energy

climeq_calculate_heat_steam

POST /energy/heat

Scope 2 district heating, steam, cooling & distribution thermal losses

Logistics & Spend

climeq_calculate_intermodal_freight

POST /freight/intermodal

ISO 14083 / GLEC v3.2 multimodal freight & transshipment hubs

Logistics & Spend

climeq_calculate_procurement_spend

POST /procurement/spend

EXIOBASE Basic Price margin stripping + IMF WEO CPI deflation

Travel & Commuting

climeq_calculate_air_travel

POST /travel/air

IATA Great-Circle air travel with separate ISO 14083 RFI disclosure

Travel & Commuting

climeq_calculate_commuting

POST /travel/commuting

Scope 3.7 employee commuting & teleworking home electricity

Product & Enterprise

climeq_calculate_pcf

POST /pcf/estimate

ISO 14067 / WBCSD PACT BOM-based Product Carbon Footprint

Product & Enterprise

climeq_screen_pcf_ai

POST /pcf/screen

AI BOM-less Product Carbon Footprint screening

Product & Enterprise

climeq_estimate_cbam_liability

POST /cbam/estimate

EU CBAM (2023/956) embedded emissions & net EUR certificate liability

Product & Enterprise

climeq_calculate_cloud_carbon

POST /cloud/calculate

AWS, Azure & GCP operational + hardware embodied carbon

GS1 / W3C DPP

climeq_verify_dpp

GET /api/public/dpp/*

Public GS1 Digital Link (gtin + serial) Digital Product Passport resolver


Example Prompts for Your AI Assistant

  • ERP Spend Batch Audit:

    "Run these 15 SAP purchase order lines through climeq_valenq_estimate_batch for spend year 2026, highlight any lines with qualityLabel: review or notices, and summarize total tCO2e."

  • EU CBAM Import Liability:

    "Use climeq_estimate_cbam_liability to compute the 2026 net payable CBAM certificate cost in EUR for 250 metric tons of hot-rolled steel coils (CN 7208) imported from TR."

  • Product Carbon Footprint (LCA) Screening:

    "Use climeq_screen_pcf_ai to estimate the Cradle-to-Gate carbon footprint of a 1.45 kg enterprise aluminum laptop manufactured in TW and air-freighted to DE."

  • 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 using climeq_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/python

License

Licensed under the Apache License, Version 2.0. Copyright © 2026 ClimeqAI (https://climeqai.com).

Available Tools

23 tools
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.

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_liabilityA
Read-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_versionsA
Read-onlyIdempotent

List ClimeqAI emission factor catalog releases, release statistics, datasets, and markdown changelogs.

Inputs: no named parameters.

climeq_list_private_factorsB
Read-onlyIdempotent

List supplier-specific EPD or primary emission factors owned by the authenticated organization.

Inputs: page, pageSize.

climeq_list_regionsA
Read-onlyIdempotent

Discover canonical ISO-3166 country codes, continental/sub-national zones, and hierarchical geographic fallback chains.

Inputs: search.

climeq_list_unit_typesA
Read-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_aiA
Read-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_factorsB
Read-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_batchB
Read-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_suggestA
Read-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_dppA
Read-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

    B3.3/5.0

    Scored across 23 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness3/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      MCP server enabling AI assistants to automatically perform carbon footprint modeling, product queries, and emission analysis via the Carbonstop Cloud API.
      8
      10 npm
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      27 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.
      27
      MIT