@autocbam/mcp — AutoCBAM Model Context Protocol server

Expose AutoCBAM's CBAM calculator, CN-code registry, EU ETS price, accredited-verifier registry, and Omnibus 2025/2083 de minimis logic to any MCP-supporting LLM client — Claude Desktop, Cursor, Cline, Continue, VS Code agents.

Status: v0.1 — calculator-only, public read-only surface, no auth. Multi-tenant production MCP (per-org writes via OAuth 2.1) ships in a separate package once the AutoCBAM backend ships §5.4 / §5.5 / §5.8 / §5.9 — see docs/PRD-MCP-SERVER.md §0.2 and docs/PRD-IMPL-* for the roadmap.

What it does

Five tools and one resource:

| Tool | What it does | |----------------------------|---------------------------------------------------------------------------------------------------------------| | cbam_cn_check | Determine if a Combined Nomenclature code is in CBAM scope and which sector it maps to (iron and steel / aluminium / cement / fertilisers / hydrogen / electricity). | | cbam_calculator | Compute embedded emissions + certificate cost (low / mid / high) for a shipment, with Annex IV provenance. | | cbam_ets_price | Current EU ETS allowance spot price (€/tCO₂). | | cbam_verifier_lookup | Validate a single CBAM verifier accreditation ID against the AutoCBAM registry (exact-ID lookup, not free-text search). | | cbam_de_minimis_check | Return the 50-tonne cumulative-annual threshold from Reg (EU) 2025/2083 Art. 2 and force the caller to disambiguate single-shipment vs YTD mass. |

| Resource | Description | |-------------------------------------------|----------------------------------------------------------------------------------------------| | cbam://regulations/omnibus-2025-2083 | Plain-text summary of Regulation (EU) 2025/2083 ("Omnibus simplification") and how it amends CBAM Regulation (EU) 2023/956. |

All tools call the public https://autocbam.com/api/* endpoints; no authentication required.

Install

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "autocbam": {
      "command": "npx",
      "args": ["-y", "@autocbam/mcp@latest"]
    }
  }
}

Restart Claude Desktop. Then ask: «What is my CBAM liability for 500 tonnes of CN 72104900 steel from India in compliance year 2026?»

Cursor

~/.cursor/mcp.json (or per-workspace .cursor/mcp.json):

{
  "mcpServers": {
    "autocbam": {
      "command": "npx",
      "args": ["-y", "@autocbam/mcp@latest"]
    }
  }
}

Cline / Continue / VS Code MCP-supporting agents

Use the same command + args pair. Refer to your client's MCP config docs.

Develop

# from /Users/pedro/autocbam/autocbam/mcp/
pnpm install

# run locally with tsx
pnpm dev

# inspect with the official MCP Inspector
pnpm inspect

# vitest (live integration against autocbam.com)
pnpm test

# build for npm publish
pnpm build

Set AUTOCBAM_BASE_URL=https://staging.autocbam.com to point tests / dev at staging.

Environment

| Variable | Default | Purpose | |-------------------------|------------------------------|---------------------------------------------------------------------------------| | AUTOCBAM_BASE_URL | https://autocbam.com | Base URL the MCP tools call. | | AUTOCBAM_TEST_BASE_URL| https://autocbam.com | Same purpose, but read by the vitest suite only. |

License

MIT — see LICENSE.

Maintained by Agonist Development AB (Stockholm). Reach out: [email protected].