mcp-gateway
Server Details
Agentic commerce gateway: discovery, trust and checkout. Demo store; x402 sandbox, AP2 planned.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 18 tools
The set runs two parallel checkout flows (standard and UCP) with near-duplicate pairs: create_cart vs ucp_create_checkout, preview_checkout vs ucp_preview_checkout, complete_checkout vs ucp_complete_checkout, get_checkout_state vs ucp_get_checkout, and select_shipping_option vs ucp_update_checkout. Descriptions repeatedly say 'use ONLY for sessions created with ucp_create_checkout', which prevents outright confusion, but an agent must track which flow it started to pick correctly. preview_checkout vs quote_checkout is well delineated, and receipt tools are distinct.
Names are consistently snake_case with verb_noun ordering (create_cart, get_shipping_rates, apply_discount, complete_checkout), and the ucp_ prefix is used uniformly as a flow namespace. Minor deviations like ucp_add_items_to_checkout and the mixed get_/verify_/create_ verbs on receipt tools are readable but slightly uneven.
18 tools is at the heavy end for a single checkout domain, and roughly seven of them exist only to duplicate the standard flow under the UCP protocol. Each tool is individually justified, but the duplicated surface pushes the set beyond a comfortably scannable size.
The purchase lifecycle is well covered end to end: credential, cart, shipping rates, shipping selection, discount, quote, preview, complete, receipt, and receipt verification. The notable asymmetry is that the UCP flow supports adding items, updating, and canceling a session while the standard flow has no equivalent item-edit or cancel tool, leaving a gap if a cart needs modification.
Available Tools
18 toolsapply_discountAIdempotentInspect
Apply a discount or promo code to the cart. Checkout guide: read the MCP resource trusteed://guides/checkout. CREDENTIAL: this store needs one. Call the create_sandbox_key tool first (it is in this tool list and needs no credential), then pass the key you get back as the agent_key argument — or as an Authorization: Bearer header if your client can set headers. Do not ask a person to log in: there is no human login for this store.
Inputs: cart_id (required), source, agent_key, discount_code, +2 more. Returns: cart_id, currency, discount_code, discount_cents, +1 more
complete_checkoutAIdempotentInspect
Complete the purchase. Provide buyer.name and buyer.email from the conversation before opening approval; ask in chat if either is missing. The approval page only reviews these details. PREFER THE CART CARD: if there is an interactive card for this cart, let the buyer confirm and (when the store offers a choice) pick the payment method there — including retrying after a declined payment or switching method — instead of calling this tool yourself. Each call you make here opens a new card in the transcript instead of updating the one already open. Only call it yourself when there is no interactive card or the buyer explicitly asks you to complete it in chat. Idempotent — replay is keyed on checkout_session_id: any retry against a session that already has an order returns that same order (COMPLETED or PENDING_EXTERNAL_CONFIRMATION) without re-charging. The provided idempotency_key is recorded on the session for audit and short-circuits a repeated call with the same key.
If the response has status PENDING_EXTERNAL_CONFIRMATION, no purchase has completed yet: read order_placed and next_action — a person has to approve or pay at its url; next_action says whether calling again with the same checkout_session_id and idempotency_key can read the outcome. KYAPAY (payment_method=KYAPAY or a kyapay_token): charging with KYApay is not available. KYApay is identity verification here, not a payment rail, so the call is rejected with PAYMENT_METHOD_NOT_CONFIGURED before anything is charged or written; use another payment method. The Skyfire KYA token serves identity on the REST API, not payment in this tool. On demo-store the approval step records a confirmation but does not verify that a human gave it. PAYMENT MANDATE: this tool also requires one, issued by the platform, not written by you. Call preview_checkout for this cart, open the approval_url it returns, poll approval_status_url with your agent credential, and send the mandate you receive as the payment_mandate argument or an X-Payment-Mandate header. The approval is bound to your agent credential and the cart; it does not verify that a person was present. Checkout guide: read the MCP resource trusteed://guides/checkout. CREDENTIAL: this store needs one. Call the create_sandbox_key tool first (it is in this tool list and needs no credential), then pass the key you get back as the agent_key argument — or as an Authorization: Bearer header if your client can set headers. Do not ask a person to log in: there is no human login for this store.
Inputs: idempotency_key (required), checkout_session_id (required), buyer, agent_key, +8 more. Returns: status, details, currency, order_id, +16 more
create_cartAIdempotentInspect
Create a shopping cart in Demo Store. Returns a cart_id. Pass it as cart_id to get_shipping_rates, select_shipping_option, apply_discount and preview_checkout; complete_checkout and get_trust_receipt take the same value as checkout_session_id.
KYA IDENTITY: a Skyfire kya token has no effect on this tool (it grants no trust boost here); KYA identity applies to the REST agent API (Authorization: Bearer), not to the MCP tools. Checkout guide: read the MCP resource trusteed://guides/checkout. CREDENTIAL: this store needs one. Call the create_sandbox_key tool first (it is in this tool list and needs no credential), then pass the key you get back as the agent_key argument — or as an Authorization: Bearer header if your client can set headers. Do not ask a person to log in: there is no human login for this store.
Inputs: items (required), agent_key, agent_token, buyer_intent, +3 more. Returns: items, status, cart_id, currency, +9 more
create_sandbox_keyAInspect
Get a temporary sandbox credential for this demo store, valid 24h. Present it as an Authorization: Bearer header, or — when your client cannot set headers — as the agent_key argument of the checkout tools. Payments here are simulated: this credential settles nothing and works only on the demo store. No human login is involved at any point.
Inputs: no named parameters.
get_checkout_stateARead-onlyIdempotentInspect
Read the current state of a cart created with create_cart: status, lines, totals, selected shipping, when it was previewed, its order if one exists and a pointer to get_trust_receipt. Read-only: it changes nothing and does not open any approval. Use it to resume a purchase; for UCP checkouts use ucp_get_checkout. Checkout guide: read the MCP resource trusteed://guides/checkout.
Inputs: cart_id (required), agent_key.
get_shipping_ratesAInspect
Get available shipping rates for the cart. Requires shipping_address — pass it in the call. If the buyer requests the cheapest option, use cheapest_shipping_handle when non-null; it is null when rates cannot be compared in the cart currency. Rates marked authoritative=false are estimates, not the final charge.
PREFER THE CART CARD: if create_cart returned an interactive card (the buyer can see and click it), let them enter the address and pick shipping there instead of calling this tool yourself — each top-level call you make here opens a new card in the transcript instead of updating the one already open. Only call it yourself when there is no interactive card (text-only client) or the buyer explicitly asks you to handle it in chat. Checkout guide: read the MCP resource trusteed://guides/checkout. CREDENTIAL: this store needs one. Call the create_sandbox_key tool first (it is in this tool list and needs no credential), then pass the key you get back as the agent_key argument — or as an Authorization: Bearer header if your client can set headers. Do not ask a person to log in: there is no human login for this store.
Inputs: cart_id (required), agent_key, shipping_address. Returns: rates, cart_id, address_city, address_country, +1 more
get_trust_receiptARead-onlyIdempotentInspect
Retrieve the signed trust receipt for a checkout. A receipt records the complete_checkout call; read order_placed before telling anyone a purchase happened. Returns the receipt id, the JWS signature and how to verify it. Issuance is asynchronous: right after complete_checkout this may answer status: "pending" with a retry delay. pending with code receipt_pending means the purchase completed and the receipt is on its way; checkout_in_progress means the complete_checkout call is still running. Only the credential that made the purchase can read its receipt. A receipt attests that the call happened, not that money moved: read settlement (it is not_attested unless the payment rail confirmed it). PREFER THE CART CARD: if the purchase was completed on an interactive card, it already fetches and shows this receipt itself right after the order — calling this tool yourself right after is usually redundant and opens a new card in the transcript. Call it yourself only when there is no interactive card, or the buyer asks for the receipt later in a new turn. Checkout guide: read the MCP resource trusteed://guides/checkout.
Inputs: order_id, agent_key, checkout_session_id. Returns: jws, code, docs, status, +13 more
preview_checkoutAInspect
Preview the complete order summary before payment. Advances the session to ready-for-payment state. If you only need the price, call quote_checkout instead: it computes the same total without advancing the session or opening an approval.
PREFER THE CART CARD: if there is an interactive card for this cart, let it compute and show the summary instead of calling this tool yourself — it keeps the flow in one card. Checkout guide: read the MCP resource trusteed://guides/checkout. CREDENTIAL: this store needs one. Call the create_sandbox_key tool first (it is in this tool list and needs no credential), then pass the key you get back as the agent_key argument — or as an Authorization: Bearer header if your client can set headers. Do not ask a person to log in: there is no human login for this store.
Inputs: cart_id (required), agent_key, buyer_intent, payment_mandate. Returns: items, status, currency, next_step, +21 more
quote_checkoutARead-onlyIdempotentInspect
Read-only price quote. Does not advance the session, open approvals or enable payment. To pay, call preview_checkout.
Computes the same totals as preview_checkout for this cart (subtotal, shipping, discount, tax status, total_is_final), with status QUOTE_ONLY, but not the same checks: it does not check your payment mandate's spending cap; preview_checkout does. Read-only on Trusteed's side: where the store prices orders on its own platform (WooCommerce), the store builds a temporary cart to compute the quote and discards it. Checkout guide: read the MCP resource trusteed://guides/checkout.
Inputs: cart_id (required), agent_key.
select_shipping_optionAIdempotentInspect
Select a shipping method for the cart. Must call get_shipping_rates first and provide idempotency_key. Reuse the same key for retries of the same cart and option; use a new key if either changes.
PREFER THE CART CARD: if there is an interactive card for this cart, let the buyer pick shipping there instead of calling this tool yourself — it keeps the flow in one card instead of opening a new one per step. Checkout guide: read the MCP resource trusteed://guides/checkout. CREDENTIAL: this store needs one. Call the create_sandbox_key tool first (it is in this tool list and needs no credential), then pass the key you get back as the agent_key argument — or as an Authorization: Bearer header if your client can set headers. Do not ask a person to log in: there is no human login for this store.
Inputs: cart_id (required), shipping_handle (required), agent_key, idempotency_key. Returns: cart_id, currency, total_cents, selected_title, +5 more
ucp_add_items_to_checkoutAIdempotentInspect
Append line items to an existing incomplete UCP checkout session. If a product_id already exists its quantity is incremented; new product_ids are appended. Use instead of ucp_update_checkout when you want to preserve existing items. Use ONLY for sessions created with ucp_create_checkout; for the standard flow use create_cart. Checkout guide: read the MCP resource trusteed://guides/checkout.
Inputs: line_items (required), checkout_id (required), meta, agent_key, +2 more.
ucp_cancel_checkoutADestructiveIdempotentInspect
Cancel a UCP checkout session. Transitions to 'canceled' status. Cannot cancel already completed checkouts. Use ONLY for a checkout session created with ucp_create_checkout (Universal Commerce Protocol); for the standard flow (create_cart, preview_checkout, complete_checkout) do not call this tool. Checkout guide: read the MCP resource trusteed://guides/checkout.
Inputs: checkout_id (required), reason, agent_key, idempotency_key.
ucp_complete_checkoutAIdempotentInspect
Complete a UCP checkout session. Transitions to 'completed' status. Idempotent — safe to retry with the same idempotency_key. Use ONLY for a checkout session created with ucp_create_checkout (Universal Commerce Protocol); for the standard flow (create_cart, preview_checkout, complete_checkout) do not call this tool. For a cart built with create_cart use complete_checkout. PAYMENT MANDATE: this tool also requires one, issued by the platform, not written by you. Call preview_checkout for this cart, open the approval_url it returns, poll approval_status_url with your agent credential, and send the mandate you receive as the payment_mandate argument or an X-Payment-Mandate header. The approval is bound to your agent credential and the cart; it does not verify that a person was present. Checkout guide: read the MCP resource trusteed://guides/checkout.
Inputs: checkout_id (required), idempotency_key (required), ap2, meta, +8 more.
ucp_create_checkoutAIdempotentInspect
Create a UCP (Universal Commerce Protocol) checkout session from line items. Returns a UCP checkout object with status 'incomplete'. Starts the UCP flow (ucp_* tools); for the standard flow use create_cart instead. Do not mix the two flows on the same purchase. Checkout guide: read the MCP resource trusteed://guides/checkout.
Inputs: currency (required), line_items (required), meta, buyer, +5 more.
ucp_get_checkoutARead-onlyIdempotentInspect
Retrieve a UCP checkout session by ID. Returns the current state of the checkout. Use ONLY for a checkout session created with ucp_create_checkout (Universal Commerce Protocol); for the standard flow (create_cart, preview_checkout, complete_checkout) do not call this tool. Checkout guide: read the MCP resource trusteed://guides/checkout.
Inputs: checkout_id (required), meta, agent_key.
ucp_preview_checkoutAInspect
Preview a UCP checkout and move it to ready-for-payment. Call after destination and shipping are set, before ucp_complete_checkout. Use ONLY for a checkout created with ucp_create_checkout. Checkout guide: read the MCP resource trusteed://guides/checkout.
Inputs: checkout_id (required), meta, agent_key, payment_mandate, +1 more.
ucp_update_checkoutAIdempotentInspect
Update a UCP checkout session. Send line_items to replace all lines (each line may name a variant_id), and/or fulfillment to set the delivery address (fulfillment.destination, which returns the shipping options) and choose one (fulfillment.selected_option_id, which adds shipping to the totals). Only allowed when status is 'incomplete'. Use ONLY for sessions created with ucp_create_checkout; for the standard flow use create_cart and select_shipping_option. Checkout guide: read the MCP resource trusteed://guides/checkout.
Inputs: checkout_id (required), meta, buyer, currency, +5 more.
verify_trust_receiptARead-onlyIdempotentInspect
Check a trust receipt's signature, revocation and chain coverage from inside this session (v1.0 receipts only; other profiles answer unsupported_profile, not invalid). LIMIT: the issuer verifies its own receipt (verified_by: issuer, independent: false), so this is a consistency check, not proof to a third party; independent_verification tells you how to verify it yourself against the public JWKS. Pass the jws from get_trust_receipt. Checkout guide: read the MCP resource trusteed://guides/checkout.
Inputs: jws (required), agent_key.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Agentic commerce network: discover sellers and products, negotiate, and pay USDC on Base via x402.
Multi-seller shopping for AI agents. Settle via Stripe MPP or x402 USDC on Base. Hosted.
Multi-seller shopping for AI agents. Settle via Stripe MPP or x402 USDC on Base. Hosted.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to perform e-commerce operations through a standardized interface implementing the x402 and Agentic Commerce Protocol (ACP). Supports merchant sessions, product search, and payment orchestration with production-ready security features.-
- AlicenseNot gradedqualityCmaintenanceAn agentic commerce MCP gateway that lets assistants search a catalog, build a cart, place orders, track them, and issue refunds. It adds saga-style compensation for multi-step checkout, idempotency so retries can't double-charge, and a Postgres audit log of every tool call.Apache 2.0
- FlicenseNot gradedqualityCmaintenanceProvides paid and free tools for AI agents to buy from or sell to other agents over x402, including discovering sellers, verifying on-chain payment histories, running test purchases, and registering sellers for audited listings.-
- AlicenseBqualityDmaintenanceMachine-readable merchant verification infrastructure for AI shopping agents and agentic commerce systems.14MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.