Gobernanza de tools
Matriz de gobernanza de tools
Cada tool MCP que expone el gateway, con su scope, tier, autenticación y efectos secundarios. Construye los guardrails del agente contra esta tabla.
| Tool | Scope | Tier | Auth | Efecto | Descripción |
|---|---|---|---|---|---|
| search_products | mcp:search | STARTER | ❌ | read | Búsqueda wildcard en catálogo del merchant. |
| get_product_details | mcp:read | STARTER | ❌ | read | Detalles completos de un producto por id. |
| browse_categories | mcp:read | STARTER | ❌ | read | Listado de categorías y conteos. |
| get_merchant_profile | mcp:read | STARTER | ❌ | read | Perfil del merchant, trust score, capacidades. |
| compare_products | mcp:read | GROWTH | ❌ | read | Comparativa side-by-side de varios productos. |
| check_availability | mcp:read | GROWTH | ❌ | read | Disponibilidad de stock en vivo por SKU y ubicación. |
| nlweb_ask | mcp:search | GROWTH | ❌ | read | Discovery semántica NLWeb en lenguaje natural. |
| preview_checkout | mcp:read | GROWTH | ❌ | read+preview | Calcula precio/envío/impuestos sin commit. |
| apply_discount | mcp:read | GROWTH | ❌ | read+preview | Valida cupón y vista previa de totales. |
| create_cart | mcp:write | GROWTH | ✅ | write | Crea un cart (sin pago). |
| select_shipping_option | mcp:write | GROWTH | ✅ | write | Fija opción de envío en un cart. |
| complete_checkout | mcp:checkout | GROWTH | ✅ | write+payment | Crea el pedido de un checkout_session_id. Devuelve COMPLETED con order_id, o PENDING_EXTERNAL_CONFIRMATION con el enlace que el comprador debe abrir para aprobar o pagar. |
| ucp_create_checkout | mcp:write | PRO | ✅ | write | Intent UCP de checkout unificado (multi-rail). |
| ucp_complete_checkout | mcp:checkout | PRO | ✅ | write+payment | Liquidación UCP: multi-rail (card / x402 / wallet). |
| ucp_cancel_checkout | mcp:write | PRO | ✅ | write+cancel | Cancela un intent UCP pendiente. |
Efectos: read (sin cambio de estado) · read+preview (calcula, no commit) · write (crea recurso) · write+payment (cobra dinero) · write+cancel (libera recurso).
Semántica de scopes: mcp:read (discovery), mcp:search (NLWeb + wildcard), mcp:write (mutación cart), mcp:checkout (liquidación).
Plan de upgrade entre tiers:
Ver comparativa de tiers →