Guía Rápida

Añade el servidor MCP

Configura la URL del servidor MCP en tu cliente Claude o aplicación. Sustituye {slug} por el slug de la tienda. Sin clave, usa demo-store (solo lectura).

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

Busca productos

Usa search_products para explorar catálogos. Filtra por categoría, precio, disponibilidad. También disponibles: browse_categories, compare_products, nlweb_ask (búsqueda semántica).

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

Verifica trust del merchant

Antes de comprar, comprueba el nivel de confianza y de verificación de identidad del merchant. Solo procede si está por encima de tu umbral aceptable.

// get_merchant_profile → verificación de identidad
// Active stores show "STANDARD" or "VERIFIED" verification levels.
{
  "trust_score": 0.91,
  "verification_level": "STANDARD",
  "policies": {
    "return_window_days": 30,
    "free_shipping_threshold": 75
  }
}

Niveles de confianza del merchant: • EXCELLENT: máxima confianza, procede sin fricción • GOOD: confianza alta, procede con confirmación normal • ACCEPTABLE: mínimo elegible, procede con confirmación estándar • Por debajo de tu umbral aceptable: no inicies checkout Metodología completa: /api/v1/trust/methodology

Completa el checkout

Crea carrito, obtén tasas de envío, previsualiza y completa. Protocolos de pago: MCP, x402, ACP, UCP, VIC, MCAP, PayPal y SCP (varios en sandbox o próximamente); AP2 y MPP están previstos.

// Flujo completo (5 herramientas MCP)
1. create_cart(items)                              → cart_id
2. get_shipping_rates(cart_id, shipping_address)  → rates[]
3. select_shipping_option(cart_id, shipping_handle)
4. preview_checkout(cart_id)                       → checkout_session_id + totales
5. complete_checkout(checkout_session_id, idempotency_key)
   → status: COMPLETED + order_id, o PENDING_EXTERNAL_CONFIRMATION + enlace para el comprador