Comercio Agéntico

Todas las tiendas Jumpseller pueden ser usadas por agentes de IA, sin nada que instalar. Esta página es el mapa: para qué sirve cada superficie, cuál elegir, y qué ya está activo.

Si estás construyendo un asistente de IA que trabaja sobre Jumpseller — escribiendo temas, llamando a la API — lo que buscas es el AI Toolkit. Esta página trata de agentes que compran en una tienda.

¿Qué superficie necesito?

Quiero…	Usar
Que el navegador con IA de un cliente actúe en la página donde está	WebMCP
Leer el catálogo de una tienda desde mi propio agente o app	MCP para Tienda
Integrar a través del estándar abierto de comercio agéntico	Universal Commerce Protocol, más abajo
Gestionar una tienda: productos, pedidos, clientes	MCP de Administración

Las tres primeras son públicas y no necesitan credenciales. La cuarta se autentica como tú.

1. Descubrimiento

Antes de poder comprar en tu tienda, hay que descubrir qué ofrece.

• /llms.txt y /agents.md — una descripción en texto plano de la tienda y de los endpoints que un agente puede usar. Se genera a partir de las herramientas realmente registradas, así que nunca describe una que ya no existe.
• /.well-known/mcp.json — metadatos de descubrimiento MCP.
• /.well-known/ucp — el perfil Universal Commerce Protocol de la tienda: qué capacidades soporta, en qué versiones, y los endpoints que las sirven.

Los cuatro son públicos y los sirve cada tienda.

2. Navegar y buscar

MCP para Tienda — POST https://tu-tienda.com/api/mcp

Un servidor MCP público y de solo lectura en cada tienda. Seis herramientas para información de la tienda, productos, búsqueda y categorías. Sin autenticación. Úsalo cuando tu agente no corre dentro del navegador del cliente: un chatbot, un asistente de compras, un comparador.

Catálogo y Carro UCP — POST https://tu-tienda.com/api/ucp/mcp

El mismo catálogo a través del Universal Commerce Protocol: search_catalog, lookup_catalog y get_product para la capacidad Catalog, y create_cart, get_cart, update_cart y cancel_cart para la de Cart — todas en los tipos del propio UCP. Úsalo si ya hablas UCP y quieres una integración que funcione en varias plataformas.

Ambos leen el mismo catálogo, y un id de uno es un id en el otro. Son endpoints separados porque las herramientas significan cosas distintas: el get_product de UCP exige un envoltorio meta que identifica al agente, y responde en el tipo Product de UCP en vez del nuestro.

3. Comprar en la propia página

WebMCP — sin endpoint; la tienda registra las herramientas en el navegador.

Cuando un cliente abre la tienda en un navegador con IA, la página le entrega al asistente once herramientas: buscar el catálogo, navegar categorías, mostrar una variante, llenar el carro, aplicar un cupón, abrir el checkout. Corren en la sesión del propio cliente, así que el asistente trabaja en el carro que la persona está viendo.

Esta es la que mueve la conversión, porque es la que corre mientras alguien está comprando de verdad.

4. Pagar

Paga el cliente. Ninguna herramienta en ninguna de estas superficies puede crear un pedido ni introducir datos de pago, y dentro del checkout no se ofrece ninguna. A un agente que construyó un carro UCP se le devuelve un continue_url para que la persona finalice; un agente en la página abre el checkout y se aparta. En cualquier caso, el trabajo de un agente termina al entregarle la página de checkout a la persona.

5. Gestionar la tienda

MCP de Administración — https://mcp.jumpseller.com

Lectura y escritura de productos, pedidos, clientes, categorías y páginas, autenticado con un token de API u OAuth 2.0. Este es el agente del comerciante, no el de un cliente.

Qué está activo por defecto

Superficie	Activo por defecto	Autenticación
llms.txt, .well-known/mcp.json, .well-known/ucp	Sí	Ninguna
WebMCP	Sí, en todas las tiendas y temas	Ninguna — la sesión del cliente
MCP para Tienda	Sí	Ninguna
Catálogo y Carro UCP	Sí	Ninguna
MCP de Administración	Requiere credenciales	Token de API u OAuth 2.0

Qué no hemos construido todavía

Dicho de frente, porque es más útil que un roadmap:

• Checkout de UCP, donde el propio agente completa la compra. Es una decisión aparte sobre quién recibe el dinero, y aún no la hemos tomado. Cart ya está hecho: un agente puede llenar un carro y devolverle al cliente un enlace para finalizar.
• Seguimiento de pedidos para agentes de clientes. El MCP de Administración cubre pedidos para comerciantes; todavía no hay equivalente para el asistente de un cliente.
• Una herramienta de políticas y FAQ, para que un asistente responda “cuál es la política de devoluciones” sin leer la página.

Hacia dónde seguir

• WebMCP — las herramientas en la página y cómo probarlas
• MCP para Tienda — el endpoint público y sus seis herramientas
• MCP de Administración — gestionar una tienda desde un agente