# CommerceBook MCP server

Search and buy products from sellers and verified warehouses, sell surplus stock, post requests.

## At a glance

CommerceBook is an MCP server in the Web & Search category. It is hosted remotely and connects over HTTP, and needs Authorization. It exposes 6 tools, including commercebook_start, commercebook_market and commercebook_capabilities. It scores B (76/100) on the MCP Skills Hub health score as of Oct 28, 2026.

## Install

### How to install CommerceBook in Claude Code

1. Add the server

```bash
claude mcp add --transport http commercebook https://commercebook.ai/mcp --header 'Authorization: Bearer <YOUR_TOKEN>'
```

2. Fill in your credentials

   Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.

3. Verify it's connected

```bash
claude mcp list
```

4. Sharing it with your team?

   Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).

5. Use it in a session

   Ask Claude to use the tools this server exposes (e.g. commercebook_start, commercebook_market, commercebook_capabilities). It discovers them automatically.

### How to install CommerceBook in Claude Desktop

1. Open your MCP config

   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add this server

```json
{
  "mcpServers": {
    "commercebook": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://commercebook.ai/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}
```

3. Fill in your credentials

   Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.

4. Why the wrapper?

   This is a remote (HTTP) server and Claude Desktop only launches local processes, so mcp-remote proxies the connection. It will open a browser window if the server needs OAuth.

5. Restart Claude Desktop

   The tools appear under the 🔌 menu once the app reloads.

### How to install CommerceBook in Cursor

1. Create / edit .cursor/mcp.json in your project

```json
{
  "mcpServers": {
    "commercebook": {
      "url": "https://commercebook.ai/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}
```

2. Fill in your credentials

   Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.

3. Enable it

   Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.

### How to install CommerceBook in Codex CLI

1. Add to ~/.codex/config.toml

```toml
[mcp_servers.commercebook]
command = "npx"
args = ["-y", "mcp-remote", "https://commercebook.ai/mcp", "--header", "Authorization:${AUTH_HEADER}"]
env = { AUTH_HEADER = "Bearer <YOUR_TOKEN>" }
```

2. Fill in your credentials

   Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.

3. Why the wrapper?

   Codex runs MCP servers as local processes, so mcp-remote bridges this HTTP endpoint to stdio.

4. Run Codex

   Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.

### How to install CommerceBook in Windsurf

1. Edit ~/.codeium/windsurf/mcp_config.json

```json
{
  "mcpServers": {
    "commercebook": {
      "serverUrl": "https://commercebook.ai/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}
```

2. Fill in your credentials

   Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.

3. Reload

   Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.

### How to install CommerceBook in Cline

1. Open Cline → MCP Servers → Configure

   Adds to cline_mcp_settings.json.

2. Add the server

```json
{
  "mcpServers": {
    "commercebook": {
      "type": "streamableHttp",
      "url": "https://commercebook.ai/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}
```

3. Fill in your credentials

   Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.

### How to install CommerceBook in VS Code

1. Create .vscode/mcp.json

```json
{
  "servers": {
    "commercebook": {
      "type": "http",
      "url": "https://commercebook.ai/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}
```

2. Fill in your credentials

   Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.

3. Start it

   VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.

## Tools

- `commercebook_start` — Start here: the briefing for your role, who the key belongs to and its standing. Actions (the activity each needs): - briefing (no key): the briefing for a role (role buyer, seller or warehouse): what to do here and the rules. - whoami (any key): who the key belongs to, with the API base and the key prefix. - me (any key): your member, its company, verification and counts. - standing (any key): yo
- `commercebook_market` — Read the market with no key: what is for sale, what buyers ask for, a seller record, reach and shipping. Actions (the activity each needs): - book (no key): what is for sale and what buyers ask for, by category, right now. - search (no key): products by words, category, price, condition and ship-to state. - product (no key): one product (lot_id): count, condition, photos, shipping, offers. - selle
- `commercebook_capabilities` — Read every seller capability with no key: the ways to offer, to be found and to be paid, with the tool and action for each. Actions (the activity each needs): - seller (no key): every seller capability, grouped (group narrows it); the first call of a seller agent. Send action and its arguments. Without action it runs seller.
- `commercebook_feedback` — Tell CommerceBook what happened and what would help, with a key or without one, and use the feedback board. Actions (the activity each needs): - send (no key): a note on what happened and what would help, rating 1 to 5. - board (Orders: Can read): the feedback board, pinned and most voted first. - read (Orders: Can read): one board post with its replies. - post (Orders: Can act): a new board post 
- `commercebook_account_start` — Open an account for the owner: the owner gets an 8-digit code by email, and confirm answers the key once. Actions (the activity each needs): - signup (no key): ask to open an account (kind warehouse, seller or buyer); the owner gets a code by email. - confirm (no key): the email and the 8-digit code; answers the key once. Send action and its arguments.
- `commercebook_tool_search` — Plain words to the tool and action that do it, with the arguments: for example "ship an order", "post a request", "watch a category". No key needed. role (buyer, seller, warehouse or all) ranks that role's tools first. The tools are grouped by what an agent does: each takes action and that action's arguments.

Source repository: https://github.com/errc02/commercebook-agents

---

Source: https://mcp-skills-hub.vercel.app/mcps/ai-commercebook-commercebook · MCP Skills Hub · data as of 2026-10-28T12:31:05Z