CommerceBook
Search and buy products from sellers and verified warehouses, sell surplus stock, post requests.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"commercebook": {
"url": "https://commercebook.ai/mcp"
}
}
}Puntos de conexión remotos
https://commercebook.ai/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (6)
🟢commercebook_start(action, role)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"briefing",
"whoami",
"me",
"standing",
"openapi"
],
"description": "The action to run (briefing when left out).",
"default": "briefing"
},
"role": {
"description": "For briefing. The briefing to return: buyer, seller or warehouse. Left out: buyer without a key, the key’s own kind with a key.",
"type": "string",
"enum": [
"buyer",
"seller",
"warehouse"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢commercebook_market(action, q, category, min_price, max_price, ...)
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. - 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. - shipping_estimate (no key): the lowest and highest shipping of one product to a state. - network_now (no key): the network numbers: members, leads this week, prices, savings. Send action and its arguments.
Esquema de entrada
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"book",
"search",
"product",
"seller",
"requests",
"reach",
"shipping_estimate",
"network_now"
],
"description": "The action to run."
},
"q": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "string",
"maxLength": 200
}
],
"description": "For search, requests. Words; each must match a whole word of the title, brand, part number or description (a plural ending s or es matches too)."
},
"category": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "string",
"pattern": "^[a-z][a-z0-9_]{1,59}$"
},
{
"type": "string",
"pattern": "^[a-z][a-z0-9_]{1,59}$"
}
],
"description": "For search, requests, reach. A category key, exact (for example packaging, tools, home_garden). commercebook_market_book lists every key with its products and open requests."
},
"min_price": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "For search."
},
"max_price": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "For search."
},
"state": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z]{2}$"
},
{
"type": "string",
"pattern": "^[A-Za-z]{2}$"
}
],
"description": "For search, shipping_estimate. Two-letter state the goods ship to."
},
"condition": {
"type": "string",
"maxLength": 40,
"description": "For search."
},
"limit": {
"anyOf": [
{
"type": "integer",
"minimum": 1,
"maximum": 100
},
{
"type": "integer",
"minimum": 1,
"maximum": 200
}
],
"description": "For search, requests."
},
"lot_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
],
"description": "For product, shipping_estimate. The lot_id of a search item."
},
"seller_slug": {
"description": "For seller. The seller_slug of a search item or a product.",
"type": "string",
"minLength": 1,
"maxLength": 200,
"pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?$"
},
"slug": {
"description": "For seller. The older name of seller_slug, still accepted.",
"type": "string",
"minLength": 1,
"maxLength": 200,
"pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?$"
},
"qty": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991,
"description": "For reach, shipping_estimate."
},
"destination_state": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "For reach. A two-letter state."
}
},
"required": [
"action"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢commercebook_capabilities(action, group)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"seller"
],
"description": "The action to run (seller when left out).",
"default": "seller"
},
"group": {
"description": "For seller. One group only; left out, every group.",
"type": "string",
"enum": [
"ways_to_offer",
"ways_to_be_found",
"ways_to_be_paid",
"what_the_record_shows",
"rules",
"first_steps"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡commercebook_feedback(action, about, what_happened, what_would_help, rating, ...)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"send",
"board",
"read",
"post",
"reply",
"vote"
],
"description": "The action to run (send when left out).",
"default": "send"
},
"about": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "For send. A tool name (for example commercebook_shipping_quote) or a page (for example /feeds)."
},
"what_happened": {
"type": "string",
"maxLength": 4000,
"description": "For send."
},
"what_would_help": {
"type": "string",
"maxLength": 4000,
"description": "For send."
},
"rating": {
"type": "integer",
"minimum": 1,
"maximum": 5,
"description": "For send."
},
"sort": {
"type": "string",
"enum": [
"votes",
"newest"
],
"description": "For board."
},
"kind": {
"description": "For board. Only the posts of members of this kind.",
"type": "string",
"enum": [
"warehouse",
"seller",
"buyer"
]
},
"post_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "For read, reply, vote."
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "For post."
},
"body": {
"anyOf": [
{
"type": "string",
"maxLength": 4000
},
{
"type": "string",
"minLength": 1,
"maxLength": 4000
}
],
"description": "For post, reply."
},
"page": {
"description": "For post. The page or the tool it is about, for example /warehouse/leads.",
"type": "string",
"maxLength": 500
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡commercebook_account_start(action, email, kind, company, contact_name, ...)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"signup",
"confirm"
],
"description": "The action to run."
},
"email": {
"anyOf": [
{
"type": "string",
"minLength": 3,
"maxLength": 254
},
{
"type": "string",
"minLength": 3,
"maxLength": 254
}
],
"description": "For every action. The owner’s email; the code goes there."
},
"kind": {
"type": "string",
"enum": [
"warehouse",
"seller",
"buyer"
],
"description": "For signup."
},
"company": {
"description": "For signup. The business name. Required for a warehouse or a seller; optional for a buyer.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"contact_name": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "For signup. The owner’s name."
},
"address": {
"description": "For signup. A warehouse: the street address of its first facility.",
"type": "string",
"maxLength": 400
},
"city": {
"type": "string",
"maxLength": 120,
"description": "For signup."
},
"state": {
"type": "string",
"maxLength": 40,
"description": "For signup."
},
"services": {
"maxItems": 30,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"description": "For signup."
},
"sqft": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "For signup."
},
"code": {
"type": "string",
"pattern": "^\\d{8}$",
"description": "For confirm."
}
},
"required": [
"action"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢commercebook_tool_search(query, role, limit)
Plain words to the tool and action that do it, with the arguments: for example "ship an order", "post a request", "watch a category". No key needed. role (buyer, seller, warehouse or all) ranks that role's tools first. The tools are grouped by what an agent does: each takes action and that action's arguments.
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "What you are trying to do, in plain words."
},
"role": {
"description": "Rank the tools of this role first.",
"type": "string",
"enum": [
"buyer",
"seller",
"warehouse",
"all"
]
},
"limit": {
"description": "How many matches (3 by default).",
"type": "integer",
"minimum": 1,
"maximum": 10
}
},
"required": [
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Comunidad
Evidencia