MCP server

MCP server

A remote Model Context Protocol server that lets Claude, ChatGPT, Cursor, and other MCP clients call CarbonDecode directly — so your assistant can grade a credit, screen the market, or assess a portfolio without leaving the chat. Authenticated with your API key; available on Pro.

Endpoint

https://mcp.carbondecode.com/

Streamable HTTP, stateless, JSON responses. Requests are POST-only (there's no server→client SSE stream); authenticate with the X-API-Key or Authorization: Bearer header.

Tools

search_projects(query?, project_type?, registry?, grade?, min_issued?, limit?)

Search and screen the ~11,300 rated projects. Returns scored summary rows (grade, composite score, flags).

queryFree-text on name / id / developer.
project_typee.g. REDD+, Cookstoves.
registryVCS · GOLD · CAR · ACR · ART.
gradeLetter grade AAA … D.
min_issuedMinimum credits issued.
limitMax rows (capped at 50).
get_project_score(project_id)

The full integrity scorecard for a project id (e.g. VCS902): letter grade, 0–100 composite, the six CCP-aligned dimensions with auditable rationale, flags, structural overrides, and any cached AI-analyst opinion + sources.

project_idRegistry id, e.g. VCS902 or GS1234.
score_portfolio(project_ids)

Score a list of project ids and return an aggregate risk summary: issuance-weighted mean score, count below investment grade, critical-flag count, and grade distribution.

project_idsArray of registry ids.
get_my_watchlist()

The authenticated key owner's saved CarbonDecode portfolio, with current scores and the same aggregate risk summary.

Connect a client

Replace cdk_live_… with one of your API keys.

Claude Desktop

Add to claude_desktop_config.json (Settings → Developer → Edit Config), then restart. Uses mcp-remote to attach the auth header.

claude_desktop_config.json
{
  "mcpServers": {
    "carbondecode": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.carbondecode.com/", "--header", "X-API-Key:${CARBONDECODE_KEY}"],
      "env": { "CARBONDECODE_KEY": "cdk_live_…" }
    }
  }
}

Cursor / VS Code

Clients that support remote MCP with custom headers can point at the URL directly — add to your mcp.json:

mcp.json
{
  "mcpServers": {
    "carbondecode": {
      "url": "https://mcp.carbondecode.com/",
      "headers": { "X-API-Key": "cdk_live_…" }
    }
  }
}

Claude.ai & ChatGPT (web)

Add a custom / remote connector pointing at the MCP URL above. If the connector UI doesn't let you set a custom header, run the mcp-remote bridge shown above and point the connector at it — it forwards your X-API-Key.

Raw (JSON-RPC)

List the tools with a direct call:

curl
curl -X POST "https://mcp.carbondecode.com/" \
  -H "X-API-Key: cdk_live_…" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Prefer plain HTTP? The same data is available through the Data API.