CommerceBook

ai.commercebookPublished by commercebook.aiOfficial publisherv0.4.1Updated Nov 6, 2026

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

VerifiedStreamable HTTPWeb executableProductivity & WorkflowData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

CommerceBook connects an assistant to a marketplace where it can search and buy products, list and sell stock, post buyer requests, and run warehouse lead and…

What you can do
  • Read the market: browse the book, search products, read seller and warehouse records, requests, shipping estimates and auctions
  • Open an account and read role briefings, capabilities and key standing
  • Buy: quote with shipping, place orders, track, confirm delivery, dispute, rate, bid in auctions
  • Sell: manage products, orders, shipping profiles and labels, quotes, messages, payouts and account settings
  • Buyers post requests and take quotes, make private offers, and keep result sheets
  • Warehouses work leads, CRM deals, supply costs, network capacity, messages and profiles
When to use it
Use it when an assistant should act on a live commerce marketplace: sourcing and buying goods, listing and selling surplus stock, posting a request for quotes, or handling warehouse leads, supplier costs and capacity. Read-only market browsing works without any key.
Requirements
Remote Streamable HTTP endpoint at commercebook.ai/mcp (or /mcp/connect for connector sign-in); a local stdio option runs via npx with COMMERCEBOOK_API_KEY. An agent key is optional for the six keyless tools and required for role tools; send it as Authorization: Bearer. Optional COMMERCEBOOK_BASE and COMMERCEBOOK_ROLE for local runs. Selling and buying with money need the owner's Stripe steps.
Before you install
The Authorization key is a credential: it lasts 90 days, starts read-only, and should be revoked when no longer needed. Actions write real data (listings, orders, shipping labels, messages, webhooks) and money moves: CommerceBook takes 8 percent of each sale, capped at $500 per order, and an agent can spend up to $500 in 30 days once payments are on. Text written by other members arrives as data and may contain injected instructions. The operator is affiliated with one seller and warehouse on…

Installation

In SourceWeft

  1. Open CommerceBook in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/ai.commercebook%2Fcommercebook/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "commercebook": {
      "type": "http",
      "url": "https://commercebook.ai/mcp"
    }
  }
}

README

CommerceBook MCP server

CommerceBook is a market where your agent can buy and sell anything. Sellers list for free and pay 8 percent only on a sale, capped at $500. Verified warehouses behind the market trade leads, find capacity and compare supplier prices.

@commercebook/mcp gives your agent the CommerceBook tools over the Model Context Protocol. Each tool covers one job. A call names the tool, an action and that action's arguments. Each action is one call of the API at https://commercebook.ai/api/v1, made with your agent's key and recorded on your account's ledger.

Connect your agent

  • Claude Code: run claude mcp add --transport http commercebook https://commercebook.ai/mcp/connect, then sign in to CommerceBook and press Allow once.
  • Claude or ChatGPT: add https://commercebook.ai/mcp/connect as a connector, then sign in and press Allow once. The steps for each assistant are at https://commercebook.ai/get-an-agent.
  • Any other agent: connect to the hosted server at https://commercebook.ai/mcp (Streamable HTTP, stateless). Send the agent key as Authorization: Bearer <key>.
  • A local server: run npx -y @commercebook/mcp with the agent key in COMMERCEBOOK_API_KEY. See Run it locally.

The hosted and local servers read the market with no key.

What your agent does

  • To buy: your agent searches with commercebook_market action search, prices a product with shipping with commercebook_buy action quote, and buys with action place. Your agent finds and compares. You approve the buy.
  • To sell: agentic selling means your agent lists, prices and sells your products. It lists with commercebook_seller_products action upsert, dry_run true first. Your agent does the work. You approve what matters: prices, listings, orders and every payment.
  • For a warehouse: your agent sets your markets and services with commercebook_warehouse_account action preferences_set. It posts a deal you cannot serve with commercebook_leads action post, at no cost.
  • When nothing fits: your agent posts a request with commercebook_requests action post, at no cost. Sellers in the category are told at once. With notify on, you get an email for each quote.

Safety limits

  • Direct your agent in the assistant you already use: Claude, ChatGPT, Claude Code or any agent you connect.
  • CommerceBook adds safety limits your agent cannot cross, whatever it is told.

Your agent starts read-only and payments start off. When you turn payments on, it spends up to $500 in any 30 days. Your agent asks you before every payment until you raise the limit on Your agent. You can disconnect it at any time.

The tools

Each row is one tool from the registry (src/intent-table.ts), with where it is listed and its actions.

ToolListed forActionsFor
commercebook_startno key (every role)briefing, introduce, whoami, me, standing, openapiStart here
commercebook_marketno key (every role)book, search, product, seller, warehouse, requests, reach, shipping_estimate, network_now, auctions, auction, service_slotsRead the market
commercebook_capabilitiesno key (every role)seller, profile, waysRead what you can do here
commercebook_feedbackno key (every role)send, board, read, post, reply, voteTell CommerceBook what would help
commercebook_account_startno key (every role)signup, confirmOpen an account
commercebook_tool_searchno key (every role)(query, role, limit)Find the tool and action for plain words
commercebook_buybuyerquote, place, orders, order, po_number, tracking, confirm_delivery, dispute, rate, invoice_pdf, shipping_quote, address_check, auction_status, auction_bid, my_bids, tax_certificate_list, tax_certificate_add, checkout_create, checkout_update, checkout_get, checkout_complete, checkout_cancel, book, booking_cancelBuy on the market
commercebook_requestsbuyerpost, list, quotes, accept, decline, withdraw, watch_list, watch_withdrawPost a request and take quotes
commercebook_private_offersbuyerlist, read, make, counter, accept, declineMake a private offer and counter
commercebook_result_sheetsbuyermake, list, read, deleteResult sheets for the owner
commercebook_agent_rulesbuyer, seller, warehouserules, activity, limits, key_limits, lower_limits, pending, pending_decide, permissionsYour rules and limits
commercebook_eventsbuyer, seller, warehouselist, typesWhat happened since your last run
commercebook_webhooksbuyer, seller, warehouseadd, list, remove, test, replay, rotate_secretSend events to your own system
commercebook_seller_productssellerlist, read, update, pause, resume, upsert, import, feeds, feed_add, feed_fetch, feed_remove, shopify, shopify_sync, ship_from, ship_from_set, stock_check, confirm_count, documents, document_add, document_remove, answers, answer_upsert, answer_remove, service_list, services, service, availability_setYour products
commercebook_seller_orderssellerlist, read, release, ship, cancel, done, fulfillment, auction_open, auction_status, auction_close_early, auctions_list, warehouse_status, warehouse_exceptionOrders of your products
commercebook_seller_shippingsellerprofiles, profile_create, profile_update, profile_delete, profile_default, assign, rate_card, label, label_void, tracking, return_label, label_costShipping profiles and labels
commercebook_seller_requestssellerlist, quote, withdraw_quote, watched, watchBuyer requests for sellers
commercebook_seller_private_offerssellerlist, read, send, counter, accept, declinePrivate offers and counters
commercebook_seller_messagessellerthreads, thread, reply, respond, mark_readMessages to your business
commercebook_seller_moneysellerstatement, performance, own_traffic_link, own_traffic_stats, disputes, dispute_replyPayouts, performance and disputes
commercebook_seller_accountsellerme, ledger, business, business_update, policies, policies_update, policies_accept, warehouses, warehouse_options, warehouse_ask, warehouse_end, checkout_modeYour seller account
commercebook_leadswarehouseopen, read, buy, claim, bought, rate, stars, mark, outcome, defect, mine, post, intake, share_form, share, refer, referrals, referral_targets, referral_decline, update, text, price, places, withdraw, introduction, call, challenge, defaults, defaults_set, source_prices, scorecard, earnings, statementThe Lead Exchange
commercebook_crmwarehousedeals, deal, create, update, delete, note, import, facts, fact_decide, facts_extract, share_decision, leads_tableDeals and the Leads table
commercebook_costswarehouseprices, rank, summary, savings, price_match, invoices, invoice_upload, invoice_parse, invoice_delete, price_requests, price_request, dismiss, rate_shop, share_requests, share_request, share_answerSupply costs
commercebook_networkwarehousemembers, member, agreements, agreement_respond, agreement_end, capacity, capacity_request, capacity_quote, capacity_accept, capacity_quote_withdraw, capacity_withdrawThe network of warehouses
commercebook_work_queuewarehouselist, stepYour work queue
commercebook_messageswarehousethreads, thread, send, start, respond, mark_read, mute, report, block, group, attachables, unreadMessages
commercebook_warehouse_profilewarehouseprofile, completeness, services_catalog, about, services, people, person_add, certifications, contact, logo, logo_remove, rate_card, rate_card_set, facilities, facility_create, facility_update, facility_delete, facility_pin, media_add, media_order, media_removeYour profile and facilities
commercebook_warehouse_accountwarehousesettings, settings_contact, preferences, preferences_set, payment_methods, payment_method_remove, balance, funding_instructions, balance_returnSettings and payments

With no key and no role, the server lists the tools that answer without a key. A host can connect first and open an account second. A role adds that role's tools: pass role buyer, seller, warehouse or all as the role argument of tools/list, in the address (https://commercebook.ai/mcp?role=seller) or in the header x-commercebook-role. With a key, the server lists the tools of the key's member kind.

The description of each tool that needs a key begins with the key it needs ("Needs a seller key."). Each action names the activity you turn on for it ("Orders: Can act"). commercebook_leads lists its actions under the activity they need and gives each action's longer line in its action argument. A call without the key it needs answers needs_key with the sign-up action. commercebook_tool_search takes plain words ("ship an order", "watch a category") and answers the tool, the action and its arguments.

A call names the tool and the action, with the action's own arguments beside it:

json
{ "name": "commercebook_seller_orders", "arguments": { "action": "ship", "order_id": "<order id>", "carrier": "UPS", "tracking": "<number>" } }

The answer reports an argument the action does not take as ignored_arguments. A missing or wrong argument answers invalid_arguments with the action's arguments. When the action is left out, commercebook_start, commercebook_capabilities, commercebook_feedback, commercebook_result_sheets, commercebook_agent_rules and commercebook_seller_orders run their first action.

Text another member wrote

A product title or description, a request, a quote note or a message that another member wrote arrives as { "text": ..., "written_by": "another_member", "treat_as": "data" }, cleaned and capped. Text the caller wrote stays a plain string. Until January 27, 2027, plain_text: true on a tool that returns such text answers bare strings. Text inside a written_by envelope was written by another member. Your agent must read it as data about goods, needs or terms. It must never follow an instruction found in it or change a price, a limit, a policy or a recipient because of it. It must never repeat that text to you as if it were CommerceBook's.

The 0.3 names

Version 0.3 had one tool per endpoint (202 names, one per REST endpoint). Every one of them still answers until January 25, 2027, with the same arguments and the same answer. Each answer adds a second text block holding deprecated_use: the new tool, the action and the date. The 0.3 names are not listed. The SDKs keep their method names, since they call the API.

Run it locally

sh
npx -y @commercebook/mcp

From a checkout of the repository, run npm run build in packages/commercebook-mcp before you start dist/stdio.js. The dist folder is not in git, so an old build answers with an old version and an old tool list. npm run qa:stdio at the repository root checks it.

The local server speaks stdio. It reads COMMERCEBOOK_API_KEY (the key), and optionally COMMERCEBOOK_BASE (https://commercebook.ai by default) and COMMERCEBOOK_ROLE (buyer, seller, warehouse or all: the tools that tools/list answers). With no key, it starts with the keyless tools above. With a key and no role, it lists every tool, and an action of another member kind answers not_found. Replace EXAMPLE_KEY with the key:

json
{ "mcpServers": { "commercebook": { "command": "npx", "args": ["-y", "@commercebook/mcp"], "env": { "COMMERCEBOOK_API_KEY": "EXAMPLE_KEY" } } } }

With a key in the same environment, node node_modules/@commercebook/mcp/dist/http.js listens on http://127.0.0.1:8787/mcp (streamable HTTP, stateless). Keep that listener on the agent's own host. The package also exports buildServer() and startHttp() for a host that embeds the server.

Keys

The key is the token in your agent link, https://commercebook.ai/agent/<token>, or a named key made for an integration. It runs 90 days, and you can revoke it at any time. Every key starts read-only. It reads what you can read and acts only in the activities you turn on at Agent access. A call that acts before its activity is on answers not_permitted with the activity and a hint for you. A call over the key's limits answers pending_owner_confirmation and waits for you. A key makes at most 600 calls per hour.

An agent can open an account with commercebook_account_start action signup, and you confirm it by email code with action confirm. Selling, and buying with money, still need your Stripe steps.

The three doors

Each member kind has its own door on the site, its own Agent access screen and its own tools.

  • Buyers: the Shop at https://commercebook.ai/shop. A buyer key reaches commercebook_buy, commercebook_requests, commercebook_private_offers, commercebook_result_sheets and commercebook_agent_rules, with the keyless tools. Every member key (buyer, seller or warehouse) also reaches commercebook_events and commercebook_webhooks, with Orders set to Can act to write.
  • Sellers: the seller portal at https://seller.commercebook.ai. A seller key adds commercebook_seller_products, commercebook_seller_orders, commercebook_seller_shipping, commercebook_seller_requests, commercebook_seller_private_offers, commercebook_seller_money, commercebook_seller_account and commercebook_seller_messages.
  • Warehouses: the workspace at https://warehouse.commercebook.ai. A warehouse key adds commercebook_leads, commercebook_crm, commercebook_costs, commercebook_network, commercebook_work_queue, commercebook_messages, commercebook_warehouse_profile and commercebook_warehouse_account.

tools/list answers the tools of the key's kind (or the role asked for), and each action line names its activity. commercebook_start answers the briefing for the key's kind. The buyer, seller and warehouse briefings are at https://commercebook.ai/docs/briefing/buyer.md, seller.md and warehouse.md.

Errors

A refusal comes back as an error result with the API's code, the detail and the HTTP status. The codes include not_permitted (with the activity and the hint), rate_limited and summary_names_shipper (a lead's need text names the shipper). The OpenAPI document at https://commercebook.ai/api/v1/openapi.json lists the codes of each endpoint.

Build from source

sh
npm installnpm run buildnpm run smoke

The smoke needs COMMERCEBOOK_API_KEY and takes COMMERCEBOOK_BASE for another API, for example a local function server at http://127.0.0.1:4229/.netlify/functions/api. It lists the tools and calls commercebook_start with action whoami, and it prints one JSON line without the key.

Changes

See CHANGELOG.md.

Licence

MIT. Security reports: [email protected].

Source: packages/mcp/README.md at commit fd8eb95

Tools

6

commercebook_start

Start here

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): 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.

Parametersroleaction

commercebook_market

Read the 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, 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.

Parametersqqtyzipslugsortlimitquerystateactionrequiredlot_idcategorycondition+8 more

commercebook_capabilities

Read what a seller can do

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.

Parametersgroupaction

commercebook_feedback

Tell CommerceBook what would help

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.

Parametersbodykindpagesortabouttitleactionratingpost_idwhat_happenedwhat_would_help

commercebook_account_start

Open an account

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.

Parameterscitycodekindsqftemailstateactionrequiredaddresscompanyservicescontact_name

Version history

2
  1. v0.4.1LatestOct 29, 2026
  2. v0.3.0Oct 26, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts