ARC/1.0 Spec Bridge Docs

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

ToolWhat it does
global_searchSearch the federated index: free text (any language) and/or canonical category leaf, plus brand / gender / color / price / stock filters. Returns offers with merchant-authoritative price, UCP availability_status, storefront URL, category leaf and provenance.
lookup_merchantAsk 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.

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.76", "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.