Kalicart Global

KaliCart Global — Federated Commerce Search for AI Agents

One query across many independent WooCommerce stores — real products, merchant-authoritative prices, indexed snapshots with a documented live-verification path back to the merchant. Keyless, read-only, no registration.

KaliCart Global is a public Model Context Protocol 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.

• Endpoint: https://global.kalicart.com/mcp-public (remote, Streamable HTTP) — https://dashboard.kalicart.com/mcp-public also works as a compatible alias
• Registry: io.github.giuseppesocci-bot/kalicart-global — official MCP registry, status active
• Docs: https://bridge.kalicart.com/mcp/ · ARC protocol: https://bridge.kalicart.com/spec/ · Provider authorization: https://global.kalicart.com/providers/
• Legal: https://global.kalicart.com/terms/ (Terms of Use, including optional federated provider-delivery channels) · https://global.kalicart.com/privacy/ (Privacy Notice)

Why it exists

Crawling 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 and authoritative by design, served as an indexed snapshot with a documented handoff back to the merchant's own Bridge for live verification before checkout.

Reading 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). Global brings the same structured, read-cheap surface to many merchants at once.

The same holds once the agent moves from reading to quoting. In a pre-registered benchmark on real stores, the same agent reached a store-confirmed delivered total through the merchant's Bridge with 69% fewer tokens than through the public WooCommerce Store API on complex tasks (variants, quantity limits, shipping thresholds, two stores), and with 47% fewer on variant tasks where both paths were right 20 times out of 20 (write-up, harness and data). Global finds the store; the Bridge is where the agent gets the total the store will charge.

Connect

Add it to your MCP client as a remote (Streamable HTTP) server — no API key or account required:

{

"mcpServers": { "kalicart-global": { "url": "https://global.kalicart.com/mcp-public" } } }

Tools

All five tools are public, keyless, read-only, and idempotent.

Typical flow: list_categories / list_merchants to understand coverage → global_search to find offers → get_product on finalists → hand off to the merchant storefront URL.

Behavior notes

• global_search with neither q nor leaf returns a query_required error (guidance_code: USE_Q_OR_LEAF), not an empty result set — pass at least one.
• list_categories without parent returns up to 100 leaves per call (truncated: true plus total and complete_via when there are more); use parent filtering or the paging hint to walk the full set.
• Search results and product details are indexed snapshots (provenance.fetched_at), not a live database read — verify the selected offer via its Bridge handoff before treating price or stock as final.
• Free-text queries match native merchant catalog text; there is no server-side translation. Use leaf and facet filters for language-neutral retrieval.
• Price filters operate in each offer's merchant currency; no FX conversion is applied.
• No pagination: use limit (max 25 for offers, 50 for merchants).

This 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.

The MIT license covers the contents of this repository only; the hosted service and catalog data are governed by the Terms of Use.

UCP Catalog

KaliCart Global also speaks the Universal Commerce Protocol Catalog capability (spec 2026-08-25), so any UCP shopping agent can query independent WooCommerce stores the same way it queries other UCP catalogs.

• Profile: https://global.kalicart.com/.well-known/ucp (catalog search + lookup, no checkout)
• Endpoint: https://global.kalicart.com/ucp/mcp (Streamable HTTP)
• Tools: search_catalog, lookup_catalog, get_product. Every request must carry meta["ucp-agent"].profile.

What to expect:

• Every variant carries its seller (the merchant), with a link to the store and, when declared, its refund policy.
• search_catalog returns an indexed snapshot (metadata.kalicart.snapshot_at). get_product and lookup_catalog read price and availability live from the merchant's KaliCart Bridge when it answers in time (metadata.kalicart.source = "live"), and say so when they fall back to the snapshot.
• Prices are in ISO 4217 minor units. Identifiers are stable: gid://kalicart/Product/… and gid://kalicart/ProductVariant/….
• Categories use the KaliCart canonical taxonomy (taxonomy: "kalicart", e.g. home.bedroom.pillows); pass them back in filters.categories.
• Perimeter: the same catalog as the public Global API — every opted-in merchant, including wine and spirits and digital goods, with the store's own age and legal checks at checkout. Surfaces built for one specific platform apply that platform's narrower product policy; the UCP endpoint does not.
• Only merchants that installed KaliCart Bridge and opted in are indexed. KaliCart never sells, checks out or takes payment: the purchase happens on the merchant's store, and its checkout is the final authority.

Feedback

If you are evaluating or integrating this server and hit unexpected behavior, open an issue. Including the UTC timestamp of your requests lets us correlate with server logs.

For security matters, see SECURITY.md — please do not report vulnerabilities via public issues.

Related

• [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.
• [kalicart-mcp](https://github.com/giuseppesocci-bot/kalicart-mcp) — per-site MCP plugin for WordPress content.

---

Maintained by Save The Brain · Giuseppe Socci