{
  "markdown": "# KaliCart Global — Federated Commerce Search for AI Agents\n\n**One query across many independent WooCommerce stores — real products, merchant-authoritative prices, live availability. Keyless, read-only, no registration.**\n\nKaliCart Global is a public [Model Context Protocol](https://modelcontextprotocol.io) server that lets an AI agent search real product offers across independent merchants that opted in through the ARC (Agent-Readable Catalog) protocol. Instead of scraping a storefront and guessing at price and stock, an agent queries a structured, federated index and gets data it can trust — then hands the shopper off to the merchant's own store to complete the purchase. The server itself never transacts.\n\n- **Endpoint:** `https://dashboard.kalicart.com/mcp-public` (remote, Streamable HTTP)\n- **Registry:** [`io.github.giuseppesocci-bot/kalicart-global`](https://registry.modelcontextprotocol.io/v0/servers?search=kalicart) — official MCP registry, status `active`\n- **Docs:** https://bridge.kalicart.com/mcp/ · **ARC protocol:** https://bridge.kalicart.com/spec/\n\n## Why it exists\n\nCrawling a product page works when a machine only needs to *read* it. It breaks the moment an agent needs to *act* on a real price and real stock — the price may be stale, the stock may be phantom, the variant may not exist. KaliCart's approach is to make a catalog **computable** rather than merely crawlable: queryable, authoritative and real-time by design.\n\nReading a catalog this way is also far cheaper. A companion case study on the Bridge layer measured a live 626-product catalog served to an agent in **8,000 tokens instead of 196,595** — a ~24× reduction, small enough to fit a listing inside a model's context window instead of overflowing it ([read it](https://bridge.kalicart.com/blog/woocommerce-agent-token-cost/)). Global brings the same structured, read-cheap surface to many merchants at once.\n\n## Connect\n\nAdd it to your MCP client as a remote (Streamable HTTP) server — no API key or account required:\n\n```json\n{\n  \"mcpServers\": {\n    \"kalicart-global\": {\n      \"url\": \"https://dashboard.kalicart.com/mcp-public\"\n    }\n  }\n}\n```\n\n## Tools\n\nAll five tools are public, keyless, read-only, and idempotent.\n\n| Tool | Purpose |\n|---|---|\n| `global_search` | Search the federated index by free text (`q`) and/or canonical category (`leaf`), with facet filters (brand, gender, color, price range, stock). Returns offers with merchant-authoritative prices, UCP `availability_status`, storefront URLs and canonical category leaves. |\n| `get_product` | Full product detail by `p2209_id` (obtained from `global_search`): price, availability, attributes, variants, direct storefront URL. |\n| `lookup_merchant` | Check whether a merchant domain runs an ARC-compliant catalog (KaliCart Bridge). Returns bridge version, discovery URL and federated-indexing consent flags. A miss schedules a background probe. |\n| `list_merchants` | List participating merchants with domain, storefront URL and product count. |\n| `list_categories` | List canonical category leaves with product counts; supports `parent` filtering. |\n\nTypical flow: `list_categories` / `list_merchants` to understand coverage → `global_search` to find offers → `get_product` on finalists → hand off to the merchant storefront URL.\n\n### Behavior notes\n\n- `global_search` with neither `q` nor `leaf` returns an empty result set, not an error.\n- `list_categories` without `parent` returns the full leaf list.\n- Free-text queries match native merchant catalog text; there is no server-side translation. Use `leaf` and facet filters for language-neutral retrieval.\n- Price filters operate in each offer's merchant currency; no FX conversion is applied.\n- No pagination: use `limit` (max 25 for offers, 50 for merchants).\n\nThis repository is the public interface for the server — documentation, issue tracking and security contact. The server is a hosted service; its source is not published here.\n\n## Feedback\n\nIf you are evaluating or integrating this server and hit unexpected behavior, [open an issue](../../issues/new/choose). Including the UTC timestamp of your requests lets us correlate with server logs.\n\nFor security matters, see [SECURITY.md](SECURITY.md) — please do not report vulnerabilities via public issues.\n\n## Related\n\n- **[KaliCart Bridge](https://bridge.kalicart.com)** — the free WooCommerce plugin that makes a single merchant's catalog agent-readable (ARC). Bridge is the *door* on each store; Global is the *federated index* across many such doors.\n- **[kalicart-mcp](https://github.com/giuseppesocci-bot/kalicart-mcp)** — per-site MCP plugin for WordPress content.\n\n---\nMaintained by [Save The Brain](https://bridge.kalicart.com) · Giuseppe Socci\n\n",
  "bytes": 4734,
  "sha": "e680f50e44479b53a0cbfe4e4e80fd9ba8cbf2c58987db1e6585f3fe58e440a8",
  "repo_slug": "giuseppesocci-bot/kalicart-global",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_giuseppesocci_bot_kalicart_glo_91dbee3b/readme"
}