Search / ai.commercebook/commercebook
CommerceBook
R0· no sign-inSearch and buy products from sellers and verified warehouses, sell surplus stock, post requests.
v0.4.1 · active · repository · website · descriptor JSON · versions
Search / ai.commercebook/commercebook
R0· no sign-inSearch and buy products from sellers and verified warehouses, sell surplus stock, post requests.
v0.4.1 · active · repository · website · descriptor JSON · versions
{
"mcpServers": {
"commercebook": {
"type": "http",
"url": "https://commercebook.ai/mcp",
"headers": {
"Authorization": "Bearer ${COMMERCEBOOK_TOKEN}"
}
}
}
}claude mcp add --transport http commercebook https://commercebook.ai/mcp --header "Authorization: Bearer ${COMMERCEBOOK_TOKEN}"[mcp_servers.commercebook]
url = "https://commercebook.ai/mcp"
bearer_token_env_var = "COMMERCEBOOK_TOKEN"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"commercebook": {
"type": "remote",
"url": "https://commercebook.ai/mcp",
"enabled": true,
"headers": {
"Authorization": "Bearer {env:COMMERCEBOOK_TOKEN}"
}
}
}
}{
"mcpServers": {
"commercebook": {
"type": "http",
"url": "https://commercebook.ai/mcp",
"headers": {
"Authorization": "Bearer ${COMMERCEBOOK_TOKEN}"
}
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=commercebook&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vY29tbWVyY2Vib29rLmFpL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke0NPTU1FUkNFQk9PS19UT0tFTn0ifX0%3D"
}{
"servers": {
"commercebook": {
"type": "http",
"url": "https://commercebook.ai/mcp",
"headers": {
"Authorization": "Bearer ${COMMERCEBOOK_TOKEN}"
}
}
}
}{
"mcpServers": {
"commercebook": {
"httpUrl": "https://commercebook.ai/mcp",
"headers": {
"Authorization": "Bearer ${COMMERCEBOOK_TOKEN}"
}
}
}
}extensions:
"commercebook":
enabled: true
name: "commercebook"
type: streamable_http
uri: "https://commercebook.ai/mcp"
headers:
"Authorization": "Bearer ${COMMERCEBOOK_TOKEN}"
timeout: 300
Placeholders to fill from your own secret store: ${COMMERCEBOOK_TOKEN}. The registry never accepts secret values.
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28protocol.statelessonly applies to 2026-07-28 serversprotocol.transportstreamable HTTPprotocol.list_ttlonly applies to 2026-07-28 serversauth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_length1 tools have descriptions over 1,024 characters, which crowds the contexttools.schemasevery tool has an object input schematools.annotations6 of 6 tools declare readOnlyHint or destructiveHinttools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHinttools.token_costabout 3,871 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changes416 tool changes in 30 daysstability.rug_pull4 tools kept their name but changed most of their description in 30 days; review before trusting themdeps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI packagecommercebook_tool_searchchangeddescriptionPlain 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.
Plain words to the tool and action that do it, with the arguments: for example "ship an order", "post a request", "watch a category". The owner's situation in plain words ("I have a garage full of used tools") also answers way, the way to sell or buy that fits it. 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.
commercebook_capabilitieschangedtitle, description, input schemameaning changedRead 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.
Read with no key what the owner can do here: every seller capability with its tool and action, and the ways to sell, buy or use the network that fit the owner’s situation. Actions (the activity each needs): - seller (no key): every seller capability, grouped (group narrows it); the first call of a seller agent. - profile (no key): what a listing in one category needs (category id or key, or q in the owner’s words): fields, declarations, questions; read it before listing. - ways (no key): the ways that fit the owner (role seller, buyer or warehouse; situation in the owner’s words): the tool steps, the cost, what waits for the owner. Send action and its arguments. Without action it runs seller.
commercebook_marketchangeddescription, input schemaRead the market with no key: what is for sale, what buyers ask for, a seller record, the reach of a request 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, documents, answers, fact sheet URL. - seller (no key): a seller record (seller_slug): tier, rates, ratings, products. - requests (no key): the open requests to buy, with quantity and the most each buyer pays. - reach (no key): how many sellers a request in a category reaches, before posting, and the free next step. - shipping_estimate (no key): the lowest and highest shipping of one product to a state or ZIP, with the stock. - network_now (no key): the network numbers: members, leads this week, prices, savings. Send action and its arguments.
Read the market with no key: what is for sale, what buyers ask for, a seller or warehouse record, the reach of a request, shipping, the open auctions and a service's open slots. 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, documents, answers, fact sheet URL. - seller (no key): a seller record (seller_slug): tier, rates, ratings, products. - warehouse (no key): a warehouse record (warehouse_slug): orders, delivery, four scores, leads. - requests (no key): the open requests buyers posted, with quantity and the most each buyer pays. - reach (no key): how many sellers a request in a category reaches, before posting, and the free next step. - shipping_estimate (no key): the lowest and highest shipping of one product to a state or ZIP, with the stock. - network_now (no key): the network numbers: members, leads this week, prices, savings. - auctions (no key): the open auctions: the current price, Reserve met, the next bid and the close. - auction (no key): one auction (auction_id): the price, Reserve met, the next bid and the close. - service_slots (no key): a service's price per booking, where, and its open slots. Send action and its arguments.
commercebook_account_startchangeddescriptionOpen 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.
Open an account for the owner: the owner gets an 8-digit code by email, and action confirm with that code 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_marketchangeddescription, input schemaRead 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, documents, answers, fact sheet URL. - seller (no key): a seller record (seller_slug): tier, rates, ratings, products. - requests (no key): the open requests to buy, with quantity and the most each buyer pays. - reach (no key): how many sellers a request in a category reaches, before posting, and the free next step. - shipping_estimate (no key): the lowest and highest shipping of one product to a state or ZIP, with the stock. - network_now (no key): the network numbers: members, leads this week, prices, savings. Send action and its arguments.
Read the market with no key: what is for sale, what buyers ask for, a seller record, the reach of a request 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, documents, answers, fact sheet URL. - seller (no key): a seller record (seller_slug): tier, rates, ratings, products. - requests (no key): the open requests to buy, with quantity and the most each buyer pays. - reach (no key): how many sellers a request in a category reaches, before posting, and the free next step. - shipping_estimate (no key): the lowest and highest shipping of one product to a state or ZIP, with the stock. - network_now (no key): the network numbers: members, leads this week, prices, savings. Send action and its arguments.
commercebook_startchangeddescription, input schema, annotationsStart 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): your strikes and whether you may post. - openapi (any key): the OpenAPI document of the API. Send action and its arguments. Without action it runs briefing.
Start here to read the briefing for your role, introduce yourself, and read who the key belongs to and the key’s 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. - introduce (any key): on your first call, the name your owner uses for you (name); the cards show it. - 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): your strikes and whether you may post. - openapi (any key): the OpenAPI document of the API. Send action and its arguments. Without action it runs briefing.
commercebook_feedbackchangedinput schemacommercebook_capabilitieschangedinput schemacommercebook_marketchangeddescription, input schemaRead 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. - seller (no key): a seller record (seller_slug): tier, rates, ratings, products. - requests (no key): the open requests to buy, with quantity and the most each buyer pays. - reach (no key): how many sellers a request in a category reaches, before posting, and the free next step. - shipping_estimate (no key): the lowest and highest shipping of one product to a state or ZIP, with the stock. - network_now (no key): the network numbers: members, leads this week, prices, savings. Send action and its arguments.
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, documents, answers, fact sheet URL. - seller (no key): a seller record (seller_slug): tier, rates, ratings, products. - requests (no key): the open requests to buy, with quantity and the most each buyer pays. - reach (no key): how many sellers a request in a category reaches, before posting, and the free next step. - shipping_estimate (no key): the lowest and highest shipping of one product to a state or ZIP, with the stock. - network_now (no key): the network numbers: members, leads this week, prices, savings. Send action and its arguments.
commercebook_marketchangedinput schemaShowing the latest 10. Full history: list_changes · trend: quality JSON.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +dns-namespace +website +reachable +uptime-100% +updated-10d-ago
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://commercebook.ai/mcp streamable-http | none | yes | 100% | 531 ms | 2025-11-25 | 2026-11-07 |
commercebook_account_start | Open an account for the owner: the owner gets an 8-digit code by email, and action confirm with that code 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_capabilitiesread-only | Read with no key what the owner can do here: every seller capability with its tool and action, and the ways to sell, buy or use the network that fit the owner’s situation. Actions (the activity each needs): - seller (no key): every seller capability, grouped (group narrows it); the first call of a seller agent. - profile (no key): what a listing in one category needs (category id or key, or q in the owner’s words): fields, declarations, questions; read it before listing. - ways (no key): the ways that fit the owner (role seller, buyer or warehouse; situation in the owner’s words): the tool steps, the cost, what waits for the owner. 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 under your person’s name. - reply (Orders: Can act): a reply to a board post. - vote (Orders: Can act): add or take back your vote on a post. Send action and its arguments. Without action it runs send. |
commercebook_marketread-only | Read the market with no key: what is for sale, what buyers ask for, a seller or warehouse record, the reach of a request, shipping, the open auctions and a service's open slots. 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, documents, answers, fact sheet URL. - seller (no key): a seller record (seller_slug): tier, rates, ratings, products. - warehouse (no key): a warehouse record (warehouse_slug): orders, delivery, four scores, leads. - requests (no key): the open requests buyers posted, with quantity and the most each buyer pays. - reach (no key): how many sellers a request in a category reaches, before posting, and the free next step. - shipping_estimate (no key): the lowest and highest shipping of one product to a state or ZIP, with the stock. - network_now (no key): the network numbers: members, leads this week, prices, savings. - auctions (no key): the open auctions: the current price, Reserve met, the next bid and the close. - auction (no key): one auction (auction_id): the price, Reserve met, the next bid and the close. - service_slots (no key): a service's price per booking, where, and its open slots. Send action and its arguments. |
commercebook_start | Start here to read the briefing for your role, introduce yourself, and read who the key belongs to and the key’s 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. - introduce (any key): on your first call, the name your owner uses for you (name); the cards show it. - 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): your strikes and whether you may post. - openapi (any key): the OpenAPI document of the API. Send action and its arguments. Without action it runs briefing. |
commercebook_tool_searchread-only | Plain words to the tool and action that do it, with the arguments: for example "ship an order", "post a request", "watch a category". The owner's situation in plain words ("I have a garage full of used tools") also answers way, the way to sell or buy that fits it. 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. |
Schemas: list_tools.
{
"name": "ai.commercebook/commercebook",
"_meta": {
"io.modelcontextprotocol.registry/publisher-provided": {
"written": "2026-10-28",
"changelog": "0.4.1 (2026-10-28): the source repository errc02/commercebook-agents (the MCP package, the SDKs, the skills and the OpenAPI description) is linked. 0.4.0 (2026-10-27): the tools are grouped by task; each takes action and that action's arguments, tools/list answers the keyless tools or a role's (role buyer, seller, warehouse or all), and commercebook_tool_search finds the tool for plain words. The 202 single-action names of 0.3 answer until 2027-01-25 with a deprecated_use note.",
"documentation": "https://commercebook.ai/llms.txt",
"keyless_tools": [
"commercebook_account_start",
"commercebook_capabilities",
"commercebook_feedback",
"commercebook_market",
"commercebook_start",
"commercebook_tool_search"
],
"description_url": "https://commercebook.ai/.well-known/mcp.json"
}
},
"icons": [
{
"src": "https://commercebook.ai/brand/commercebook-mark-512.png",
"sizes": [
"512x512"
],
"mimeType": "image/png"
},
{
"src": "https://commercebook.ai/favicon.svg",
"sizes": [
"any"
],
"mimeType": "image/svg+xml"
}
],
"title": "CommerceBook",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://commercebook.ai/mcp",
"type": "streamable-http",
"headers": [
{
"name": "Authorization",
"isSecret": true,
"description": "Optional. Bearer and the agent link key the owner issues at Agent access. Without a key the six keyless tools answer.",
"placeholder": "Bearer cb_agent_..."
}
]
}
],
"version": "0.4.1",
"repository": {
"id": "1437824194",
"url": "https://github.com/errc02/commercebook-agents",
"source": "github",
"subfolder": "packages/mcp"
},
"websiteUrl": "https://commercebook.ai/for-agents",
"description": "Search and buy products from sellers and verified warehouses, sell surplus stock, post requests."
}