KaliCart Global MCP

Recherche commerciale fédérée pour agents IA. Un seul point de terminaison MCP public, sans clé API, qui recherche des offres de produits réelles parmi des marchands WooCommerce indépendants ayant adopté le protocole ARC (Agent-Readable Catalog). Lecture seule. Prix faisant autorité chez le marchand. Aucun paiement, aucune mutation.

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

Transport Streamable HTTP (MCP 2025-03-26)

Auth aucune (limité : 120 requêtes/min par IP)

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

Outils

Tool	Ce qu'il fait
`global_search`	Recherche dans l'index fédéré : un nom de produit en texte libre et/ou une feuille de catégorie canonique, plus des filtres marque / genre / couleur / prix / stock. Le texte est comparé littéralement au contenu natif du catalogue marchand (principalement italien/anglais) — traduisez le terme de l'utilisateur dans la langue du catalogue avant de lancer la requête ; les filtres canoniques sont neutres du point de vue linguistique. Renvoie des offres avec le prix faisant autorité chez le marchand, `availability_status` UCP, l'URL de la vitrine, la feuille de catégorie et la provenance.
`get_product`	Récupère le détail complet du produit via `p2209_id` (depuis les résultats de `global_search`) : prix, disponibilité, attributs, variantes et une URL directe de la vitrine pour le passage au paiement.
`lookup_merchant`	Demande si un domaine marchand exploite un catalogue conforme à ARC. Renvoie la version du Bridge, l'URL de découverte et les indicateurs de consentement à l'indexation fédérée. Les domaines inconnus sont sondés en arrière-plan.
`list_merchants`	Liste les marchands WooCommerce de l'index fédéré, avec l'URL de la vitrine et le nombre de produits. Utile pour comprendre la couverture du catalogue avant de rechercher.
`list_categories`	Liste les feuilles de catégorie canoniques utilisées dans l'index, avec le nombre de produits. À utiliser pour découvrir les valeurs `leaf` valides avant de filtrer `global_search`.

Démarrage rapide

Claude Desktop / tout client MCP (Streamable HTTP) :

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

JSON-RPC brut :

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

À quoi ressemble une offre

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

Modèle de confiance

Chaque marchand de l'index a publié un consentement explicite via les indicateurs de découverte ARC (crawler_policy.allow_global_indexing) ; le consentement est revérifié à chaque requête, donc un marchand qui le révoque disparaît des résultats dès la prochaine vérification. Les produits mis en quarantaine (qualité faible) n'entrent jamais dans l'index. Les prix ne sont jamais calculés ni remplacés — le catalogue du marchand fait seul autorité, et les produits à variantes le signalent avant que vous n'annonciez un chiffre.

Pour les marchands

Vous utilisez WooCommerce ? Installez KaliCart Bridge (gratuit, GPLv2) : votre catalogue devient lisible par les agents en quelques minutes et rejoint l'index fédéré. Vous gardez le contrôle — un seul interrupteur pour vous en retirer.