KaliCart Global MCP

Búsqueda comercial federada para agentes de IA. Un único endpoint MCP público, sin clave API, que busca ofertas de productos reales entre comerciantes WooCommerce independientes que se han adherido al protocolo ARC (Agent-Readable Catalog). Solo lectura. Precios con autoridad del comerciante. Sin pagos, sin mutaciones.

Endpoint https://dashboard.kalicart.com/mcp-public

Transport Streamable HTTP (MCP 2025-03-26)

Auth ninguna (limitado: 120 solicitudes/min por IP)

Spec https://bridge.kalicart.com/spec/

Herramientas

Tool	Qué hace
`global_search`	Busca en el índice federado: un sustantivo de producto en texto libre y/o una hoja de categoría canónica, más filtros de marca / género / color / precio / stock. El texto se compara literalmente con el contenido nativo del catálogo del comerciante (principalmente italiano/inglés) — traduzca el término del usuario al idioma del catálogo antes de consultar; los filtros canónicos son neutrales respecto al idioma. Devuelve ofertas con el precio con autoridad del comerciante, `availability_status` UCP, URL del escaparate, hoja de categoría y procedencia.
`get_product`	Obtiene el detalle completo del producto mediante `p2209_id` (de los resultados de `global_search`): precio, disponibilidad, atributos, variantes y una URL directa del escaparate para el paso al checkout.
`lookup_merchant`	Consulta si un dominio de comerciante ejecuta un catálogo conforme a ARC. Devuelve la versión del bridge, la URL de descubrimiento y los indicadores de consentimiento de indexación federada. Los dominios desconocidos se sondean en segundo plano.
`list_merchants`	Lista los comerciantes WooCommerce del índice federado, con URL del escaparate y número de productos. Útil para entender la cobertura del catálogo antes de buscar.
`list_categories`	Lista las hojas de categoría canónicas utilizadas en el índice, con el recuento de productos. Úsalo para descubrir valores `leaf` válidos antes de filtrar `global_search`.

Inicio rápido

Claude Desktop / cualquier cliente MCP (Streamable HTTP):

{
  "mcpServers": {
    "kalicart-global": {
      "type": "http",
      "url": "https://dashboard.kalicart.com/mcp-public"
    }
  }
}

JSON-RPC en bruto:

curl -X POST https://dashboard.kalicart.com/mcp-public \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"global_search","arguments":{"q":"prosecco"}}}'

Cómo es una oferta

{
  "merchant_domain": "project2209.com",
  "name": "MASCHIO DEI CAVALIERI PROSECCO VALDOBBIADENE ...",
  "url": "https://www.project2209.com/prodotto/...",
  "price": { "current": 48.8, "currency": "EUR",
             "display": "48,80 €", "authority": "merchant_catalog" },
  "availability_status": "in_stock",
  "category_leaf": "beverages.alcohol.sparkling_prosecco",
  "provenance": { "bridge_version": "1.0.x", "fetched_at": "..." }
}

Modelo de confianza

Cada comerciante del índice ha publicado un consentimiento explícito mediante los indicadores de descubrimiento de ARC (crawler_policy.allow_global_indexing); el consentimiento se vuelve a comprobar en el momento de la consulta, por lo que un comerciante que lo revoque desaparece de los resultados en el siguiente sondeo. Los productos en cuarentena (baja calidad) nunca entran en el índice. Los precios nunca se calculan ni se sustituyen — el catálogo del comerciante es la única autoridad, y los productos variables lo indican antes de que cites una cifra.

Para comerciantes

¿Usas WooCommerce? Instala KaliCart Bridge (gratis, GPLv2): tu catálogo se vuelve legible por agentes en minutos y se une al índice federado. Mantienes el control — un solo interruptor para salir.