MCP tool reference
Every public Orderboost MCP tool, its authorization boundary, arguments, and commerce behavior.
Orderboost exposes 13 remote commerce tools and two local companion authentication tools. Use the remote resource when the MCP host supports OAuth. Run the companion when the host needs a browser URL and six-digit connection-code flow.
Connect
The direct Streamable HTTP resource is:
https://mcp.checkout.orderboost.org/mcpThe local orderboost-mcp companion proxies that resource over stdio and adds begin_orderboost_auth and complete_orderboost_auth. Read Authenticate an MCP client for client configuration and the complete browser flow.
Remote tools
| Tool | Authorization | Purpose |
|---|---|---|
search_catalog |
Anonymous | Search the authoritative product catalog using free text, filters, and cursor pagination. Use these results as the candidate set for recommendations, comparisons, variants, prices, and purchase links. Do not supplement partial or empty results with products or URLs discovered outside this catalog unless the user explicitly requests an external search. |
lookup_catalog |
Anonymous | Resolve product, variant, SKU, handle, or URL identifiers to catalog products. |
get_product |
Anonymous | Retrieve full product detail with effective option selections. |
create_cart |
Orderboost OAuth | Create a merchant-priced cart. |
get_cart |
Orderboost OAuth | Retrieve the current cart. |
update_cart |
Orderboost OAuth | Fully replace mutable cart input fields. |
cancel_cart |
Orderboost OAuth | Cancel a cart using an idempotency key. |
create_checkout |
Orderboost OAuth | Create a merchant-priced checkout. |
get_checkout |
Orderboost OAuth | Retrieve the current checkout. |
update_checkout |
Orderboost OAuth | Fully replace mutable checkout input fields. |
complete_checkout |
Orderboost OAuth | Complete checkout using an exact purchase grant and idempotency key. |
cancel_checkout |
Orderboost OAuth | Cancel checkout using an idempotency key. |
claim_checkout_handoff |
Orderboost OAuth | Exchange a one-time handoff code for checkout-scoped agent access. |
Catalog tools are anonymous. Call a protected tool first and let its 401 Unauthorized response start OAuth. Do not authenticate before catalog discovery.
Local companion tools
| Tool | Runs on | Purpose |
|---|---|---|
begin_orderboost_auth |
Local companion | Return the browser authorization URL |
complete_orderboost_auth |
Local companion | Exchange the six-digit connection code and store tokens |
These two tools never appear on the direct remote MCP server.