Web & SearchMCP Registryremote6 toolsB · 76

CommerceBook MCP server

Name: CommerceBook
Author: commercebook.ai

ai.commercebook · Updated today

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.

Source 0

One-click install

VS Code VS Code Insiders Cursor

Opens your editor and pre-fills the config. Your editor will ask before adding it.

How to install CommerceBook in your AI client

Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.

How to install CommerceBook in Claude CodeAnthropic's agentic CLI

Add the server

bash

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

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
```
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).
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 DesktopDesktop app (MCP config)

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

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>"
      }
    }
  }
}

Fill in your credentials
Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.
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.
Restart Claude Desktop
The tools appear under the 🔌 menu once the app reloads.

How to install CommerceBook in CursorAI-first code editor

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

json

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

Fill in your credentials
Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.
Enable it
Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.

How to install CommerceBook in Codex CLIOpenAI coding agent

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>" }

Fill in your credentials
Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.
Why the wrapper?
Codex runs MCP servers as local processes, so mcp-remote bridges this HTTP endpoint to stdio.
Run Codex
Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.

How to install CommerceBook in WindsurfCodeium's agentic IDE

Edit ~/.codeium/windsurf/mcp_config.json

json

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

Fill in your credentials
Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.
Reload
Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.

How to install CommerceBook in ClineVS Code autonomous agent

Open Cline → MCP Servers → Configure
Adds to cline_mcp_settings.json.

Add the server

json

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

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 CodeCopilot / MCP support

Create .vscode/mcp.json

json

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

Fill in your credentials
Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.
Start it
VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.

What does CommerceBook need from you?

Bearer token — Optional. Bearer and the agent link key the owner issues at Agent access. Without a key the six keyless tools answer.

AuthorizationoptionalsecretHTTP header
Optional. Bearer and the agent link key the owner issues at Agent access. Without a key the six keyless tools answer.

What tools does CommerceBook expose? (6)

Read from the live server. Click any tool for its input schema.

commercebook_startStart 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_marketRead 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_capabilitiesRead 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_feedbackTell 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_startOpen 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_searchPlain 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.

What the code can do

This is a remote server — nothing is installed or run on your machine, so there is no local code to analyze. What it can reach is described above: your requests go to the provider's host.

Before you install

Signals gathered from the source repo and package registry — not a safety verdict.

What it can reach

Third-party hosted service — Your requests and any data in them are sent to commercebook.ai.
No local execution — Nothing is installed or run on your machine.

Last commit today — Actively maintained.
Repository created today — Very new project with little track record yet.
0 GitHub stars — Very little community usage so far.

Client compatibility

Claude Code: NativeClaude Desktop: Via mcp-remoteCursor: NativeCodex CLI: Via mcp-remoteWindsurf: NativeCline: NativeVS Code: Native

Health score

B · 76

Maintenance, adoption, transparency and packaging — not a safety audit. How this is calculated

Maintenance30%100%
Last commit 0 days ago.
Adoption20%0%
0 stars.
Transparency20%100%
4/4: ✓ public source repo, ✓ declared license, ✓ documentation, ✓ discoverable tool list.
Provenance15%75%
Links to its own repository; package linkage unverified.
Packaging15%100%
Remote endpoint with documented authentication.

Documentation

Full README

CommerceBook for agents

Sell or buy on CommerceBook from an agent. CommerceBook (https://commercebook.ai) is a network of verified warehouses and the sellers who sell through them. The first useful call costs nothing:

To buy: post a standing request with a ceiling. Sellers in the category are told at once, and the owner gets an email when a quote lands under the ceiling. Nothing is bought until a quote is accepted.
To sell: post a standing offer, a product with its price and count. Listing costs nothing, and CommerceBook takes its seller fee only from a sale. Each new public request in a live product's category arrives by email.
For a warehouse: set the markets and services, and post a deal it cannot serve as a lead on the exchange. Posting costs nothing.

npx -y @commercebook/mcp        # MCP server: the market and the requests with no key
npm install @commercebook/sdk   # TypeScript
pip install commercebook        # Python

Or connect an agent host to the remote MCP server at https://commercebook.ai/mcp (Streamable HTTP). No key is needed to read the market.

The skills

Three skills in the Agent Skills format. Each is a folder with a SKILL.md that an agent runtime loads by its description.

| Skill | Loads when the principal asks to | File | | --- | --- | --- | | sell-on-commercebook | find more places to sell, sell surplus inventory | skills/sell-on-commercebook/SKILL.md | | buy-on-commercebook | find a supplier, buy packaging | skills/buy-on-commercebook/SKILL.md | | commercebook-warehouse | find warehouse customers, buy or pass on leads | skills/commercebook-warehouse/SKILL.md |

Copy a skill folder into the agent's skills folder, for example ~/.claude/skills/ for Claude Code. Each SKILL.md is also served raw from GitHub at https://raw.githubusercontent.com/errc02/commercebook-agents/main/skills/<skill>/SKILL.md.

A buyer in five lines

import { CommerceBook } from '@commercebook/sdk';

const cb = new CommerceBook({ key: process.env.COMMERCEBOOK_API_KEY });
const found = await cb.searchProducts({ q: 'stretch film', max_price: 3000 });
const r = await cb.postRequest({ title: 'Stretch film, 18 inch, 80 gauge', category: 'packaging', qty: 40, ceiling_unit_cents: 2400 });

The sentence for the principal: "I registered your need for 40 rolls of stretch film at a ceiling of $24.00 a roll, at no cost. You get an email when a quote lands under it."

A key

Reading the market needs no key. An account's key comes from Agent access on CommerceBook, or an agent opens the account with POST /api/v1/signup/start and the owner confirms by email code. Every key starts read-only, the owner turns on each activity, and every call made with the key is on the owner's ledger.

Alternatives to CommerceBook

Maintain CommerceBook? Add a badge to your README

Shows its health grade, and links readers to install steps for every client.

markdown

[![CommerceBook on MCP Skills Hub](https://mcp-skills-hub.vercel.app/badge/ai-commercebook-commercebook)](https://mcp-skills-hub.vercel.app/mcps/ai-commercebook-commercebook)

Catalog data refreshed Oct 28, 2026. Something wrong? Report it.