KaliCart Global (UCP Catalog)

io.github.giuseppesocci-botPublished by GitHub account giuseppesocci-botv1.0.0Updated Oct 27, 2026

UCP Catalog for independent WooCommerce stores: consented, federated, with live price checks.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingBusiness & Commerce

Overview

AI-generated overview

Remote, keyless MCP server that lets an assistant search a federated catalog of independent WooCommerce stores and look up product prices and availability.

What you can do
  • Search the federated catalog by free text, canonical category and facet filters, returning offers with prices, availability and storefront links
  • Look up products or variants by identifier, up to 25 at a time, with live price and stock reads from the merchant when it answers in time
  • Fetch full product detail, including variants, attributes and the merchant storefront URL
  • Check whether a merchant domain runs an ARC-compliant catalog, and list participating merchants and canonical category leaves
When to use it
Useful when an assistant needs to find real product offers across many independent merchants, compare prices and stock, or check catalog coverage before recommending a store. It is read-only and hands the shopper to the merchant's own store to buy.
Requirements
A remote Streamable HTTP endpoint; no API key, account or registration is required. The UCP endpoint requires each request to carry a meta ucp-agent profile. Network access to the hosted service is needed.
Before you install
Results are indexed snapshots, so price and stock should be verified through the merchant before being treated as final. The server never transacts or takes payment; purchases happen on the merchant's store. The catalog includes wine, spirits and digital goods, and the UCP endpoint does not apply any platform-specific product policy. The hosted service and catalog data are governed by separate terms, not the repository license.

Installation

In SourceWeft

  1. Open KaliCart Global (UCP Catalog) in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.giuseppesocci-bot%2Fkalicart-global-ucp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

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.

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:

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

Tools

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

ToolPurpose
global_searchSearch 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.
get_productFull product detail by p2209_id (obtained from global_search): price, availability, attributes, variants, direct storefront URL.
lookup_merchantCheck whether a merchant domain runs an ARC-compliant catalog (KaliCart Bridge). Returns bridge version, discovery URL and federated-indexing consent flags; a miss returns probe: "not_scheduled" rather than queuing a background check. Federated-indexing consent is separate from a merchant's optional authorization of a named external provider (see Legal above); this tool does not report per-provider authorization state.
list_merchantsList participating merchants with domain, storefront URL and product count.
list_categoriesList canonical category leaves with product counts; supports parent filtering.

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 — 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 — per-site MCP plugin for WordPress content.

Maintained by Save The Brain · Giuseppe Socci

Source: README.md at commit c4869ba

Tools

3

search_catalog

Search products across merchants (UCP Catalog)

UCP Catalog search across independent WooCommerce merchants in KaliCart Global. catalog.query is free text; catalog.filters.categories accepts KaliCart canonical category values as returned in products[].categories (taxonomy "kalicart", e.g. "home.bedroom.pillows"); filters.price is in ISO 4217 minor units of catalog.context.currency (default EUR). Results are indexed snapshots with the seller on every variant; verify the chosen product with get_product before quoting price or stock.

Parametersmetacatalogrequired

lookup_catalog

Look up products or variants by id (UCP Catalog)

UCP Catalog lookup by product or variant identifier (gid://kalicart/Product/... or gid://kalicart/ProductVariant/...). Up to 25 ids. Reads price and availability live from each merchant when possible (metadata.kalicart.source = "live"), otherwise returns the indexed snapshot and says so. Unknown ids are reported as not_found messages.

Parametersmetacatalogrequired

get_product

Get product detail with live price and availability (UCP Catalog)

UCP Catalog product detail by product or variant id. Reads variants, price and availability live from the merchant KaliCart Bridge within a short time budget; if the merchant does not answer in time the indexed snapshot is returned and marked as such. The product url is the merchant storefront where the purchase happens.

Parametersmetacatalogrequired

Version history

1
  1. v1.0.0LatestSep 26, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts