Saltar al contenido

Demo en vivo · Sin registro

Prueba el MCP sin crear una cuenta

El endpoint público de demo-store responde sin autenticación. Llama a search_products, browse_categories o get_product_details directamente desde tu agente o terminal.

Endpoint público:POST /demo-store/mcp/discoveryEn vivo

Perfiles de Agente

Config del Merchant

Nivel de Confianza

Puntuación de Confianza0.5

< 0.3 activa KYAI trust gate

Transacciones Totales

Señales de Identidad

Confianza del Proveedor (R006)0.9

< 0.6 activa bloqueo por baja confianza

Antigüedad de Clave (h): R004
1 h

< 24 h activa fricción por clave nueva

Señales de Riesgo Histórico

Órdenes Completadas (R010/R021)0

< 1 activa reglas de probación / primera compra

Contador de Velocidad (R003/R011)0

> 3 activa repeat-failed-checkout

Checkouts Fallidos (R011)0

> 3 activa repeat-failed-checkout

Disputas (R009/R024)0

> 2 activa bloqueo por historial de disputas

Cancelaciones (R014)0

> 3 activa regla de riesgo de entrega

Ratio de Devolución (R023)0

> 0.5 activa refund-abuse-guard

Señales del Carrito

Diferencia de Precio (bps): R0150

> 100 bps activa price-change-guard

Códigos de Descuento Probados (R017)0

> 5 activa coupon-anomaly

Descuento Aplicado (bps): R0170

> 5000 bps activa coupon-anomaly

Valor Almacenado (cts): R0270

> max del merchant activa límite de gift card

Flags de Envío y Producto

Reglas del Merchant

0 / 46 activas

Identidad

Riesgo

Carrito

Geo / Dirección

Producto

Controles Merchant

Nivel de Verificación

Confianza Mínima del Comprador

0.30

Agentes por debajo de este score son bloqueados

Monto del Pedido

$

Moneda

Protocolo

Scopes del Agente

Configura el perfil del agente y pulsa Evaluar
API JSONPOST /api/v1/rules/evaluate

Se actualiza en vivo al cambiar los controles

{
  "agentTrustScore": 50,
  "orderContext": {
    "cartTotalCents": 12000,
    "currency": "EUR",
    "itemCount": 1,
    "lineItems": [
      {
        "productId": "prod_001",
        "quantity": 1
      }
    ],
    "cartAttributes": {
      "_agent_key_age_hours": "1",
      "_provider_confidence": "0.9"
    }
  },
  "merchantPolicies": {}
}

Obtener clave Sandbox

En demo-store, el endpoint de descubrimiento no necesita clave: puedes buscar y leer el catálogo sin credencial ninguna. El de checkout la necesita para todas sus tools, `create_cart` incluida. Sin ella la llamada responde HTTP 200 con un error JSON-RPC cuyo `error.data.code` es `no_credentials` (sin cabecera WWW-Authenticate): ramifica por ese código, no por el estado HTTP. Basta una clave sandbox autoservible de la tool `create_sandbox_key`. La cabecera `X-Payment-Mandate` la piden además las tools de checkout que gastan o liquidan (preview_checkout, complete_checkout, process_agent_payment, complete_visa_payment, ucp_complete_checkout, ucp_preview_checkout); el resto de tools de checkout (create_cart y attach_agent_identity y verify_age_over_n y verify_residence_country y verify_legal_person_authorization y apply_discount y get_shipping_rates y select_shipping_option y create_payment_mandate y update_payment_mandate y cancel_payment_mandate y ucp_create_checkout y ucp_update_checkout y ucp_add_items_to_checkout y ucp_get_checkout y ucp_cancel_checkout y get_checkout_state y quote_checkout y get_trust_receipt y verify_trust_receipt) no lo piden. Sin él, demo-store responde HTTP 200 con un error JSON-RPC cuyo `error.data.code` es `demo_sandbox_mandate_required` (`demo_sandbox_mandate_malformed` más `remediation.mandate_issues` si no se puede leer); ramifica por ese código, no por el estado HTTP. Un comercio real responde 403 `payment_mandate_required`. El pago es simulado. Paso a paso: https://trusteed.xyz/.well-known/agent-checkout-guide.json

POST /api/v1/sandbox/key
TTL: 24 horasTasa: 50 req/horaMáximo 25 claves por IP por día
cURL
curl -X POST https://trusteed.xyz/api/v1/sandbox/key \
  -H "Content-Type: application/json"

# Response:
# {
#   "key": "agnt_sandbox_0123456789abcdef0123456789abcdef",
#   "expires_at": "2026-03-23T12:00:00Z",
#   "rate_limit": "50/hour"
# }

Usa el header X-Agent-Api-Key con tu clave sandbox contra demo-store, y sólo contra demo-store: en cualquier comercio real se rechaza.

Preguntas frecuentes

¿Qué es la demo store?
Es un servidor MCP público de prueba con un catálogo ficticio. Permite probar herramientas de búsqueda, checkout y protocolos de pago sin registro ni autenticación.
¿Necesito una API key?
No para las herramientas de lectura (search_products, browse_categories, get_product_details, get_merchant_profile). Las herramientas de checkout requieren una clave temporal gratuita de 24 horas obtenida vía POST /api/v1/sandbox/key.
¿Qué protocolos soporta?
MCP (Model Context Protocol), A2A (Agent-to-Agent) y UCP (Universal Commerce Protocol) están activos en producción. ACP (Stripe fiat) y PayPal (Orders API v2) están disponibles en modo sandbox. AP2 (mandatos de Google) está previsto: ninguna tienda acepta todavía mandatos AP2. VIC (tarjetas Visa), KYApay (identidad vinculada), x402 (USDC stablecoin), WebMCP y A2UI están en desarrollo.
¿Los pagos son reales?
No. Todos los protocolos de pago (MCP, ACP, x402, UCP, Visa VIC, MCAP, PayPal, SCP) operan en modo sandbox/test en la demo store. No se procesan cargos reales ni se mueven fondos.
¿Cuáles son los límites de uso?
Herramientas de lectura: 20 requests/min por IP. Claves sandbox: 50 requests/hora, máximo 25 claves por IP por día, cada clave expira a las 24 horas.
¿Cómo me integro?
Envía requests JSON-RPC 2.0 a POST /demo-store/mcp/discovery. Para carrito y checkout usa /demo-store/mcp/checkout con una clave sandbox; los pagos son simulados. Consulta la documentación de developers para SDKs en TypeScript y Python.

¿Listo para conectar tu tienda real?

Crea tu cuenta gratis y conecta Shopify, WooCommerce u Odoo en menos de 5 minutos.

Demo en vivo: prueba el MCP sin registro | Trusteed