Agents & MCP
MCP tools
Every commerce tool exposed to AI agents over the Model Context Protocol, generated from the live tool catalog.
The MCP server exposes commerce tools so AI assistants can browse, quote, and check out. Every tool needs one scope; a credential only sees — and can only call — the tools its scopes allow. This list is generated from the same catalog the server is built from.
Outside credentials for the MCP server are issued per customer, on request. See Ready for AI shopping assistants (/agent-ready) for the status and the security model.
Commerce tools
Search, quote, cart, checkout, orders, returns, and account tools for a buyer, an assistant acting for a buyer, or your staff. Tools marked “needs confirmation” change something and should be confirmed by a person; an AI assistant placing an order also needs a spending limit (mandate) a person issued.
| Tool | What it does | Scope | Notes |
|---|---|---|---|
| search_catalog | Search catalog | catalog:read | read-only |
| get_product | Get product | catalog:read | read-only |
| check_availability | Check availability | catalog:read | read-only |
| quote_line_with_substitution | Quote a line (auto-substitute if short) | orders:quote | read-only |
| place_quoted_order | Place the quoted order | orders:write | needs confirmation |
| quote_basket | Quote a whole basket (multi-line, auto-substitute) | orders:quote | read-only |
| place_basket_order | Place a whole basket order | orders:write | needs confirmation |
| reorder_from_history | Reorder from history ("same as last time") | orders:quote | read-only |
| compare_shipping_rates | Compare carrier shipping rates | shipping:read | read-only |
| record_substitution_decision | Record a substitution decision (learning) | orders:quote | — |
| request_quote | Request a quote (from RFQ text) | orders:quote | — |
| get_quote | Get quote | orders:quote | read-only |
| create_checkout_intent | Create checkout intent | orders:write | — |
| issue_purchase_mandate | Issue purchase mandate (AP2) | mandate:issue | needs confirmation |
| authorize_checkout | Authorize checkout (mandate-gated) | mandate:spend | needs confirmation |
| check_credit | Check trade credit | credit:read | read-only |
| find_substitutes | Find substitutes | catalog:read | read-only |
| checkout_start | Start checkout | orders:write | — |
| checkout_update | Update checkout | orders:write | — |
| checkout_review | Review checkout | orders:read | read-only |
| checkout_place | Place checkout order | orders:write | needs confirmation |
| checkout_cancel | Cancel checkout | orders:write | — |
| list_orders | List my orders | orders:read | read-only |
| get_order | Get order | orders:read | read-only · endpoint pending |
| cancel_order | Cancel order | orders:write | needs confirmation · endpoint pending |
| start_return | Start a return | returns:write | needs confirmation |
| list_returns | List returns | orders:read | read-only |
| get_ship_to | Get ship-to address | account:read | read-only |
| list_payment_methods | List saved payment methods | account:read | read-only |
| get_account | Get my account | account:read | read-only |
| find_tools | Find tools | meta:discover | read-only |
Back-office tools
Operator-only tools: the supervised agents’ actions and the finance co-pilots. Their scopes are stripped from buyer and AI-agent credentials.
| Tool | What it does | Scope | Notes |
|---|---|---|---|
| fulfill_order | Fulfill an order (buy shipping label) | orders:fulfill | needs confirmation |
| pricing_guidance | Pricing guidance | pricing:read | read-only |
| get_collections_account | Get collections account | finance:read | read-only |
| get_collections_overdue | List overdue receivables | finance:read | read-only |
| approve_purchase_order | Approve purchase order | ops:write | — |
| issue_credit_line | Issue trade-credit line | finance:write | — |
| log_collections_activity | Log collections activity | finance:write | — |
| execute_replenishment | Draft replenishment POs | sourcing:write | — |
| apply_cash_remittance | Apply cash remittance | finance:write | — |
| issue_rfq_quote | Issue RFQ quote | pricing:write | — |
| resolve_order_exception | Resolve order exception | ops:write | — |
| award_sourcing_event | Award sourcing event | sourcing:write | — |
| reprice_listing | Reprice listing | pricing:write | — |
| nudge_seller | Nudge seller | ops:write | — |
| record_studio_flag | Record Studio agent flag | ops:write | — |
| ap_exception_worklist | AP exception worklist | finance:read | read-only |
| ap_exception_triage | Triage one AP invoice | finance:read | read-only |
| ap_exception_apply | Apply an AP disposition | finance:write | needs confirmation |
| margin_leak_analysis | Margin-leak analysis | finance:read | read-only |
| collections_worklist | Collections worklist | finance:read | read-only |
| collections_cash_apply_preview | Cash-application preview | finance:read | read-only |
| collections_apply_receipt | Apply a cash receipt | finance:write | needs confirmation |
| ap_control_scan | AP controls / anomaly scan | finance:read | read-only |
| revenue_waterfall | Deferred-revenue waterfall | finance:read | read-only |
| recognize_revenue | Run revenue recognition | finance:write | needs confirmation |
Every tool call is authorized and checked server-side, and recorded in the audit trail. A caller can only do what its tenant, actor, and scopes permit.