Docs / API Reference

Contratos MCP para catálogo, inventario y contexto de tienda

Especificación orientada a implementación: cabeceras requeridas, payloads de entrada, respuestas y códigos de error más frecuentes.

Ver autenticación Ver errores

Autenticación HTTP

Incluye estas cabeceras en cada request al bridge.

x-mcp-bridge-key: mcp_live_xxxxx
x-mcp-store-id: store_abc123
content-type: application/json

Endpoint base

POST /api/mcp/execute
Host: bridge.tu-dominio.com

El endpoint ejecuta herramientas MCP usando payload normalizado.

Tool

get_product_data

Obtiene datos completos de un producto por SKU o ID interno.

Request
{
  "tool": "get_product_data",
  "input": { "sku": "SKU-001" }
}

Response 200
{
  "title": "Zapatilla Trail Pro",
  "price": 129.99,
  "currency": "USD",
  "variants": ["42", "43"],
  "inventory_status": "in_stock"
}

Tool

list_my_store_inventory

Lista inventario paginado para decisiones de disponibilidad en tiempo real.

Request
{
  "tool": "list_my_store_inventory",
  "input": { "page": 1, "limit": 50, "status": "in_stock" }
}

Response 200
{
  "items": [{ "sku": "SKU-001", "stock": 12 }],
  "total": 428,
  "updated_at": "2026-02-28T20:10:00Z"
}