carbonstop-mcp

MCP (Model Context Protocol) server for Carbonstop — Carbonstop carbon footprint accounting MCP service.

Automatically call Carbon Cloud API during AI conversations to complete carbon footprint modeling, product queries, and accounting analysis.

Install

npx (recommended)

No install needed. Use directly in MCP config or terminal:

npx @carbonstopper/mcp --api-key csk_xxx.yyy

npm

npm install -g @carbonstopper/mcp

Download binary

Download the latest binary from Releases:

curl -L https://github.com/carbonstop-hub/carbonstop-mcp/releases/latest/download/carbonstop-mcp_linux_x86_64.tar.gz | tar xz
sudo mv carbonstop-mcp /usr/local/bin/

Build from source

Requires Go 1.23+.

git clone https://github.com/carbonstop-hub/carbonstop-mcp.git
cd carbonstop-mcp
make build

Quick Start

1. Log in to the Carbon Cloud Platform to register an account and create an API Key (PAT).

2. Start:

export CARBONSTOP_API_KEY="csk_xxx.yyy"
./carbonstop-mcp
# 或
npx @carbonstopper/mcp --api-key csk_xxx.yyy

The official version has the gateway address built-in. For self-compiled versions, you need to set CARBONSTOP_BASE_URL.

Agent Configuration

npx (zero-install, recommended)

{
  "mcpServers": {
    "carbonstop": {
      "command": "npx",
      "args": ["@carbonstopper/mcp", "--api-key", "csk_xxx.yyy"]
    }
  }
}

Global installation

{
  "mcpServers": {
    "carbonstop": {
      "command": "carbonstop-mcp",
      "args": ["--api-key", "csk_xxx.yyy"]
    }
  }
}

Direct binary path

{
  "mcpServers": {
    "carbonstop": {
      "command": "/usr/local/bin/carbonstop-mcp",
      "args": ["--api-key", "csk_xxx.yyy"]
    }
  }
}

MCP client configuration formats for Claude Code, Cursor, Windsurf, Codex, Hermes, etc., are the same.

Available Tools

Security

• Gateway address is injected during build and is not visible in the source code.

• API Key is passed via the --api-key parameter or environment variable.

Related

• carbonstop-cli — Command line tool

License

MIT