Skip to main content
Glama
samx-zh

CarbonLot

by samx-zh
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript

CarbonLot 🌍

An MCP-native compliance agent for the EU's Carbon Border Adjustment Mechanism (CBAM).

Since January 2026, Indian steel, aluminium, and other CBAM-covered exporters must report verified embedded carbon emissions per shipment to the EU — or get charged a punitive default rate. That data currently lives scattered across shipment records, supplier declarations, and emission-factor tables, making it slow and error-prone to check compliance manually.

CarbonLot fixes this by treating carbon like a traceability problem, not a spreadsheet problem. Ask it "is shipment SHP001 CBAM-ready?" and it looks up the shipment's supplier, checks whether they've reported verified emissions data, falls back transparently to EU default values when they haven't, calculates the total embedded emissions, and drafts a ready-to-use CBAM declaration — all through natural conversation via MCP.

Built for the Manufacturing & Industry 4.0 Track — MCP Hackathon 2026.

Tech Stack

  • NitroStack (MCP SDK + CLI)

  • TypeScript

  • Zod (schema validation)

  • MCP Resources, Tools

Related MCP server: customs-mcp-server

What It Does

  • 🔍 Validates CN codes — checks whether a shipment's product code falls within CBAM's regulatory scope

  • 📊 Looks up emission sources — checks if the shipment's supplier has reported verified emissions, or if EU default values apply

  • 🧮 Calculates embedded emissions — computes total CO₂e per shipment using verified supplier data where available

  • 🚩 Flags fallback cases transparently — shipments with unregistered/unreported suppliers are explicitly marked as needing review, not silently defaulted

  • 📄 Generates CBAM declarations — auto-drafts a structured compliance document per shipment, ready for export documentation

Project structure

src/
├── data/
│   ├── shipments.json        # Shipment records (CN code, quantity, supplier, origin)
│   ├── suppliers.json        # Supplier-reported emissions, pricing, delivery data
│   └── emission_factors.json # EU CBAM default emission factors by CN code
├── modules/
│   └── carbon/
│       ├── carbon.tools.ts     # validate_cn_code, lookup_emission_factor,
│       │                       # calculate_emissions, generate_declaration
│       ├── carbon.resources.ts # Exposes shipments/suppliers/emission-factors as MCP resources
│       └── carbon.module.ts    # Registers the carbon module
├── app.module.ts             # Root application module
└── index.ts

MCP Architecture

Resources (data the agent can read):

  • data://shipments — shipment records

  • data://suppliers — supplier-reported emissions data

  • data://emission-factors — CBAM default emission factors per CN code

Tools (actions the agent can perform):

  • validate_cn_code(shipmentId) — checks if a shipment's product falls under CBAM scope

  • lookup_emission_factor(shipmentId) — determines whether verified supplier data or EU defaults apply

  • calculate_emissions(shipmentId) — computes total embedded emissions (kg CO2e)

  • generate_declaration(shipmentId) — builds the final CBAM compliance declaration

Getting Started

npm install npm run dev

Then connect via NitroStudio or your preferred MCP client, and try asking:

"Is shipment SHP001 CBAM ready?"

Honest Note on Scope

The emissions and supplier dataset used here is a realistic, hand-modelled sample (not a live ERP/ ecosystem integration) — built to demonstrate the full compliance-agent workflow end-to-end within the hackathon timeframe. Emission factor values should be verified against official CBAM implementing regulation tables before any real-world use.

Team

Built for MCP Hackathon 2026 by:

  • N Samiksha

  • Krishna Jayakumar

  • Kashyap S

  • Muhanned Jasimkhan JL

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

  • NizhOAuth
    com.nizh

    Compliance frameworks (SOC 2, ISO 27001, CMMC, NIST, more) delivered to AI agents as MCP tools.

    SecurityLegal & Compliance
    1
    https://mcp.nizh.com/mcp
  • Agent Decision & Evidence Tools (MCP + x402)A
    io.github.PatrickPi1312

    40 MCP tools: multi-chain RPC, market and transaction decisions, AI, EU compliance and US imports

    FinanceLegal & Compliance
    411
    https://mcp.eucompliance.tools/mcp
  • UNE Maritime Decarbonization & Compliance GatewayA
    education.une.maritime

    **UNE Maritime Decarbonization & Compliance Gateway** is a production-grade, deterministic Model Context Protocol (MCP) server engineered for maritime shipping operators, charterers, compliance auditors, and AI agents managing EU environmental regulations. Strictly modeled on **Regulation (EU) 2023/1805 (FuelEU Maritime, Annexes I–IV)** and **Directive (EU) 2023/959 (EU ETS Maritime)**, the gateway guarantees audit-grade calculations with inter-process SHA-256 cryptographic state proofs. ### Core Capabilities & Statutory Tools (7) * **`lookup_fuel_wtw_emission_factor`**: Statutory Well-to-Wake (WtW), WtT, TtW, and LCV factors under FuelEU Maritime Annex II default tables (VLSFO, LNG, Biofuels, e-Methanol, e-Ammonia). * **`calculate_voyage_ghg_intensity`**: Multi-leg voyage GHG intensity solver adhering to FuelEU Annex I, enforcing Article 2 scope coverage (100% intra-EU, 50% extra-EU voyages) and UN/LOCODE port consistency. * **`calculate_fueleu_banking_borrowing`**: Article 20 deficit borrowing and surplus banking engine, verifying statutory 2% caps, consecutive-year constraints, and statutory 1.1× carbon penalty interest. * **`optimize_fueleu_pool_allocation`**: Article 21 compliance pooling optimizer solving fleet allocations to eliminate non-compliance penalties on China–Europe and global trade lanes. * **`calculate_fueleu_maritime_penalty`**: Statutory cash penalty calculation based on the Annex IV formula ($€2,400$/t VLSFO-eq reference rate with multi-year non-compliance escalators). * **`calculate_maritime_ets_surrender`**: EU ETS allowance (EUA) liability calculation implementing phased-in surrender obligations (40% in 2024, 70% in 2025, 100% in 2026+) and dynamic $N+1$ regulatory surrender deadlines (Sept 30). * **`provision_free_api_key`**: Developer provisioning engine delivering sandbox API keys for verifier XML manifests and BIMCO clause liability auditing. ### Key Highlights * **Cryptographic Determinism**: Every computation yields an immutable `result_hash` that remains constant across process restarts and environment redeployments. * **Ultra-low Latency**: Sub-millisecond execution times with zero external API dependencies for raw regulatory computations. * **Streamable HTTP Endpoint**: Publicly accessible via standard JSON-RPC 2.0 at `https://maritime.une.education/mcp.php`.

    Developer ToolsFinanceLegal & Compliance
    71
    https://maritime.une.education/mcp.php
  • Energy AT IT
    com.energyatit.app

    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.

    Cloud PlatformsAgent OrchestrationVirtualization
    2
    https://app.energyatit.com/mcp

Related MCP Servers

  • carbonstop-mcp by carbonstop-hub

    carbonstop-mcpofficial

    carbonstop-hub
    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
    13 npm
    MIT

  • customs-mcp-server

    yak33
    A
    license
    Not graded
    quality
    C
    maintenance
    Provides 14 customs and trade operations as MCP tools, enabling AI agents to query tariff, track declarations, screen dual-use items, and generate AI-powered declarations.
    29 npm
    2
    MIT

Appeared in Searches