Quick Start

Add the MCP server

Configure the MCP server URL in your Claude client or app. Replace {slug} with the store slug. No key? Use demo-store (read-only, no auth).

{
  "mcpServers": {
    "trusteed": {
      "url": "https://trusteed.xyz/{slug}/mcp",
      "headers": {
        "X-Agent-Api-Key": "agnt_your_key"
      }
    }
  }
}

Search products

Use search_products to explore catalogs. Filter by category, price, availability. Also available: browse_categories, compare_products, nlweb_ask (semantic search).

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "search_products",
    "arguments": {
      "query": "laptop",
      "max_price": 2000,
      "in_stock_only": true,
      "limit": 5
    }
  }
}

Verify merchant trust

Before purchasing, check the trust score and verification level. Only proceed if trustScore ≥ 0.70.

// get_merchant_profile → identity verification
// Current stores return "STANDARD" or "BASIC" verification levels.
{
  "trust_score": 0.91,
  "verification_level": "STANDARD",
  "policies": {
    "return_window_days": 30,
    "free_shipping_threshold": 75
  }
}

Trust score thresholds: • ≥ 0.95 — ELITE: maximum trust, proceed without friction • ≥ 0.85 — VERIFIED: verified merchant, proceed with standard confirmation • ≥ 0.70 — STANDARD: minimum eligible, proceed with standard confirmation • < 0.70 — Do not initiate checkout Full methodology: /api/v1/trust/methodology

Complete checkout

Create cart, get shipping rates, preview, and complete. 9 payment protocols supported (MCP, x402, ACP, UCP, VIC, MCAP, PayPal, SCP, MPP coming soon).

// Complete flow (5 MCP tools)
1. create_cart(items)        → cart_id
2. get_shipping_rates(addr)  → rates[]
3. select_shipping_option(id)
4. preview_checkout(cart_id)  → totals + taxes
5. complete_checkout(cart_id) → checkout_url