Skip to content

Quick Start

Connect your agent in 4 steps — with merchant trust verification

Verified merchants43 MCP tools8 payment protocols
1

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"
      }
    }
  }
}
2

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
    }
  }
}
3

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
  }
}
4

Complete checkout

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

// 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

Available tools

search_productsSearch catalog with filters
get_product_detailsFull product data
browse_categoriesBrowse categories
compare_productsCompare products
nlweb_askAI semantic search
get_merchant_profileTrust score + identity
create_cartCreate cart
get_shipping_ratesShipping rates
preview_checkoutPreview order totals
complete_checkoutComplete purchase
onx_get_ordersQuery orders
onx_create_returnInitiate return

…and 31 more tools (UCP, SCP, VIC, MCAP, x402). See full documentation →

Quick Start - AI Agents | Trusteed