KaliCart Global MCP

Ricerca commerciale federata per agenti AI. Un unico endpoint MCP pubblico, senza API key, che cerca offerte reali di prodotto tra merchant WooCommerce indipendenti che hanno aderito al protocollo ARC (Agent-Readable Catalog). Sola lettura. Prezzi autoritativi del merchant. Nessun pagamento, nessuna mutazione.

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

Transport Streamable HTTP (MCP 2025-03-26)

Auth nessuna (rate limit: 120 req/min per IP)

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

Tool

Tool	Cosa fa
`global_search`	Cerca nell'indice federato: un sostantivo di prodotto a testo libero e/o una foglia di categoria canonica, più filtri per brand / genere / colore / prezzo / disponibilità. Il testo viene confrontato letteralmente col contenuto nativo del catalogo merchant (principalmente italiano/inglese) — traduci il termine dell'utente nella lingua del catalogo prima di interrogare; i filtri canonici sono neutri rispetto alla lingua. Restituisce offerte con prezzo autoritativo del merchant, `availability_status` UCP, URL dello storefront, foglia di categoria e provenienza.
`get_product`	Recupera il dettaglio completo del prodotto tramite `p2209_id` (dai risultati di `global_search`): prezzo, disponibilità, attributi, varianti e un URL diretto dello storefront per il passaggio al checkout.
`lookup_merchant`	Chiede se un dominio merchant espone un catalogo conforme ad ARC. Restituisce versione del bridge, URL di discovery e flag di consenso all’indicizzazione federata. I domini sconosciuti vengono sondati in background.
`list_merchants`	Elenca i merchant WooCommerce nell'indice federato, con URL dello storefront e numero di prodotti. Utile per capire la copertura del catalogo prima di cercare.
`list_categories`	Elenca le foglie di categoria canoniche usate nell'indice, con conteggio prodotti. Usalo per scoprire i valori `leaf` validi prima di filtrare `global_search`.

Avvio rapido

Claude Desktop / qualsiasi client MCP (Streamable HTTP):

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

JSON-RPC grezzo:

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"}}}'

Com'è fatta un'offerta

{
  "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": "..." }
}

Modello di fiducia

Ogni merchant nell'indice ha pubblicato un consenso esplicito tramite i flag di discovery ARC (crawler_policy.allow_global_indexing); il consenso viene riverificato al momento della query, quindi un merchant che revoca scompare dai risultati al probe successivo. I prodotti in quarantena (bassa qualità) non entrano mai nell'indice. I prezzi non vengono mai calcolati né sostituiti — il catalogo del merchant è l'unica autorità, e i prodotti variabili lo dichiarano prima che tu citi una cifra.

Per i merchant

Usi WooCommerce? Installa KaliCart Bridge (gratuito, GPLv2): il tuo catalogo diventa leggibile dagli agenti in pochi minuti ed entra nell’indice federato. Il controllo resta a te — un solo interruttore per uscirne.