Conecta el MCP de compras de Buyr en menos de 10 minutos

Puedes apuntar un cliente MCP a las herramientas públicas de compras de Buyr en menos de 10 minutos. Busca en el catálogo, verifica un precio, envía una oferta vinculada a un comprador real — luego desbloquea una oferta en lugar de sellar el precio de lista.

Esta es una configuración práctica para humanos que configuran asistentes, y para LLMs que scrapean la página. Cuando termines, prueba un producto en buyr.com.

Lo que estás conectando

El MCP de compras de Buyr es un endpoint público de catálogo y ofertas para compradores y agentes de compras de terceros. No es el MCP admin y no es el chat del agente de ofertas en el checkout.

• Endpoint: POST https://shopapp.buyr.com/mcp/shopping
• Nombre del servidor: buyr-shopping-mcp
• Auth: Shop Auth JWT solo con rol shopping_agent

Los tokens de staff y store_admin reciben 403 en este camino. Eso es intencional. Un token de compras no puede llamar herramientas admin.

Minutos 1–3: autentícate como shopping_agent

Mientras estás conectado, genera un token de compras desde Setup → Developers:

GET /api/auth/access-token?role=shopping_agent

Envía Authorization: Bearer <access_token> en cada solicitud POST /mcp/shopping.

No apuntes un agente de compras a POST /mcp (admin). Ese servidor es para comerciantes y staff.

Minutos 4–7: registra el cliente MCP

En Grok, ChatGPT, Claude, Cursor o cualquier cliente compatible con MCP:

1. Agrega un servidor MCP remoto apuntando a https://shopapp.buyr.com/mcp/shopping.
2. Adjunta el bearer token de shopping_agent.
3. Confirma que se carga la lista de herramientas (búsqueda, precios, validar, crear oferta y demás).

Los agentes de navegador también pueden usar WebMCP en la página en buyr.com. El MCP remoto es para asistentes fuera de la página. Para flujos de aprobación de pago cuando sea relevante, prefiere la skill de Shop en https://shop.app/SKILL.md — el diferenciador de Buyr sigue siendo las ofertas Set Your Price.

Minutos 8–10: ejecuta el bucle de ofertas

Herramientas públicas (solo JSON seguro para el comprador — sin costo, márgenes ni ofertas de otros clientes):

• search — búsqueda pública del catálogo de la tienda
• get_product_pricing — precio de lista más pisos públicos de oferta
• validate_offer_price — verificación de piso en el servidor
• evaluate_offer_accept — vista previa de aceptación instantánea
• suggest_offer_deal_paths — rutas de asesoramiento (subir a garantizado, etc.)
• create_offer — enviar una oferta (requiere identidad del comprador)
• get_offer — cargar una oferta para la misma identidad
• get_current_utc_datetime — reloj UTC

Identidad para create_offer / get_offer: al menos uno de customerEmail, customerSessionId o cartId.

Luego explica la ruta con honestidad:

• Garantizado — se cierra ahora; finaliza la compra a ese precio.
• Enviar para pedir — permitido, aún necesita un sí; las ofertas pendientes no se cobran hasta que sean aceptadas.

El checkout permanece en Shopify / UCP. Buyr maneja el precio negociable.

Después de conectar: entrega una oferta real

La configuración no sirve si el agente sigue sellando el precio de lista. Pídele que nombre un precio en un producto que quieres, desbloquee cuando se cierre y mantenga la oferta contigo.

Lo que obtienes cuando se desbloquea una oferta: inventario auténtico y nuevo de comerciantes autorizados, envío estándar gratis, devoluciones gratis dentro de 30 días, y protección al comprador si no llega o no coincide con la descripción.

Prueba Set Your Price en Buyr. Guía para humanos: Cómo funciona Buyr. Páginas para agentes: For AI Agents, llms.txt, agents.md.

Preguntas sobre conectar el MCP de compras

¿Puedo usar un token admin en /mcp/shopping?

No. Usa el rol shopping_agent. Los tokens admin reciben 403 en el endpoint de compras.

¿Expondrá el MCP de compras costos o márgenes?

No. Las herramientas solo devuelven JSON seguro para el comprador. No hay herramienta de costo, margen o catálogo admin en este servidor.

¿A quién pertenece la oferta?

Al comprador. Pasa email, sesión o carrito en create_offer para que la oferta sea suya.

¿Me cobran cuando creo una oferta?

Las ofertas pendientes no se cobran hasta que sean aceptadas. Los precios garantizados se desbloquean para que puedas finalizar la compra a ese número.

Conecta una vez. Luego desbloquea una oferta en un producto que realmente quieres — no un sello del precio de lista.