# xyz.trusteed/mcp-gateway (remote · api.trusteed.xyz)

Agentic commerce gateway: discovery, trust and checkout. Demo store; x402 sandbox, AP2 planned.

- Trust score: 65/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- remote · `api.trusteed.xyz`: 65/100 (this document), [markdown](https://verifymcp.io/servers/xyz-trusteed-mcp-gateway/demo-store-mcp-checkout.md), [page](https://verifymcp.io/servers/xyz-trusteed-mcp-gateway/demo-store-mcp-checkout)
- remote · `api.trusteed.xyz`: 67/100, [markdown](https://verifymcp.io/servers/xyz-trusteed-mcp-gateway/demo-store-mcp-discovery.md), [page](https://verifymcp.io/servers/xyz-trusteed-mcp-gateway/demo-store-mcp-discovery)

## Channel facts

- Endpoint: `https://api.trusteed.xyz/demo-store/mcp/checkout`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.1.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Endpoint Security**: 57/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: this server exposes a tool marked destructive (ucp_cancel_checkout) and its handshake is open, but we could not confirm whether a tool call is gated, so we do not assert it is callable unauthenticated.
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 75/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 7375 tokens (~273/item across 27 items; 18 tools + 9 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 7/100
  - Stability observed for 2 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (39% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 18 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 20 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.
  - Supports UI / widget rendering.

## Install

### How do I install the xyz.trusteed/mcp-gateway server?

xyz.trusteed/mcp-gateway is a hosted endpoint at https://api.trusteed.xyz/demo-store/mcp/checkout, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http xyz-trusteed-mcp-gateway 'https://api.trusteed.xyz/demo-store/mcp/checkout'
```

### Cursor

```json
{
  "mcpServers": {
    "xyz-trusteed-mcp-gateway": {
      "url": "https://api.trusteed.xyz/demo-store/mcp/checkout"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "xyz-trusteed-mcp-gateway": {
      "type": "http",
      "url": "https://api.trusteed.xyz/demo-store/mcp/checkout"
    }
  }
}
```

### Codex

```toml
[mcp_servers.xyz-trusteed-mcp-gateway]
url = "https://api.trusteed.xyz/demo-store/mcp/checkout"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "xyz-trusteed-mcp-gateway": {
      "type": "remote",
      "url": "https://api.trusteed.xyz/demo-store/mcp/checkout",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add xyz-trusteed-mcp-gateway --url 'https://api.trusteed.xyz/demo-store/mcp/checkout' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  xyz-trusteed-mcp-gateway:
    url: "https://api.trusteed.xyz/demo-store/mcp/checkout"
```

### Netclaw

```json
{
  "McpServers": {
    "xyz-trusteed-mcp-gateway": {
      "Transport": "http",
      "Url": "https://api.trusteed.xyz/demo-store/mcp/checkout"
    }
  }
}
```

### Vellum

```bash
assistant mcp add xyz-trusteed-mcp-gateway -t streamable-http -u 'https://api.trusteed.xyz/demo-store/mcp/checkout'
```

### Other

```json
{
  "mcpServers": {
    "xyz-trusteed-mcp-gateway": {
      "type": "http",
      "url": "https://api.trusteed.xyz/demo-store/mcp/checkout"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-20 (score 65, +1)

- [functional improvement] Stability: unverified → 0.03
- [functional] Server version: 1.0.0+tools.c88ec5a2 → 1.0.0+tools.6de0776c
- [functional] New tool “ucp_add_items_to_checkout”

### 2026-11-19 (score 64)

First indexed and scored.

## MCP tools (18)

### `create_cart` (~517 tokens)

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.

Input parameters:

- `agent_key` (string): Sandbox credential from `create_sandbox_key`. Use this when your client cannot set an `Authorization: Bearer` header.
- `agent_session_id` (string): Opaque agent session identifier for cart resume across sessions
- `agent_token` (string): JWS compact (EdDSA/Ed25519) signed by the agent. Required for Shopify enforcement rules R001/R002/R004. A malformed token fails with AGENT_TOKEN_INVALID on any platform. On Shopify stores Trusteed al…
- `buyer_intent`: Optional. What the person asked for, as structured constraints with who said each one (user_stated or agent_inferred) and the substitution policy. The store may compare it with the cart when it enabl…
- `display_context` (string): Agent display capability: webview (browser) or headless
- `idempotency_key` (string): REQUIRED for this write unless sent as the `Idempotency-Key` header or `params._meta["trusteed/idempotency-key"]`. 1-128 chars from [A-Za-z0-9._:/-]. Reuse the same value when retrying the same opera…
- `items` (array, required): Items to add to cart

Output parameters:

- `agent_session_id` (string)
- `buyer_intent_match` (object)
- `cart_id` (string)
- `currency` (string)
- `display_context` (string)
- `expires_at` (string): ISO-8601 UTC instant at which this checkout SESSION stops being usable. It is not a stock reservation and not a price guarantee.
- `expires_in_seconds` (integer): Whole seconds left on this checkout SESSION at response time (0 when already past). It is not a stock reservation and not a price guarantee.
- `items` (array)
- `next_step` (string)
- `session_state` (string)
- `status` (string)
- `store_name` (string)
- `subtotal_cents` (number)

### `get_shipping_rates` (~317 tokens)

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.

Input parameters:

- `agent_key` (string): Sandbox credential from `create_sandbox_key`. Use this when your client cannot set an `Authorization: Bearer` header.
- `cart_id` (string, required): Cart session ID returned by create_cart
- `shipping_address` (object): Destination address. Required: this tool does not prompt for it.

Output parameters:

- `address_city` (string)
- `address_country` (string)
- `cart_id` (string)
- `cheapest_shipping_handle` (string|null)
- `rates` (array)

### `select_shipping_option` (~318 tokens)

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.

Input parameters:

- `agent_key` (string): Sandbox credential from `create_sandbox_key`. Use this when your client cannot set an `Authorization: Bearer` header.
- `cart_id` (string, required): Cart session ID
- `idempotency_key` (string): REQUIRED for this write unless sent as the `Idempotency-Key` header or `params._meta["trusteed/idempotency-key"]`. 1-128 chars from [A-Za-z0-9._:/-]. Reuse the same value when retrying the same opera…
- `shipping_handle` (string, required): Shipping method handle from get_shipping_rates

Output parameters:

- `cart_id` (string)
- `currency` (string)
- `selected_handle` (string)
- `selected_title` (string)
- `shipping_authoritative` (boolean)
- `shipping_cents` (number)
- `shipping_source` (string)
- `subtotal_cents` (number)
- `total_cents` (number)

### `apply_discount` (~298 tokens)

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.

Input parameters:

- `agent_key` (string): Sandbox credential from `create_sandbox_key`. Use this when your client cannot set an `Authorization: Bearer` header.
- `cart_id` (string, required): Cart session ID
- `discount_code` (string): Discount or promo code to apply (required unless source is ucp_identity)
- `idempotency_key` (string): REQUIRED for this write unless sent as the `Idempotency-Key` header or `params._meta["trusteed/idempotency-key"]`. 1-128 chars from [A-Za-z0-9._:/-]. Reuse the same value when retrying the same opera…
- `identity_token` (string): UCP identity bearer token (required when source is ucp_identity).
- `source` (string): Set to 'ucp_identity' to apply a loyalty discount derived from a UCP identity token instead of a promo code.

Output parameters:

- `cart_id` (string)
- `currency` (string)
- `discount_cents` (number)
- `discount_code` (string)
- `new_total_cents` (number)

### `preview_checkout` (~391 tokens)

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.

Input parameters:

- `agent_key` (string): Sandbox credential from `create_sandbox_key`. Use this when your client cannot set an `Authorization: Bearer` header.
- `buyer_intent`: Optional. What the person asked for, as structured constraints with who said each one (user_stated or agent_inferred) and the substitution policy. The store may compare it with the cart when it enabl…
- `cart_id` (string, required): Cart session ID returned by create_cart
- `payment_mandate`: Payment mandate issued by the platform for this cart: the compact JWS you receive after the approval opened by `preview_checkout` is granted (its `exp` is Unix seconds and `aud` is this store's slug)…

Output parameters:

- `approval_id` (string)
- `approval_status_url` (string)
- `approval_url` (string)
- `buyer_intent_match` (object)
- `checkout_session_id` (string)
- `currency` (string)
- `discount_cents` (number)
- `expires_at` (string)
- `expires_in_seconds` (integer): Whole seconds left on this checkout SESSION at response time (0 when already past). It is not a stock reservation and not a price guarantee.
- `items` (array)
- `next_step` (string)
- `next_step_message` (string)
- `payment_options` (array)
- `shipping_authoritative` (boolean)
- `shipping_cents` (number)
- `shipping_source` (string)
- `shipping_title` (string)
- `status` (string)
- `store_name` (string)
- `subtotal_cents` (number)
- `tax_cents` (number)
- `tax_status` (string)
- `total_cents` (number)
- `total_is_final` (boolean)
- `total_note` (string)

### `get_checkout_state` (~153 tokens)

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.

Input parameters:

- `agent_key` (string): Sandbox credential from `create_sandbox_key`. Use this when your client cannot set an `Authorization: Bearer` header.
- `cart_id` (string, required): The cart id returned by create_cart (the checkout session id, a valid UUID).

### `quote_checkout` (~182 tokens)

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.

Input parameters:

- `agent_key` (string): Sandbox credential from `create_sandbox_key`. Use this when your client cannot set an `Authorization: Bearer` header.
- `cart_id` (string, required): Cart session ID returned by create_cart

### `complete_checkout` (~1472 tokens)

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_mandat…

Input parameters:

- `agent_key` (string): Sandbox credential from `create_sandbox_key`. Use this when your client cannot set an `Authorization: Bearer` header.
- `buyer` (object): Optional buyer contact information
- `cel_context` (object): Optional. Send only evidence you can substantiate; it can only make a check stricter, never looser. Unknown keys or out-of-range values are rejected with INVALID_ARGUMENT. Keys: key_age_hours, reques…
- `checkout_session_id` (string, required): Checkout session ID from preview_checkout — the same value as create_cart's cart_id (must be a valid UUID)
- `idempotency_key` (string, required): REQUIRED as an argument in this tool: the `Idempotency-Key` header or `_meta` alone is not enough. 1-128 chars from [A-Za-z0-9._:/-]. Reuse the same value when retrying the same operation.
- `kyapay_token` (string): Not available for payment: charging with KYApay is switched off, because KYApay is identity verification here, not a payment rail. A call that passes this token is rejected with PAYMENT_METHOD_NOT_CO…
- `payment_mandate`: Payment mandate issued by the platform for this cart: the compact JWS you receive after the approval opened by `preview_checkout` is granted (its `exp` is Unix seconds and `aud` is this store's slug)…
- `payment_method` (string): Payment method to use. PAYPAL creates a PayPal order and presents approval URL. KYAPAY is not available for payment: KYApay is identity verification here, so a request with KYAPAY is rejected without…
- `payment_option` (string): Payment method THE PERSON chose, when preview_checkout returned payment_options. Ask the person; never choose for them. Card numbers and wallet keys are never sent here: the person approves (and, wit…
- `reconfirmed_state_hash` (string): SHA-256 of the authoritative merchant state, as returned in details.reconfirm_state_hash by a previous STATE_RECONFIRMATION_REQUIRED error. Required to proceed when the merchant state moved after the…
- `save_payment_method` (boolean): Only with PayPal at a store that charges into its own PayPal account, for a signed-in buyer (not guest access), and only when the person asked for it: true asks PayPal to save this PayPal account dur…
- `shared_payment_token` (string): Stripe Shared Payment Token (spt_…) granted by the buyer's agent wallet for payment_method=ACP. Issued by Stripe, scoped to this merchant, amount and currency, and consumed when used: it can be charg…

Output parameters:

- `approval_url` (string)
- `checkout_session_id` (string)
- `currency` (string)
- `details` (object)
- `external_order_id` (string)
- `funding_source` (string)
- `idempotent` (boolean)
- `money_moves` (boolean)
- `next_action` (object)
- `order_id` (string)
- `order_placed` (boolean)
- `payment_captured` (boolean)
- `payment_method` (string)
- `payment_url` (string)
- `shipping_authoritative` (boolean)
- `shipping_source` (string)
- `status` (string)
- `store_name` (string)
- `test_funds` (boolean)
- `total_cents` (number)

### `ucp_create_checkout` (~371 tokens)

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.

Input parameters:

- `agent_key` (string): Sandbox credential from `create_sandbox_key`. Use this when your client cannot set an `Authorization: Bearer` header.
- `buyer` (object): Buyer contact and consent (UCP buyer_consent).
- `currency` (string, required): ISO 4217 currency code (e.g. USD)
- `idempotency_key` (string): REQUIRED for this write unless sent as the `Idempotency-Key` header or `params._meta["trusteed/idempotency-key"]`. 1-128 chars from [A-Za-z0-9._:/-]. Reuse the same value when retrying the same opera…
- `intent` (object): Intent context for relevance and personalization
- `label` (string): Optional label for additional identifiers (e.g. external order ref, multi-PSP reference)
- `line_items` (array, required): Line items for the checkout
- `meta`: UCP request metadata. meta['ucp-agent'].profile = URL of the platform profile; it must be an https URL without credentials (at most 2048 characters).
- `xyz.trusteed.shopping.buyer_intent`: Optional. What the person asked for, as structured constraints with who said each one (user_stated or agent_inferred) and the substitution policy. The store may compare it with the cart when it enabl…

### `ucp_get_checkout` (~166 tokens)

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.

Input parameters:

- `agent_key` (string): Sandbox credential from `create_sandbox_key`. Use this when your client cannot set an `Authorization: Bearer` header.
- `checkout_id` (string, required): UCP checkout session ID (valid UUID)
- `meta`: UCP request metadata. meta['ucp-agent'].profile = URL of the platform profile; it must be an https URL without credentials (at most 2048 characters).

### `ucp_update_checkout` (~427 tokens)

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.

Input parameters:

- `agent_key` (string): Sandbox credential from `create_sandbox_key`. Use this when your client cannot set an `Authorization: Bearer` header.
- `buyer` (object): Buyer contact and consent (UCP buyer_consent).
- `checkout_id` (string, required): UCP checkout session ID (valid UUID)
- `currency` (string): ISO 4217 currency code (e.g. USD). Optional: defaults to the checkout's currency.
- `fulfillment` (object): Delivery. Send destination first, then selected_option_id (or both in one call).
- `idempotency_key` (string): REQUIRED for this write unless sent as the `Idempotency-Key` header or `params._meta["trusteed/idempotency-key"]`. 1-128 chars from [A-Za-z0-9._:/-]. Reuse the same value when retrying the same opera…
- `line_items` (array): Replacement line items (replaces all lines). Omit to leave the lines as they are.
- `meta`: UCP request metadata. meta['ucp-agent'].profile = URL of the platform profile; it must be an https URL without credentials (at most 2048 characters).
- `xyz.trusteed.shopping.buyer_intent`: Optional. What the person asked for, as structured constraints with who said each one (user_stated or agent_inferred) and the substitution policy. The store may compare it with the cart when it enabl…

### `ucp_add_items_to_checkout` (~325 tokens)

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.

Input parameters:

- `agent_key` (string): Sandbox credential from `create_sandbox_key`. Use this when your client cannot set an `Authorization: Bearer` header.
- `checkout_id` (string, required): UCP checkout session ID (valid UUID)
- `idempotency_key` (string): REQUIRED for this write unless sent as the `Idempotency-Key` header or `params._meta["trusteed/idempotency-key"]`. 1-128 chars from [A-Za-z0-9._:/-]. Reuse the same value when retrying the same opera…
- `line_items` (array, required): Items to add or merge into the checkout
- `meta`: UCP request metadata. meta['ucp-agent'].profile = URL of the platform profile; it must be an https URL without credentials (at most 2048 characters).
- `xyz.trusteed.shopping.buyer_intent`: Optional. What the person asked for, as structured constraints with who said each one (user_stated or agent_inferred) and the substitution policy. The store may compare it with the cart when it enabl…

### `ucp_preview_checkout` (~317 tokens)

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.

Input parameters:

- `agent_key` (string): Sandbox credential from `create_sandbox_key`. Use this when your client cannot set an `Authorization: Bearer` header.
- `checkout_id` (string, required): UCP checkout session ID (valid UUID)
- `meta`: UCP request metadata. meta['ucp-agent'].profile = URL of the platform profile; it must be an https URL without credentials (at most 2048 characters).
- `payment_mandate`: Payment mandate issued by the platform for this cart: the compact JWS you receive after the approval opened by `preview_checkout` is granted (its `exp` is Unix seconds and `aud` is this store's slug)…
- `xyz.trusteed.shopping.buyer_intent`: Optional. What the person asked for, as structured constraints with who said each one (user_stated or agent_inferred) and the substitution policy. The store may compare it with the cart when it enabl…

### `ucp_complete_checkout` (~683 tokens)

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.

Input parameters:

- `agent_key` (string): Sandbox credential from `create_sandbox_key`. Use this when your client cannot set an `Authorization: Bearer` header.
- `ap2` (object): AP2 mandates extension. Required when the checkout carries ap2.merchant_authorization.
- `buyer` (object): Buyer name and email, needed to request the approval link.
- `checkout_id` (string, required): UCP checkout session ID (valid UUID)
- `idempotency_key` (string, required): REQUIRED as an argument in this tool: the `Idempotency-Key` header or `_meta` alone is not enough. 1-128 chars from [A-Za-z0-9._:/-]. Reuse the same value when retrying the same operation.
- `meta`: UCP request metadata. meta['ucp-agent'].profile = URL of the platform profile; it must be an https URL without credentials (at most 2048 characters).
- `payment` (object): UCP payment. With AP2, the Payment Mandate goes in instruments[].credential.token.
- `payment_handler` (string): Payment handler the store profile publishes. Omit for default.
- `payment_mandate`: Payment mandate issued by the platform for this cart: the compact JWS you receive after the approval opened by `preview_checkout` is granted (its `exp` is Unix seconds and `aud` is this store's slug)…
- `payment_option` (string): Payment method THE PERSON chose, when preview_checkout returned payment_options. Ask the person; never choose for them. Card numbers and wallet keys are never sent here: the person approves (and, wit…
- `shared_payment_token` (string): Stripe Shared Payment Token (spt_…) granted by the buyer's agent wallet for payment_method=ACP. Issued by Stripe, scoped to this merchant, amount and currency, and consumed when used: it can be charg…
- `x402_payload`: x402: signed payment for the server offer (omit to get it).

### `ucp_cancel_checkout` (~211 tokens)

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.

Input parameters:

- `agent_key` (string): Sandbox credential from `create_sandbox_key`. Use this when your client cannot set an `Authorization: Bearer` header.
- `checkout_id` (string, required): UCP checkout session ID (valid UUID)
- `idempotency_key` (string): REQUIRED for this write unless sent as the `Idempotency-Key` header or `params._meta["trusteed/idempotency-key"]`. 1-128 chars from [A-Za-z0-9._:/-]. Reuse the same value when retrying the same opera…
- `reason` (string): Optional cancellation reason

### `create_sandbox_key` (~84 tokens)

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.

### `get_trust_receipt` (~341 tokens)

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.

Input parameters:

- `agent_key` (string): Sandbox credential from `create_sandbox_key`. Use this when your client cannot set an `Authorization: Bearer` header.
- `checkout_session_id` (string): The checkout session id returned by create_cart and echoed by complete_checkout. Provide this or order_id.
- `order_id` (string): The order id of a completed purchase, when you have the order but not the checkout session. Provide this or checkout_session_id.

Output parameters:

- `call_id` (string)
- `checkout_status` (string)
- `code` (string)
- `dimensions` (object)
- `docs` (string)
- `does_not_attest` (array)
- `issued_at` (string)
- `jws` (string)
- `message` (string)
- `order_id` (string)
- `order_placed` (boolean)
- `receipt_id` (string)
- `retry_after_seconds` (number)
- `signature_status` (string)
- `status` (string)
- `verify_url` (string)
- `verify_with` (string)

### `verify_trust_receipt` (~188 tokens)

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.

Input parameters:

- `agent_key` (string): Sandbox credential from `create_sandbox_key`. Use this when your client cannot set an `Authorization: Bearer` header.
- `jws` (string, required): The compact JWS of the receipt (the `jws` field returned by get_trust_receipt).

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/xyz-trusteed-mcp-gateway/demo-store-mcp-checkout#diagnostics

## Score history

- 2026-11-21: 65
- 2026-11-20: 65
- 2026-11-19: 64

## Common questions

### What is the xyz.trusteed/mcp-gateway server?

xyz.trusteed/mcp-gateway is listed in the public MCP registry as xyz.trusteed/mcp-gateway. Agentic commerce gateway: discovery, trust and checkout. Demo store; x402 sandbox, AP2 planned. This page covers its hosted endpoint (https://api.trusteed.xyz/demo-store/mcp/checkout).

### Is the xyz.trusteed/mcp-gateway server safe to use?

xyz.trusteed/mcp-gateway scores 65 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the xyz.trusteed/mcp-gateway server expose?

xyz.trusteed/mcp-gateway exposes 18 tools: create_cart, get_shipping_rates, select_shipping_option, apply_discount, preview_checkout, and 13 more. Their descriptions and schemas cost roughly 6,761 tokens of context every time the server is loaded.

### Does the xyz.trusteed/mcp-gateway server require authentication?

No. We connected to xyz.trusteed/mcp-gateway without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the xyz.trusteed/mcp-gateway server still maintained?

xyz.trusteed/mcp-gateway is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What did VerifyMCP test on the xyz.trusteed/mcp-gateway server?

VerifyMCP ran 13 checks on xyz.trusteed/mcp-gateway, covering TLS certificate, HTTPS, HSTS header, DNSSEC and 9 more. One item could not be completed, a gap on our side rather than a finding about xyz.trusteed/mcp-gateway: Authorization. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- Remote endpoint: https://api.trusteed.xyz/demo-store/mcp/checkout
- Repository: https://github.com/trusteed/mcpwebstore
- Website: https://trusteed.xyz/
- Changelog RSS feed: https://verifymcp.io/servers/xyz-trusteed-mcp-gateway/demo-store-mcp-checkout.xml
- Changelog JSON feed: https://verifymcp.io/servers/xyz-trusteed-mcp-gateway/demo-store-mcp-checkout/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/xyz-trusteed-mcp-gateway/demo-store-mcp-checkout.json
- HTML version of this page: https://verifymcp.io/servers/xyz-trusteed-mcp-gateway/demo-store-mcp-checkout
