How do I use carbonstop-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@carbonstop-mcp model the carbon footprint of my new running shoe" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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:

Platform	File
macOS Apple Silicon	`carbonstop-mcp_*_darwin_arm64.tar.gz`
macOS Intel	`carbonstop-mcp_*_darwin_x86_64.tar.gz`
Linux x86_64	`carbonstop-mcp_*_linux_x86_64.tar.gz`
Linux arm64	`carbonstop-mcp_*_linux_arm64.tar.gz`
Windows x86_64	`carbonstop-mcp_*_windows_x86_64.zip`

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

Log in to the Carbon Cloud Platform to register an account and create an API Key (PAT).
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

Tool	Description
`ping`	Gateway health check
`whoami`	View identity information
`products`	Product list (supports pagination, search)
`product_info`	Product details
`accounts`	Product accounting list
`account_view`	Accounting details (including emissions at each stage of the life cycle)
`ai_model`	One-click AI carbon footprint modeling