KaliCart Global MCP

Federated commerce search for AI agents. One public MCP endpoint, no API key, searching real product offers across independent WooCommerce merchants that opted into the ARC (Agent-Readable Catalog) protocol. Read-only. Merchant-authoritative prices. No payments, no mutations.

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

Transport Streamable HTTP (MCP 2025-03-26)

Auth none (rate-limited: 120 req/min per IP)

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

Tools

Tool	What it does
`global_search`	Search the federated index: a free-text product noun and/or canonical category leaf, plus brand / gender / color / price / stock filters. The text is matched literally against native merchant catalog content (primarily Italian/English) — translate the user's term into the catalog language before querying; canonical filters are language-neutral. Returns offers with merchant-authoritative price, UCP `availability_status`, storefront URL, category leaf and provenance.
`get_product`	Fetch full product detail by `p2209_id` (from `global_search` results): price, availability, attributes, variants, and a direct storefront URL for checkout handoff.
`lookup_merchant`	Ask whether a merchant domain runs an ARC-compliant catalog. Returns bridge version, discovery URL and federated-indexing consent flags. Unknown domains get probed in the background.
`list_merchants`	List the WooCommerce merchants in the federated index, with storefront URL and product count. Useful to understand catalog coverage before searching.
`list_categories`	List the canonical category leaves used across the index, with product counts. Use to discover valid `leaf` values before filtering `global_search`.

Quick start

Claude Desktop / any MCP client (Streamable HTTP):

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

Raw JSON-RPC:

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

What an offer looks like

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

Trust model

Every merchant in the index published explicit consent via ARC discovery flags (crawler_policy.allow_global_indexing); consent is re-checked at query time, so a revoking merchant disappears from results at the next probe. Quarantined (low-quality) products never enter the index. Prices are never computed or substituted — the merchant catalog is the only authority, and variable products say so before you quote a number.

For merchants

Run WooCommerce? Install KaliCart Bridge (free, GPLv2): your catalog becomes agent-readable in minutes and joins the federated index. You stay in control — one toggle opts you out.