Skip to content
Back to search
100
MCP live MCP 2025-11-25 streamable-http

CommerceBook

ai.commercebook/commercebook

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

Watch this dependency

Get before/after evidence when observed tools, schemas, authentication access, availability or the endpoint changes.

Inspect evidence and set up a watch Share public evidence report
Uptime
100.0%
1 direct probes · 30d
Response
1650ms
last probe
Tools
200
callable
Resources
0
readable
Prompts
0
available
Score: 100/100
Handshake verified by our own probe.
why this score
pass Answers the MCP handshake 50/50
The handshake and the list calls succeeded on the primary URL.
pass Lists tools, resources or prompts 30/30
200 tools, 0 resources, 0 prompts returned.
pass 3 or more catalogue items 10/10
200 items in total; 3 or more earns these points.
pass Describes itself 10/10
96 characters; more than 30 earns these points.

Tools · 200

signup_start

POST /signup/start: asks to open a CommerceBook account for the owner. The owner gets one email with an 8-digit code and no link; the code lives 30 minutes; three starts per email per day. kind is war…

signup_confirm

POST /signup/confirm: the email and the 8-digit code the owner read in the email. Makes the account and answers the key (the agent link key, shown once), the agent link and the member’s document. Conn…

commercebook_network_now

GET /network/now (no key needed): verified members, leads listed in the last 7 days, prices posted and savings confirmed this month, cached 15 minutes.

network_now

The older name of commercebook_network_now, kept so agents that call it keep working. GET /network/now (no key needed): verified members, leads listed in the last 7 days, prices posted and savings con…

instructions

GET /instructions with no key: the briefing of the role asked for (role buyer, seller or warehouse; buyer when left out): what CommerceBook does for that role, how each thing is done, the rules, what …

commercebook_feedback

POST /feedback: a note on a tool or a page, what happened and what would have helped, with an optional rating from 1 to 5. A person at CommerceBook reads every note; the What is coming list in the bri…

commercebook_market_search

GET /market/search: the products for sale on CommerceBook, by words (every word must match a whole word, with an optional plural ending, so stretch never matches stretcher) in the title, the category …

commercebook_market_lot

GET /market/lots/{id}: one public product (lot_id) as its product page shows it (the count, the condition, the date the seller last confirmed the count, the photos, the shipping) with every active off…

commercebook_market_seller

GET /market/sellers/{slug} (seller_slug, or slug, its older name): the record CommerceBook computes for one seller (seller_slug of a search item or a product): the tier (new, standard or trusted, with…

commercebook_market_intents

GET /market/intents: the demand side of the book. Every open public request (an intent in the API) with its title, category, quantity, the most the buyer pays each (ceiling_unit_cents; a band when the…

commercebook_market_book

GET /market/book: what is on the market and what buyers ask for, by category, with live numbers only. supply: public products, the sellers behind them, and by_category the products, sellers and the lo…

commercebook_request_reach

GET /market/intents/reach: before posting, how many sellers a public request in the category would be emailed to (each with a live product there, or watching the category) and how many live products m…

commercebook_market_shipping_estimate

GET /market/lots/{id}/shipping: the lowest and highest shipping of one product to a state, from the seller’s shipping rules (no carrier call). served false means the seller does not ship there; a calc…

commercebook_seller_capabilities

GET /seller/capabilities: every seller capability on CommerceBook in one read, grouped as ways_to_offer (a standing offer, price by quantity, quote on request with a private floor, quotes on buyer req…

commercebook_whoami

Needs a buyer key (no activity needed). A seller or warehouse key also reaches it. The member this key belongs to, with verification, counts, the API base and the key prefix.

commercebook_me

Needs a buyer key (no activity needed). A seller or warehouse key also reaches it. GET /me: your member, its organisation (your company), verification and counts.

commercebook_my_standing

Needs a buyer key (no activity needed). A seller or warehouse key also reaches it. GET /me/standing: your strikes in 90 and 365 days, fabricated-contact strikes, whether you may post (posting_suspende…

commercebook_openapi

Needs a buyer key (no activity needed). A seller or warehouse key also reaches it. GET /openapi.json: the OpenAPI 3.1 document of the warehouse API.

commercebook_leads_open

Needs a warehouse key (Leads: Can read). GET /leads/open: open leads on the exchange, newest first, with the same visibility rules as the app. Filter by service or market (City, ST); a market filter a…

commercebook_leads_mine

Needs a warehouse key (Leads: Can read). GET /leads/mine: the leads you posted, drafts included.

commercebook_lead_post

Needs a warehouse key (Leads: Can act). POST /leads: post a lead from one of your CRM deals (deal_id) or from fields (company_name, need, service, markets or market, price). Send a title (80 character…

commercebook_lead_claim

Needs a warehouse key (Payments: Can act). POST /leads/{id}/claim: claims an open lead. A free lead claims at once (payment demo). A priced lead with payments configured is paid without a client secre…

commercebook_deals_list

Needs a warehouse key (CRM: Can read). GET /crm/deals: your CRM deals, most recently updated first.

commercebook_deal_create

Needs a warehouse key (CRM: Can act). POST /crm/deals: a new CRM deal; name is required. Also Add a lead on the Leads screen: contact_name, email and phone write the contact, markets (City, ST) or loc…

commercebook_deal_update

Needs a warehouse key (CRM: Can act). PATCH /crm/deals/{id}: change the named fields of a deal. A stage change runs the board rules.

commercebook_capacity_list

Needs a warehouse key (Capacity: Can read). GET /capacity/requests: the requests you sent and the ones your node received.

commercebook_capacity_request

Needs a warehouse key (Capacity: Can act). POST /capacity/requests: ask another warehouse (node_id from commercebook_members, or its member_id) for pallet positions over a date range.

commercebook_capacity_quote

Needs a warehouse key (Capacity: Can act). POST /capacity/requests/{id}/quote: quote a request your node received.

commercebook_threads_list

Needs a warehouse key (Messages: Can read). GET /messages/threads: your message threads.

commercebook_thread_get

Needs a warehouse key (Messages: Can read). GET /messages/threads/{id}: one thread with its messages, oldest first.

commercebook_message_send

Needs a warehouse key (Messages: Can act). POST /messages/threads/{id}: send a message in an open thread.

commercebook_message_request

Needs a warehouse key (Messages: Can act). POST /messages/request: the first message to a member opens a thread they accept in the app. An existing open or requested thread is returned instead.

commercebook_prices

Needs a warehouse key (Costs: Can read). GET /costs/prices: your invoiced items against the network quotes, as the app computes them. Each quote carries its match (exact, reviewed_equivalent or possib…

commercebook_members

Needs a warehouse key (no activity needed). GET /network/members: the directory, public fields only, with each member’s node id.

commercebook_seller_me

Needs a seller key (no activity needed). GET /seller/me: your seller, what blocks selling (blockers), readiness and counts.

commercebook_seller_lots

Needs a seller key (Catalog: Can read). GET /seller/catalog/lots: your products (lots in the API), newest first, with state (live, held for paused, draft, stale, sold_out), quantities, price and compl…

commercebook_seller_lot_get

Needs a seller key (Catalog: Can read). GET /seller/catalog/lots/{id}: the product record an agent reads, with its manifest, offers and ledger rows.

commercebook_seller_catalog_upsert

Needs a seller key (Catalog: Can act). POST /seller/catalog/upsert: up to 500 records of the CommerceBook product data template v1.1 (ACP field names: item_id, title, description, brand, category, con…

commercebook_seller_lot_hold

Needs a seller key (Catalog: Can act). POST /seller/catalog/lots/{id}/hold: pauses the product’s live offers until you resume sales.

commercebook_seller_lot_release

Needs a seller key (Catalog: Can act). POST /seller/catalog/lots/{id}/release: resumes sales of a paused product on the market through the publish checks (you must be live).

commercebook_seller_reconcile

Needs a seller key (Catalog: Can read). GET /seller/catalog/reconcile: the stock problems of your products against the count on record at the warehouse that ships them, and the stale counts (a count i…

commercebook_seller_verify

Needs a seller key (Catalog: Can act). POST /seller/catalog/verify: after a physical count matched, every product keeps its quantity on hand as the count, and now becomes its count date.

commercebook_seller_orders

Needs a seller key (Orders: Can read). GET /seller/orders: orders of your products, newest first.

commercebook_seller_order_get

Needs a seller key (Orders: Can read). GET /seller/orders/{id}: the order with payment, fulfillment, disputes, refunds and transitions.

commercebook_seller_order_release

Needs a seller key (Orders: Can act). POST /seller/orders/{id}/release: releases an authorised order to ship. A shipped order over $500 needs evidence (the count and at least one photo link), else 409…

commercebook_seller_order_ship

Needs a seller key (Orders: Can act). POST /seller/orders/{id}/ship: marks a released order shipped (with carrier and tracking) or picked up. buy_label true (SPEC-67) buys the label for the quoted ser…

commercebook_seller_order_cancel

Needs a seller key (Orders: Can act). POST /seller/orders/{id}/cancel: cancels an order before release; the payment is voided.

commercebook_seller_disputes

Needs a seller key (Orders: Can read). GET /seller/disputes: disputes on your orders.

commercebook_seller_dispute_reply

Needs a seller key (Orders: Can act). POST /seller/disputes/{id}/reply: your note and evidence (tracking, photo links) on an open dispute.

commercebook_seller_policies_get

Needs a seller key (Policies: Can read). GET /seller/policies: acceptance_days (the business days a buyer has to file a dispute, as the policy states it), returns, restocking fee, the lowest price you…

commercebook_seller_policies_update

Needs a seller key (Policies: Can act). PATCH /seller/policies: the named fields only. Accepting the policies is the owner’s own step in the app.

commercebook_seller_statement

Needs a seller key (Payouts: Can read). GET /seller/payouts/statement: proceeds after the fee, refund reversals, fee and processing lines by order (90 days by default).

commercebook_seller_performance

Needs a seller key (Performance: Can read). GET /seller/performance: the seller sheet, live, with the counts behind every rate.

commercebook_seller_delegations

Needs a seller key (Delegations: Can read). GET /seller/delegations: your warehouse agreements (delegations in the API) with the warehouses that store and ship for you, and their status.

commercebook_seller_delegation_request

Needs a seller key (Delegations: Can act). POST /seller/delegations: asks a warehouse on CommerceBook for a warehouse agreement to store and ship your goods; it answers from its own account.

commercebook_seller_events

Needs a seller key (no activity needed). GET /seller/events: what happened on your account, newest first, and whether your agent did it.

commercebook_lead_get

Needs a warehouse key (Leads: Can read). GET /leads/{id}: one lead as the exchange shows it, with quality: the lead quality score (0 to 9), what is present, and on your own lead what is missing.

commercebook_lead_buy

Needs a warehouse key (Payments: Can act). POST /leads/{id}/buy: buys a lead within the money limits on the key; over a limit the answer is needs_approval with the approval_id the owner sees. In Strip…

commercebook_lead_withdraw

Needs a warehouse key (Leads: Can act). POST /leads/{id}/withdraw: takes your draft or open lead off the exchange, until a buyer claims it.

commercebook_lead_places

Needs a warehouse key (Leads: Can act). PATCH /leads/{id}/places: how many buyers may buy your lead (1 makes it exclusive).

commercebook_lead_price

Needs a warehouse key (Leads: Can act). PATCH /leads/{id}/price: the flat price in cents of your draft or open lead, before any buyer claims it (0 is a free lead).

commercebook_lead_text

Needs a warehouse key (Leads: Can act). PATCH /leads/{id}/text: the title (80 characters), the one-line summary (140) and where the lead came from (lead_source own or referral, referral_source the lea…

commercebook_lead_update

Needs a warehouse key (Leads: Can act). PATCH /leads/{id}: adds details to your draft or open lead before any buyer claims it (409 lead_has_claims after one): product, current_provider (a buyer sees i…

commercebook_lead_introduction

Needs a warehouse key (Leads: Can act). POST /leads/{id}/introduction: sends the introduction to the buyers of your lead.

commercebook_lead_call

Needs a warehouse key (Leads: Can act). POST /leads/{id}/call: schedules the call with the buyers of your lead (at: ISO 8601 with zone).

commercebook_lead_rate

Needs a warehouse key (Leads: Can act). POST /leads/{id}/rating: rates a lead you bought as_described or overstated, once.

commercebook_lead_challenge

Needs a warehouse key (Leads: Can act). POST /leads/{id}/challenge: challenges a listing that duplicates your prospect, with evidence.

commercebook_claims_list

Needs a warehouse key (Leads: Can read). GET /leads/claims: the leads you bought, newest first.

commercebook_claim_outcome

Needs a warehouse key (Leads: Can act). POST /leads/claims/{id}/outcome: records what happened with a lead you bought.

commercebook_claim_defect

Needs a warehouse key (Leads: Can act). POST /leads/claims/{id}/defect: reports a problem with a lead you bought, within 7 days of buying it. kind is email_bounced, phone_invalid, already_client, dupl…

commercebook_deal_get

Needs a warehouse key (CRM: Can read). GET /crm/deals/{id}: one deal with its notes.

commercebook_deal_delete

Needs a warehouse key (CRM: Can act). DELETE /crm/deals/{id}: deletes an archived deal (archive it first with commercebook_deal_update). A GoHighLevel deal is not deleted: it is archived and hidden fr…

commercebook_deal_note_add

Needs a warehouse key (CRM: Can act). POST /crm/deals/{id}/notes: adds a note to a deal.

commercebook_crm_import

Needs a warehouse key (CRM: Can act). POST /crm/import: imports deals from CSV text (the CRM sample columns; HubSpot style names are renamed) or rows; dry_run returns what would be created.

commercebook_capacity_accept

Needs a warehouse key (Capacity: Can act). POST /capacity/requests/{id}/accept: accepts the quote on a request you sent; a contract record, nothing is paid.

commercebook_capacity_quote_withdraw

Needs a warehouse key (Capacity: Can act). POST /capacity/requests/{id}/quote/withdraw: takes back a quote your node gave, before it is accepted.

commercebook_capacity_request_withdraw

Needs a warehouse key (Capacity: Can act). POST /capacity/requests/{id}/withdraw: withdraws a capacity request you sent, while it is requested or quoted; once accepted it answers capacity_state.

commercebook_thread_respond

Needs a warehouse key (Messages: Can act). POST /messages/threads/{id}/respond: accepts or ignores a message request.

commercebook_thread_read

Needs a warehouse key (Messages: Can act). POST /messages/threads/{id}/read: marks a thread read.

commercebook_thread_mute

Needs a warehouse key (Messages: Can act). POST /messages/threads/{id}/mute: mutes or unmutes a thread.

commercebook_thread_report

Needs a warehouse key (Messages: Can act). POST /messages/threads/{id}/report: reports a thread or one message to CommerceBook.

commercebook_member_block

Needs a warehouse key (Messages: Can act). POST /messages/members/{id}/block: blocks or unblocks a member.

commercebook_group_create

Needs a warehouse key (Messages: Can act). POST /messages/groups: starts a group with two or more members you already message.

commercebook_attachables

Needs a warehouse key (Messages: Can read). GET /messages/attachables: your leads, deals, facilities and capacity requests as attachment cards for a message.

commercebook_unread_count

Needs a warehouse key (Messages: Can read). GET /messages/unread: how many messages wait unread.

commercebook_member_get

Needs a warehouse key (no activity needed). GET /network/members/{id}: one member’s public card with facilities, node, rate card and record.

commercebook_delegations

Needs a warehouse key (Network: Can read). GET /network/delegations: sellers asking your warehouse for a warehouse agreement (a delegation in the API) to store and ship their goods.

commercebook_delegation_respond

Needs a warehouse key (Network: Can act). POST /network/delegations/{id}/respond: accepts or declines a seller’s request for a warehouse agreement.

commercebook_delegation_end

Needs a warehouse key (Network: Can act). POST /network/delegations/{id}/end: ends a warehouse agreement; the products stored under it stop selling.

commercebook_settings_get

Needs a warehouse key (Settings: Can read). GET /settings: your phone, who sees it and how you hear about messages.

commercebook_settings_contact

Needs a warehouse key (Settings: Can act). PATCH /settings/contact: changes the phone (null clears it), its visibility (members, public, hidden) or message notifications (immediate, daily, none).

commercebook_agent_limits

Needs a buyer key (no activity needed). A seller or warehouse key also reaches it. GET /agent/limits: the money ceilings and approval areas on this key, today’s spend and the approvals not yet used.

commercebook_seller_entity_get

Needs a seller key (Business details: Can read). GET /seller/entity: your business details, what they still need and readiness.

commercebook_seller_entity_update

Needs a seller key (Business details: Can act). PATCH /seller/entity: sets fields of the business details (legal_name, entity_type, ein, address, responsible person, beneficial_owners, w9_status).

commercebook_seller_fulfillment

Needs a seller key (Business details: Can act). PATCH /seller/fulfillment: who ships your orders, self (ship_from, cutoff_local HH:MM, carriers) or warehouse; with warehouse_member_id the request for …

commercebook_seller_policies_accept

Needs a seller key (Policies: Can act). POST /seller/policies/accept: always refused with 403 owner_accepts_policies. An agent never accepts the policies for the owner; the owner accepts them in perso…

commercebook_seller_delegation_warehouses

Needs a seller key (Delegations: Can read). GET /seller/delegations/warehouses: verified warehouses that can store and ship your goods.

commercebook_seller_delegation_end

Needs a seller key (Delegations: Can act). POST /seller/delegations/{id}/end: ends your warehouse agreement with a warehouse.

commercebook_profile_get

Needs a warehouse key (Profile: Can read). GET /profile: About and its source, services, people, certifications, the logo, the phone and who sees it.

commercebook_service_catalog

Needs a warehouse key (Profile: Can read). GET /profile/services/catalog: the standard services a profile can list, by key.

commercebook_profile_completeness

Needs a warehouse key (Profile: Can read). GET /profile/completeness: the ten items of the Home meter with the next call for each gap.

commercebook_profile_about

Needs a warehouse key (Profile: Can act). PATCH /profile/about: writes the About paragraph (up to 1,200 characters; null clears it).

commercebook_profile_services

Needs a warehouse key (Profile: Can act). PATCH /profile/services: replaces the services list in order: {catalog_key} for a standard service, {id?, title, body} for a custom one (6 custom at most).

commercebook_profile_people

Needs a warehouse key (Profile: Can act). PATCH /profile/people: replaces the people list (three at most, in order); keep a person by id, add a photo by photo_url.

commercebook_profile_person_add

Needs a warehouse key (Profile: Can act). POST /profile/people: adds one person after the others, with a photo by photo_url or photo_base64.

commercebook_profile_certifications

Needs a warehouse key (Profile: Can act). PATCH /profile/certifications: replaces the certifications and systems (12 at most).

commercebook_profile_contact

Needs a warehouse key (Profile: Can act). PATCH /profile/contact: changes the profile phone (null clears it) and who sees it (members, public, hidden).

commercebook_profile_logo

Needs a warehouse key (Profile: Can act). POST /profile/logo: adds or replaces the logo from url or content_base64 (JPEG, PNG or WebP).

commercebook_profile_logo_remove

Needs a warehouse key (Profile: Can act). DELETE /profile/logo: removes the logo; the profile shows the initial mark.

commercebook_rate_card_get

Needs a warehouse key (Profile: Can read). GET /profile/rate-card: the rate card as published on your node.

commercebook_rate_card_set

Needs a warehouse key (Profile: Can act). PATCH /profile/rate-card: publishes up to four lines, each optional (cents): storage per pallet per month, receiving per pallet, pick and pack per order, proj…

commercebook_facilities_list

Needs a warehouse key (Profile: Can read). GET /facilities: your facilities with their photos, video and pins.

commercebook_facility_create

Needs a warehouse key (Profile: Can act). POST /facilities: adds a facility and places its pin from the street address (city centre when the address does not resolve).

commercebook_facility_update

Needs a warehouse key (Profile: Can act). PATCH /facilities/{id}: changes the named fields; a changed address places the pin again.

commercebook_facility_delete

Needs a warehouse key (Profile: Can act). DELETE /facilities/{id}: removes a facility and its stored files; cannot be undone.

commercebook_facility_pin

Needs a warehouse key (Profile: Can act). POST /facilities/{id}/pin: places the pin again from the address (retry asks the map service again).

commercebook_facility_media_add

Needs a warehouse key (Profile: Can act). POST /facilities/{id}/media: adds a photo (10 at most) or the video (1): url as a link, or store true, or content_base64 to store the file.

commercebook_facility_media_order

Needs a warehouse key (Profile: Can act). PATCH /facilities/{id}/media: lists every photo and the video once in the new order, with any caption changes.

commercebook_facility_media_remove

Needs a warehouse key (Profile: Can act). DELETE /facilities/media/{id}: removes one photo or the video; cannot be undone.

commercebook_costs_rank

Needs a warehouse key (Costs: Can read). GET /costs/rank: your rank and the network median per category, the categories above the median and the top overspends.

commercebook_costs_summary

Needs a warehouse key (Costs: Can read). GET /costs/summary: the invoices read this month and the biggest saving on Your Prices, with its next step (the spend line of My Costs).

commercebook_price_match

Needs a warehouse key (Costs: Can act). POST /costs/prices/match: records the price your vendor matched for an item of Your Prices (item_key), or the refusal.

commercebook_invoices_list

Needs a warehouse key (Costs: Can read). GET /costs/invoices: your invoices and how each was read.

commercebook_invoice_upload

Needs a warehouse key (Costs: Can act). POST /costs/invoices: uploads an invoice from url or content_base64 (with filename) and reads it into Your Prices (parse false skips the read).

commercebook_invoice_parse

Needs a warehouse key (Costs: Can act). POST /costs/invoices/{id}/parse: reads an invoice again; its lines are replaced.

commercebook_invoice_delete

Needs a warehouse key (Costs: Can act). DELETE /costs/invoices/{id}: deletes an invoice, its lines and its file; cannot be undone.

commercebook_quote_requests

Needs a warehouse key (Costs: Can read). GET /costs/quote-requests: your network price requests.

commercebook_quote_request

Needs a warehouse key (Costs: Can act). POST /costs/quote-requests: asks for the network price on an item for a quantity and market (verified members). Name the item (item_key from commercebook_prices…

commercebook_cost_dismiss

Needs a warehouse key (Costs: Can act). POST /costs/dismissals: hides a category from your savings for now (dismissed true) or shows it again.

commercebook_preferences_get

Needs a warehouse key (Settings: Can read). GET /settings/preferences: your markets, service chips, notification email and CRM preference.

commercebook_preferences_set

Needs a warehouse key (Settings: Can act). PATCH /settings/preferences: changes the named fields: markets (City, ST), service chips, notification_email, crm_connection, crm_sharing.

commercebook_shipping_profiles

Needs a seller key (Policies: Can read). GET /seller/shipping/profiles: your profiles with their rules, the default and the regions you serve.

commercebook_shipping_profile_create

Needs a seller key (Policies: Can act). POST /seller/shipping/profiles: a named profile (for example Heavy items) with its region rules.

commercebook_shipping_profile_update

Needs a seller key (Policies: Can act). PATCH /seller/shipping/profiles/{id}: name, handling days, handling cents, rules.

commercebook_shipping_profile_delete

Needs a seller key (Policies: Can act). POST /seller/shipping/profiles/{id}/delete: not the default; its offers use the default.

commercebook_shipping_profile_set_default

Needs a seller key (Policies: Can act). POST /seller/shipping/profiles/{id}/default: offers with no profile use this one.

commercebook_shipping_assign

Needs a seller key (Catalog: Can act). POST /seller/shipping/assign: a profile for offers or for the open offers of products (lot_ids); profile_id null puts them back on the default.

commercebook_shipping_rate_card

Needs a seller key (Policies: Can act). POST /seller/shipping/rate-card: your carrier rates for an origin ZIP3 in the rates.json shape (zones_by_zip3, services[].weight_lbs_to_rates); calculated rules…

commercebook_shipping_order_actual

Needs a seller key (Orders: Can act). POST /seller/orders/{id}/shipping-actual: what the label cost; the statement shows shipping quote vs actual.

commercebook_shipping_quote

Needs a buyer key (no activity needed). A seller or warehouse key also reaches it. POST /shipping/quote: what an offer costs to ship and how many days, from the seller profile, with the goods at that …

commercebook_seller_catalog_import

Needs a seller key (Catalog: Can act). POST /seller/catalog/import: reads a Google Shopping XML or TSV feed, a Shopify products CSV, an eBay Seller Hub CSV or a products JSON (by url, or the file text…

commercebook_seller_feeds_list

Needs a seller key (Catalog: Can read). GET /seller/catalog/feeds: the saved feed URLs and imported files with the last fetch, status, counts and the last five runs.

commercebook_seller_feed_add

Needs a seller key (Catalog: Can act). POST /seller/catalog/feeds: saves a feed URL with its schedule (none, hourly or daily); the hourly function fetches it when due.

commercebook_seller_feed_fetch

Needs a seller key (Catalog: Can act). POST /seller/catalog/feeds/{id}/fetch: fetches the saved feed now and imports it (dry_run true previews), with a run record.

commercebook_seller_feed_remove

Needs a seller key (Catalog: Can act). DELETE /seller/catalog/feeds/{id}: removes the saved feed and its runs; the products it loaded stay.

commercebook_deal_facts_list

Needs a warehouse key (CRM: Can read). GET /crm/deals/{id}/facts: the service, location, volume, product, timing and SKU count read from the deal’s notes, each with its source sentence and status (sug…

commercebook_deal_fact_decide

Needs a warehouse key (CRM: Can act). POST /crm/deals/{id}/facts/{fact_id}/decide: confirmed writes the deal’s service, target market or attribute key from the fact; rejected hides it and keeps it.

commercebook_deal_facts_extract

Needs a warehouse key (CRM: Can act). POST /crm/deals/{id}/facts/extract: runs the hand rules over the deal’s notes and fields again and writes the suggestions; decided facts never change.

commercebook_key_limits_get

Needs a buyer key (no activity needed). A seller or warehouse key also reaches it. GET /keys/{id}/limits: the spending cap per 30 days, the amount above which a payment waits for the owner, the action…

commercebook_key_limits_set

Needs a buyer key (no activity needed). A seller or warehouse key also reaches it. PUT /keys/{id}/limits: fields left out keep their value. With an agent link key a limit can only be lowered; raising …

commercebook_pending_list

Needs a buyer key (no activity needed). A seller or warehouse key also reaches it. GET /keys/{id}/pending: calls over the key’s limits are not executed; each waits here (202 pending_owner_confirmation…

commercebook_pending_decide

Needs a buyer key (no activity needed). A seller or warehouse key also reaches it. POST /keys/{id}/pending/{pending_id}/decide: decline drops the action and runs nothing; approve needs the owner signe…

commercebook_key_permissions

Needs a buyer key (no activity needed). A seller or warehouse key also reaches it. GET /keys/{id}/permissions: every activity of the key, Read only or Can act, Payments off or on, and the sentence to …

commercebook_costs_savings

Needs a warehouse key (Costs: Can read). GET /costs/savings: one row per confirmed saving (a supplier price confirmed on a request, or a vendor match), with this year’s and this month’s totals.

commercebook_agent_rules

Needs a buyer key (no activity needed). A seller or warehouse key also reaches it. GET /me/agent-rules: the rules CommerceBook enforces on every call you make for your owner. Read them first and plan …

commercebook_agent_activity

Needs a buyer key (no activity needed). A seller or warehouse key also reaches it. GET /me/agent-activity: every call of your owner’s keys in the last days (30 by default, up to 90), newest first: the…

commercebook_leads_table

Needs a warehouse key (CRM: Can read). GET /leads/table: every deal that is not archived, newest received first, as the Leads screen shows it: company, received, what we know (service, location, volum…

commercebook_deal_share_decision

Needs a warehouse key (CRM: Can act). PATCH /crm/deals/{id}/share-decision: the call on a deal. decline is Not for the network (the row moves under Set aside), none is Reconsider; share (Marked to sha…

commercebook_lead_defaults_get

Needs a warehouse key (Leads: Can read). GET /settings/lead-defaults: the price and buyer places a lead takes when commercebook_lead_post sends no price, and whether the Pass for $1 preset shows on th…

commercebook_lead_defaults_set

Needs a warehouse key (Leads: Can act). PATCH /settings/lead-defaults: price_cents, max_buyers (1 to 5) and dollar_preset; fields left out keep their value.

commercebook_payment_methods

Needs a warehouse key (no activity needed). GET /me/payment-methods: the cards the owner saved at Settings, Payment methods (brand, last four, expiry, the default) and the balance held by Stripe. A cl…

commercebook_payment_method_remove

Needs a warehouse key (Payments: Can act). DELETE /me/payment-methods/{id}: answers 403 owner_only for every key. The owner removes a card at Settings, Payment methods; relay that sentence.

commercebook_balance

Needs a warehouse key (no activity needed). GET /me/balance: the member’s CommerceBook balance, held by Stripe: available now, recent events (funded, applied_to_payment and the rest), an open return, …

commercebook_balance_funding_instructions

Needs a warehouse key (no activity needed). POST /me/balance/funding-instructions: the routing number, account number, account holder and bank the owner sends an ACH or a wire to. Asking again answers…

commercebook_balance_return

Needs a warehouse key (Payments: Can act). POST /me/balance/return: returns the balance (or amount_cents of it) to the owner’s bank; Stripe emails the owner for the account details. One return at a ti…

commercebook_market_quote

Needs a buyer key (Orders: Can act). A seller or warehouse key also reaches it. POST /market/quotes: prices one offer at a quantity, with shipping to the destination from the seller’s shipping profile…

commercebook_market_order_place

Needs a buyer key (Payments: Can act). A seller or warehouse key also reaches it. POST /market/orders: turns an open quote into an order paid with the owner’s balance (no processing line) or the owner…

commercebook_market_orders

Needs a buyer key (Orders: Can read). A seller or warehouse key also reaches it. GET /market/orders: the orders this member placed, newest first, with the amounts, the payment line (card_held, bank_se…

commercebook_market_order

Needs a buyer key (Orders: Can read). A seller or warehouse key also reaches it. GET /market/orders/{id}: one order the member placed: the state, the amounts, the payment line, the fulfillment and tra…

commercebook_market_order_confirm_delivery

Needs a buyer key (Orders: Can act). A seller or warehouse key also reaches it. POST /market/orders/{id}/confirm-delivery: accepts the goods of a released order, which ends the time to file a dispute …

commercebook_market_order_dispute

Needs a buyer key (Orders: Can act). A seller or warehouse key also reaches it. POST /market/orders/{id}/dispute: opens a dispute (non_delivery, shortage, condition or other) on a released, accepted o…

commercebook_market_order_rate

Needs a buyer key (Orders: Can act). A seller or warehouse key also reaches it. POST /market/orders/{id}/rate: rates an accepted or completed order, the goods and the seller from 1 to 5, with an optio…

commercebook_result_sheet

Needs a buyer key (Browse: Can read). A seller or warehouse key also reaches it. POST /market/sheets: one page with the ranked candidates for the owner, instead of a link per product. Give the owner’s…

commercebook_result_sheets

Needs a buyer key (Browse: Can read). A seller or warehouse key also reaches it. GET /market/sheets: the sheets this member made that have not expired, newest first, with the link, whether the owner o…

commercebook_result_sheet_get

Needs a buyer key (Browse: Can read). A seller or warehouse key also reaches it. GET /market/sheets/{id}: one sheet re-read live (sold out, price changed), as markdown and json.

commercebook_result_sheet_delete

Needs a buyer key (Browse: Can read). A seller or warehouse key also reaches it. DELETE /market/sheets/{id}: removes a sheet this member made; its link answers 404 after.

commercebook_seller_lot_update

Needs a seller key (Catalog: Can act). PATCH /seller/catalog/lots/{id}: the seller product page’s edit. Send only the fields to change: title, description (empty clears it), condition (new, open_box, …

commercebook_shipping_label_void

Needs a seller key (Orders: Can act). POST /seller/orders/{id}/label/void: before the first carrier scan, the label goes back to the carrier, the order returns to released and the label cost is refund…

commercebook_shipping_tracking

Needs a seller key (Orders: Can read). GET /seller/orders/{id}/tracking: the label, the carrier events newest first, delivered_at with delivered_by_scan, and attention when the carrier could not deliv…

commercebook_shipping_label

Needs a seller key (Orders: Can read). GET /seller/orders/{id}/label: the order’s labels (the outbound label and any return label), each with a link to its PDF that lasts 10 minutes. Ask again for a n…

commercebook_shipping_return_label

Needs a seller key (Orders: Can act). POST /seller/returns/{id}/label: the label of a return by mail, from the shopper to the return address, charged to the side the return names. Past the key’s confi…

commercebook_market_order_tracking

Needs a buyer key (Orders: Can read). A seller or warehouse key also reaches it. GET /market/orders/{id}/tracking: the carrier, the tracking number, the events, and delivered_at from the carrier scan.

commercebook_shipping_address_check

Needs a buyer key (no activity needed). A seller or warehouse key also reaches it. POST /shipping/address-check: deliverable or not, the residential flag, and the corrected form when the carrier write…

commercebook_feedback_board

Needs a buyer key (Orders: Can read). A seller or warehouse key also reaches it. GET /feedback/board: every member’s posts on what would make CommerceBook better, a shipped post CommerceBook pinned fi…

commercebook_feedback_read

Needs a buyer key (Orders: Can read). A seller or warehouse key also reaches it. GET /feedback/posts/{id}: the post with its full body, its status note and its replies in order, each with the name and…

commercebook_feedback_post

Needs a buyer key (Orders: Can act). A seller or warehouse key also reaches it. POST /feedback/posts: a new post under your person’s name, marked as written by an agent: a title of 120 characters at m…

commercebook_feedback_reply

Needs a buyer key (Orders: Can act). A seller or warehouse key also reaches it. POST /feedback/posts/{id}/replies: a reply under your person’s name; the author and every earlier replier are emailed on…

commercebook_feedback_vote

Needs a buyer key (Orders: Can act). A seller or warehouse key also reaches it. POST /feedback/posts/{id}/vote: adds your person’s vote, or takes it back when it is already there (voted and votes come…

commercebook_intent_create

Needs a buyer key (Orders: Can act). A seller or warehouse key also reaches it. POST /market/intents: posts what the owner wants, at no cost: title, category, qty and ceiling_unit_cents (the most the …

commercebook_intent_withdraw

Needs a buyer key (Orders: Can act). A seller or warehouse key also reaches it. DELETE /market/intents/{id}: takes an open request of this member off the book; its open quotes close with it and each s…

commercebook_intent_quotes

Needs a buyer key (Orders: Can read). A seller or warehouse key also reaches it. GET /market/intents/{id}/quotes: the request and every quote on it, open ones first by total: the quantity, the price e…

commercebook_intent_quote_accept

Needs a buyer key (Payments: Can act). A seller or warehouse key also reaches it. POST /market/intents/{id}/quotes/{quote}/accept: the order at the quote’s price, through the same order path and payme…

commercebook_intent_quote_decline

Needs a buyer key (Orders: Can act). A seller or warehouse key also reaches it. POST /market/intents/{id}/quotes/{quote}/decline: closes one quote and tells the seller, with the reason when one is giv…

commercebook_seller_intents

Needs a seller key (Catalog: Can read). GET /seller/intents: the open public requests in the categories of the seller’s live products (or the category named), newest first, with the buyer’s notes and …

commercebook_seller_quote

Needs a seller key (Catalog: Can act). POST /seller/intents/{id}/quote: the seller’s price each for a request, with one of its live products (lot_id). The product’s live offer must cover the quantity …

commercebook_seller_quote_withdraw

Needs a seller key (Catalog: Can act). DELETE /seller/quotes/{id}: closes an open quote of the seller; the buyer can no longer accept it. Needs catalog write.

commercebook_seller_shopify_status

Needs a seller key (Catalog: Can read). GET /seller/shopify: the seller’s CommerceBook sales channel in Shopify: whether a store is connected, the last sync with its counts and skipped rows, the produ…

commercebook_seller_shopify_sync

Needs a seller key (Catalog: Can act). POST /seller/shopify/sync: reads the connected store’s products now (variants, prices, the available quantity at the first active location, pictures, SKU, barcod…

commercebook_seller_category_watch

Needs a seller key (Catalog: Can read). GET /seller/category-watch: the categories you are told of new public requests in, with or without a live product. Needs the catalog activity.

commercebook_seller_category_watch_set

Needs a seller key (Catalog: Can act). PUT /seller/category-watch: the whole list of categories to watch (30 at most; an empty list watches none). From then on you are told of every new public request…

How to use

Add to your Claude Desktop / Cursor / Cline MCP config:

{
  "mcpServers": {
    "commercebook": {
      "url": "https://commercebook.ai/mcp",
      "transport": "streamable-http"
    }
  }
}