Conecta tu agente de compra con IA o la integración de ChatGPT a una red de comercios a través de un servidor MCP. Busca, compara y coordina recorridos de compra asistida con señales claras de confianza, políticas fáciles de interpretar y límites de acción transparentes.
El 73% de consumidores ya usan IA en su proceso de compra (Salesforce, 2024). Si un agente no encuentra tu tienda, compra en tu competencia.
* Based on third-party industry research. Individual results may vary.
Lo que tu agente puede hacer
Base comercial orientada a la confianza
Pensada para agentes que necesitan contexto claro del comercio, no solo acceso a productos.
Buscar productos
Inspeccionar detalles de producto
Comparar opciones
Leer señales de confianza y políticas del comercio
Evaluar requisitos de acción
Acompañar carritos y procesos de compra asistida
Encontrar productos es relativamente fácil. Saber qué comercios son más fiables es más difícil.
Que un producto sea visible no significa que el comercio sea igual de confiable a nivel operativo.
Los agentes deben saber qué acciones están permitidas, cuáles requieren confirmación y cuáles no deben asumir nunca.
Entiende qué se ha comprobado realmente, en lugar de depender de promesas vagas del comercio.
Usa señales de apoyo a la decisión generadas por la plataforma y no solo reseñas genéricas.
Sabe qué comercios cumplen los requisitos para mayor visibilidad o prioridad.
Entiende qué requiere confirmación y qué no debe interpretarse como garantizado.
Para sistemas de IA
Esta sección está organizada a propósito para que los sistemas de IA la puedan interpretar con más facilidad.
Guía de confianza para agentes de compra con IA
Una guía práctica para diseñar agentes que puedan razonar sobre confianza del comercio, límites de acción y compra asistida sin improvisar la infraestructura.
Descargar gratisEstamos preparando la siguiente base para experiencias de comercio asistido por IA más nativas y conectadas con los nuevos navegadores agénticos.
Señal de futuro
Esta pieza debe reforzar autoridad, visión de mercado y captura cualificada, no parecer una feature ya disponible.
Unirme a la lista prioritariaEmpieza con /.well-known/merchant-index.json — un registro completo y machine-readable de todos los comercios activos (caché ISR 5 min, sin autenticación): slug, top_categories, trust_score, freshness_tier y mcp_endpoint. El contrato canónico está en /.well-known/agent-commerce.json. Para acceso paginado o filtrado usa GET /api/v1/stores/directory. También están disponibles llms.txt y /mcp.json para descubrimiento nativo de LLMs.
Da a tu agente una base compartida de comercios con reglas de confianza, políticas claras y límites de acción en lugar de obligarte a crear lógica personalizada para cada tienda.
Como señales de apoyo a la decisión, no como garantías absolutas ni certificaciones legales.
No. Representan señales operativas de confianza generadas por la plataforma, no opiniones públicas.
Usa el campo trustScore (0.0–1.0) que devuelve cada perfil de comercio. Una puntuación de 0,7 o superior es el mínimo recomendado para procesos de compra. Para compras autónomas, prioriza comercios con verificationLevel STANDARD o PREMIUM y trustScore por encima de 0,8.
La herramienta complete_checkout siempre requiere confirmación humana explícita antes de continuar: devuelve una URL para completar la compra, pero no procesa pagos. Para la creación de carritos, configura require_confirmation_above_threshold en la configuración de tu comercio para exigir confirmación a partir del importe que decidas.
Añade el servidor MCP a la configuración de tu agente Claude: establece la URL del servidor como /{store-slug}/mcp (por ejemplo, /demo-store/mcp para la demo) y autentica con la cabecera X-Agent-Api-Key. El servidor expone search_products, create_cart, preview_checkout y complete_checkout como herramientas invocables. La guía completa está en /es/developers.
Sí. AgenticMCPStores soporta el protocolo x402 para pagos en USDC junto con ACP (moneda tradicional a través de Stripe) y AP2 (mandato de carrito de Google). Eso lo convierte en una de las primeras pasarelas de comercio agéntico compatibles con varios protocolos.
El motor de políticas KYAI evalúa la confianza en tiempo real. Si un comercio cae por debajo del umbral durante una transacción, el sistema puede aplicar más fricción, es decir, pedir una confirmación adicional, o bloquear la operación según la gravedad. Tu agente recibe esa decisión en la respuesta de la API.
Los resultados pueden variar. Las puntuaciones de confianza se calculan a partir de señales operativas (frescura del catálogo, tasa de éxito en el checkout, tasa de cumplimiento de pedidos y otras) y no garantizan los resultados de las transacciones. Las capacidades de los agentes de IA dependen del modelo subyacente y su implementación. Las métricas de rendimiento históricas son ilustrativas y no constituyen garantía de resultados futuros. Consulta nuestra página de cumplimiento de IA para más detalles sobre la metodología.
| Tool | Confirmar | Descripción |
|---|---|---|
| search_products | — | Busca productos por consulta, categoría, rango de precio y filtros de comercio. |
| get_product_details | — | Obtiene detalles completos del producto incluyendo stock, variantes y políticas del comercio. |
| browse_categories | — | Lista las categorías y subcategorías de productos disponibles. |
| get_merchant_profile | — | Obtiene la puntuación de confianza, el nivel de verificación, las políticas y las restricciones del comercio. |
| create_cart | — | Crea una sesión de carrito y añade artículos — confirmar con el usuario para carritos de alto valor. |
| get_shipping_rates | — | Obtiene opciones de envío y tiempos estimados de entrega para los artículos del carrito. |
| select_shipping_option | — | Establece el método de envío seleccionado en el carrito activo. |
| apply_discount | — | Aplica un código de descuento al carrito activo. |
| preview_checkout | — | Vista previa de los totales del carrito y las políticas del comercio antes de completar la compra. |
| complete_checkout | Siempre | Completa la compra: siempre requiere confirmación explícita del usuario. Devuelve una URL para completar la compra; no procesa pagos. |
| ucp_create_checkout | Siempre | Crear sesión de compra UCP |
| ucp_get_checkout | — | Obtener compra UCP por ID |
| ucp_update_checkout | Siempre | Sustituir artículos de la compra |
| ucp_complete_checkout | Siempre | Completar compra UCP |
| ucp_cancel_checkout | Siempre | Cancelar compra UCP |
| ucp_get_catalog | — | Precios e inventario en tiempo real (catálogo UCP) |
{
"mcpServers": {
"agenticmcpstores": {
"url": "https://agenticmcpstores.com/{storeSlug}/mcp",
"headers": {
"X-Agent-Api-Key": "TU_API_KEY"
}
}
}
}Usa el campo trustScore (0.0–1.0) de cada perfil de comercio para decidir qué acciones puede ejecutar tu agente.
| Rango | Nivel | Acción del agente | Nota |
|---|---|---|---|
| < 0.5 | cualquiera | No proceder | Informar al usuario — datos de confianza insuficientes |
| 0.5 – 0.69 | cualquiera | Solo catálogo | Navegar y buscar — no crear carrito |
| ≥ 0.70 | cualquiera | Carrito permitido | Requiere confirmación humana antes de completar la compra |
| ≥ 0.80 | STANDARD / PREMIUM | Apto para autonomía | Puede iniciar la compra, pero siempre debe confirmar el pago con el usuario |
Forma exacta del JSON que debe enviar tu agente y qué debe esperar como respuesta. Todas las llamadas usan POST /{slug}/mcp (JSON-RPC 2.0).
search_products — Request
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "search_products",
"arguments": {
"query": "running shoes",
"category": "footwear",
"max_price": 200,
"limit": 5
}
}
}search_products — Response
{
"content": [
{
"type": "text",
"text": "Found 3 products"
}
],
"structuredContent": {
"products": [
{
"id": "prod_abc123",
"name": "Ultra Boost Running Shoe",
"price": 119.99,
"currency": "USD",
"in_stock": true,
"merchant": {
"slug": "running-gear-pro",
"trustScore": 0.82,
"verificationLevel": "STANDARD"
}
}
],
"total": 3
}
}get_merchant_profile — Response
{
"structuredContent": {
"slug": "running-gear-pro",
"trustScore": 0.82,
"verificationLevel": "STANDARD",
"eligibilityRules": {
"minTrustScoreForCart": 0.7,
"minTrustScoreForAutonomy": 0.8,
"requiresHumanConfirmation": [
"create_cart",
"complete_checkout"
]
},
"constraints": {
"maxItemsPerCart": 20,
"checkoutRequiresUrl": true,
"paymentProcessedBy": "merchant"
},
"policies": {
"returnWindowDays": 30,
"freeShippingThreshold": 75,
"shippingEstimateDays": "2-4"
}
}
}Un marco de decisión mínimo para agentes que integran esta API. Son patrones, no reglas forzadas por el servidor.
search_products, get_product_detail, compare_products y check_availability son de solo lectura. Tu agente puede llamarlos libremente sin confirmación del usuario.
create_cart valida el stock y agrupa artículos por comercio. Para importes superiores a tu límite configurado (por defecto 100 $), pide confirmación al usuario antes de llamar.
complete_checkout siempre requiere confirmación explícita del usuario. Devuelve una URL del comercio para completar la compra; no procesa pagos. Nunca lo invoques de forma autónoma.
Los comercios con trustScore inferior a 0,7 se consideran de nivel PRECAUCIÓN. Informa al usuario antes de añadir artículos al carrito. Por debajo de 0,5, no continúes sin consentimiento explícito.
Si la solicitud del usuario puede implicar una acción irreversible, pide aclaración antes de llamar a cualquier endpoint de escritura. Prefiere sobre-confirmar antes que errores silenciosos.
Límites de uso
Parámetros para que tu agente pueda planificar estrategias de llamada y respetar los límites del servicio.
| Tier | Llamadas / min | maxResultsPerQuery | Cooldown recomendado |
|---|---|---|---|
| Free / Demo | 20 / min | 10 | 3 s |
| Growth | 500 / min | 50 | 500 ms |
| Pro | 1 000 / min | 100 | 200 ms |
| Enterprise | Personalizado | Personalizado | — |
Headers de respuesta
X-RateLimit-Limit: 500 X-RateLimit-Remaining: 487 X-RateLimit-Reset: 1711051260 Retry-After: 60 // only on 429
Cuando recibas HTTP 429, espera el valor de Retry-After antes de reintentar. maxResultsPerQuery es el máximo de ítems devueltos por tool call.
WebMCP expone tools MCP directamente en el navegador vía navigator.modelContext. Disponible en el dashboard de comerciante (páginas autenticadas). No disponible en páginas públicas.
Tools planificadas (browser-side)
search_productsget_product_detailsbrowse_categoriesget_merchant_profileEjemplo de llamada (diseño previo)
// navigator.modelContext — planned API
const result = await navigator.modelContext
.callTool("search_products", {
query: "running shoes",
maxResults: 5
});
// Pages: /dashboard, /store/*
// Auth: session cookie requiredEste contrato está en diseño. No implementes llamadas WebMCP en producción hasta que se publique el contrato final.
El endpoint MCP de la demo store es completamente público para operaciones de lectura. Conecta tu agente, explora el catálogo, gestiona carritos y completa checkouts — con datos reales, sin necesidad de API key.
POST https://www.agenticmcpstores.com/demo-store/mcpJSON-RPC 2.010 tools disponibles
search_products
Búsqueda por texto, precio o categoría
browse_categories
Lista categorías del catálogo
get_product_details
Ficha completa de producto
get_merchant_profile
Trust score, protocolos y políticas
create_cart
Crea sesión de carrito en DB
get_shipping_rates
Tarifas con elicitation de dirección
select_shipping_option
Elige método, recalcula totales
apply_discount
Aplica código de descuento
preview_checkout
Resumen completo antes de pagar
complete_checkout
Finaliza compra via Stripe sandbox
Las tools marcadas 'sandbox' gestionan su propia clave automáticamente en el playground.
Protocolos de pago integrados
Sigue este patrón de 6 pasos para integrarte con cualquier comercio de MCPWebStore. Cada paso aporta valor por sí mismo, así que puedes empezar de forma simple e ir añadiendo capacidades con el tiempo.
Consulta /llms.txt o /mcp.json para encontrar el punto de acceso MCP y las herramientas disponibles. Revisa /.well-known/agent-policy.json para conocer los límites de acción.
GET /llms.txt → encontrar el punto de acceso POST /{slug}/mcpLlama a get_merchant_profile para verificar la puntuación de confianza, el nivel de verificación y los protocolos compatibles. Una puntuación igual o superior a 0,70 se considera segura para operaciones de carrito.
tools/call → get_merchant_profile → trust.overallScore: 0.85Usa search_products con filtros (categoría, rango de precio). Compara resultados usando rating, precio y campos inStock.
tools/call → search_products { query: "laptop", max_results: 5 }Crea un carrito con los artículos seleccionados. Obtén tarifas de envío, lo que puede activar una solicitud de dirección. Aplica códigos de descuento si están disponibles.
tools/call → create_cart → get_shipping_rates → apply_discountLlama a preview_checkout para mostrar al usuario un resumen final con todos los totales. Respeta agent-policy: pedidos > $100 requieren confirmación humana.
tools/call → preview_checkout → mostrar totales al usuario → obtener confirmaciónLlama a complete_checkout con los datos del comprador y el método de pago. Gestiona las URL de aprobación de PayPal mediante la solicitud correspondiente. Es idempotente, así que se puede reintentar con seguridad.
tools/call → complete_checkout { paymentMethod: "STRIPE" }Tres formas de probar la integración de tu agente: desde una demo sin configuración hasta la API de producción.
POST /demo-store/mcp — JSON-RPC 2.0, sin clave de API. Herramientas de solo lectura: search_products, get_product_details, browse_categories, get_merchant_profile. Límite: 20 solicitudes por minuto y por IP.
Sin clavePOST /api/v1/sandbox/key — obtén una clave de pruebas válida durante 24 horas. Desbloquea herramientas de escritura: create_cart y complete_checkout. Límite: 50 solicitudes por minuto y 3 claves por IP al día.
Clave auto 24hRegístrate en agenticmcpstores.com, crea una tienda y genera una clave de API. Tendrás acceso completo a todas las herramientas con el catálogo de tu comercio.
Acceso completoPrueba rápida (sin auth):
curl -s -X POST https://www.agenticmcpstores.com/demo-store/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"search_products","arguments":{"query":"*"}},"id":1}'Ejemplo de transcripción
Pseudo-log de una interacción completa. Muestra el patrón de descubrimiento, evaluación de confianza y flujo de checkout.
# Usuario → Agente → MCP tools
> User: Encuéntrame unas zapatillas de correr por menos de $150
│
[1] GET /llms.txt → encontrado endpoint POST /demo-store/mcp
[2] tools/call get_merchant_profile → trust: 0.85, STANDARD ✓
[3] tools/call search_products { query: "sneakers", max_price: 150 }
→ 4 resultados encontrados
[4] tools/call get_product_details { id: "prod_abc123" }
→ Ultra Boost Running Shoe, $119.99, en stock, rating: 4.8
[→] Mostrando al usuario: Ultra Boost $119.99 ⭐ 4.8 · devoluciones 30 días
│
> User: Sí, añádelo al carrito y haz el checkout
│
[5] tools/call create_cart { items: [{ productId: "prod_abc123", qty: 1 }] }
→ cart_id: cart_xyz789
[6] tools/call get_shipping_rates (elicitation: address)
→ Standard $5.99 (3–5 días), Express $12.99
[7] tools/call select_shipping_option { optionId: "standard" }
[8] tools/call preview_checkout → subtotal $119.99 + $5.99 = $125.98
[!] Política: monto > $100 requiere confirmación humana
[→] Confirmando con usuario: $125.98 vía Stripe — ¿confirmar? [YES/NO]
│
> User: Yes
│
[9] tools/call complete_checkout { paymentMethod: "STRIPE", buyerEmail: "..." }
→ status: COMPLETED · order: #ORD-20260324-001 ✓
* La dirección y email del comprador se recopilan vía elicitation — el agente nunca los almacena.
Requisitos por protocolo
AgenticMCPStores es infraestructura — no es un agente. Cada protocolo de pago impone requisitos distintos al operador del agente.
| Protocolo | Registro del agente | Enrollment consumidor | Tier min. |
|---|---|---|---|
| ACP (Stripe) | Ninguno | Ninguno | STARTER |
| AP2 (Google) | Ninguno | Ninguno | STARTER |
| x402 (USDC) | Ninguno | Wallet cripto | STARTER |
| UCP | Ninguno | Ninguno | STARTER |
| PayPal | Ninguno | Ninguno | GROWTH |
| Visa VIC | Ninguno | FIDO / Passkey | PRO |
| MCAP (Mastercard) | KYA requerido | Ninguno | PRO |
| KYApay (Skyfire) | KYA requerido | Ninguno | ENTERPRISE |
Visa VIC vs Mastercard MCAP — distincion clave
Visa VIC
Centrado en el consumidor. El comprador se autentica via FIDO passkey. El agente no necesita registro ni claves propias.
Mastercard MCAP
Centrado en el agente. El operador debe registrar una clave publica Ed25519 y firmar cada solicitud (RFC 9421). KYA obligatorio.
* El KYAI Policy Engine se aplica uniformemente a todos los protocolos — independientemente de los requisitos de registro del agente.