VibeCart

Infraestructura comercial para aplicaciones creadas por IA y agentes de IA.

VibeCart permite que un comerciante mantenga su aplicación existente y su cuenta de Stripe, añadiendo una capa comercial pequeña e inspeccionable que los agentes de IA puedan descubrir y utilizar. Los pagos se liquidan directamente en la cuenta de Stripe del comerciante; VibeCart no necesita ser el comerciante registrado.

La arquitectura es primero el protocolo: un backend comercial de confianza, luego adaptadores MCP/UCP/cliente ligeros a su alrededor.

Superficie de producción activa

MCP genérico

Endpoint: https://vibecart.vercel.app/mcp

Herramientas:

• vibecart.list_products

• vibecart.get_product

• vibecart.get_integration_instructions

• vibecart.create_checkout

vibecart.create_checkout admite tanto la entrada heredada de un solo producto como la entrada confiable de múltiples artículos items[]. Los precios de los productos se resuelven en el servidor; los llamadores no proporcionan precios reales de transacción.

Los clientes MCP genéricos deben usar /mcp.

Carrito duradero

El carrito respaldado por Neon de VibeCart está activo en producción:

• POST /api/cart

• GET /api/cart/:id

• PATCH /api/cart/:id

• DELETE /api/cart/:id

• POST /api/cart/:id/checkout

El carrito usa revalorización confiable del lado del servidor, creación idempotente, comprobaciones de versiones optimistas, caducidad, estado de múltiples artículos y transferencia de carrito a Stripe Checkout.

UCP

• Descubrimiento: https://vibecart.vercel.app/.well-known/ucp

• Transporte MCP compatible con UCP: https://vibecart.vercel.app/ucp/mcp

• Objetivo de protocolo publicado: UCP 2026-04-08

La producción anuncia capacidades de catálogo y carrito publicadas. Las herramientas de carrito actuales son:

• create_cart

• get_cart

• update_cart

• cancel_cart

Las llamadas UCP requieren meta.ucp-agent.profile y negociación de capacidades. No dirija un cliente MCP normal a /ucp/mcp.

El pipeline de pedidos y el adaptador get_order de esquema publicado también existen, pero get_order permanece oculto hasta que se configuren sus dependencias de búsqueda en VibeCart Cloud y enlaces permanentes reales del comerciante. VibeCart no anuncia capacidades opcionales antes de que sus dependencias de tiempo de ejecución estén listas.

Stripe Checkout y pedidos

• Se admite la creación de Stripe Checkout de múltiples líneas de confianza.

• Las firmas de webhook de Stripe se verifican antes de que los eventos pagados entren en el pipeline posterior al pago.

• La finalización del pago retrasada se maneja por separado para que los pedidos no se creen prematuramente.

• Los artículos de línea de Checkout pagados se normalizan en registros de pedidos duraderos cuando se configura el reenvío de VibeCart Cloud.

• Los ID de productos de comerciante confiables sobreviven a Checkout a través de los metadatos del producto de Stripe.

Related MCP server: ACP Commerce MCP Server

Distribución agente-cliente

VibeCart no construye un motor comercial diferente para cada modelo. OpenAI/Codex/ChatGPT, Claude, Gemini, VS Code, Cursor y otros clientes MCP se conectan al mismo backend.

Véase:

• docs/integrations/agent-clients.md

• integrations/mcp-clients.json

• https://vibecart.vercel.app/mcp-clients.json

Los adaptadores de proveedores se verifican en CI para mantener los secretos de Stripe/base de datos y la lógica comercial duplicada fuera de la configuración del cliente.

VibeCart Cloud

VibeCart Core es gratuito para autoalojar. VibeCart Cloud es la capa administrada opcional de $29/mes para comerciantes que quieren que VibeCart opere la plomería recurrente.

Las capacidades actuales de Cloud incluyen:

• eventos comerciales verificados duraderos

• registros de pedidos pagados normalizados duraderos e historial de pedidos

• consulta de pedidos de servidor a servidor

• webhooks de cumplimiento firmados para comerciantes

• historial de entregas y reintentos acotados

• monitoreo/alertas y flujos de trabajo de soporte

Espacio de trabajo de Cloud: https://vibecart-cloud-uupzkh.v2.appdeploy.ai/

Los ingresos de los pagos del comerciante aún se liquidan directamente en la cuenta de Stripe del comerciante. VibeCart no toma ningún porcentaje de las ventas del comerciante.

Inicio rápido

npm install
npm run dev

Sin un secreto de Stripe, Checkout se ejecuta en modo de demostración claramente etiquetado. Para pagos en vivo, configure STRIPE_SECRET_KEY en la configuración de secretos/entorno del proveedor de alojamiento. Nunca comprometa valores secretos.

Endpoints públicos útiles:

• /mcp — transporte/descubrimiento MCP genérico

• /api/cart — creación de carrito duradero

• /.well-known/ucp — descubrimiento comercial UCP

• /ucp/mcp — transporte MCP compatible con UCP

• /mcp-clients.json — manifiesto de compatibilidad de cliente legible por máquina

• /llms.txt — notas de integración concisas legibles por máquina

• /agents.md — guía orientada a agentes

• /api/health — estado de preparación booleano sin valores secretos

• /cloud — oferta administrada de Cloud

Modelo de seguridad

• El comerciante posee la cuenta de Stripe y recibe los fondos del comerciante directamente.

• Los precios confiables provienen del estado del catálogo del comerciante en el servidor.

• El precio proporcionado por el cliente está deshabilitado por defecto y es solo prototipo cuando se habilita explícitamente en el servidor.

• Las firmas de webhook de Stripe se verifican antes del procesamiento posterior al pago.

• El estado del carrito es duradero y versionado, no se confía en el navegador/agente.

• Las credenciales de integración de Cloud permanecen en el servidor.

• Los endpoints públicos de salud/descubrimiento exponen booleanos de preparación/capacidades, no valores de credenciales.

• Las capacidades UCP opcionales se anuncian solo cuando sus dependencias de tiempo de ejecución son válidas.

Conformidad de protocolo

CI fija la fuente UCP publicada v2026-04-08 y ejecuta los mapeadores reales de VibeCart a través del validador oficial ucp-schema. Las cargas útiles de éxito/error del carrito, las respuestas del catálogo, el descubrimiento y el mapeador de pedidos privado tienen compuertas de conformidad fijadas en la publicación.

Límites de referencia actuales

• El catálogo del comerciante sigue siendo un pequeño catálogo de referencia en lugar de un servicio completo de catálogo multi-comerciante.

• El inventario, el cálculo de impuestos automatizado, el cálculo de tarifas de envío, las devoluciones/reembolsos y un ciclo de vida de cumplimiento completo no son servicios de plataforma terminados.

• La consulta pública de pedidos UCP permanece activada por activación hasta que se configuren sus dependencias de tiempo de ejecución de Cloud/enlace permanente.

• Next.js App Router es la implementación de referencia; otros frameworks deben usar adaptadores alrededor de la misma superficie de protocolo Core en lugar de bifurcar la lógica comercial.

Estrella polar

VibeCart: infraestructura comercial para cada agente de IA. Construye una vez. Vende en cualquier lugar donde la IA pueda actuar.

Licencia

MIT — libre de usar, modificar, distribuir, sublicenciar y vender bajo los términos de la licencia.