global.kalicart.com

{
    "ucp": {
        "version": "2026-08-25",
        "services": {
            "dev.ucp.shopping": [
                {
                    "spec": "https://ucp.dev/2026-08-25/specification/overview",
                    "schema": "https://ucp.dev/2026-08-25/services/shopping/mcp.openrpc.json",
                    "version": "2026-08-25",
                    "endpoint": "https://global.kalicart.com/ucp/mcp",
                    "transport": "mcp"
                }
            ]
        },
        "capabilities": {
            "dev.ucp.shopping.catalog.lookup": [
                {
                    "spec": "https://ucp.dev/2026-08-25/specification/shopping/catalog/lookup",
                    "schema": "https://ucp.dev/2026-08-25/schemas/shopping/catalog_lookup.json",
                    "version": "2026-08-25"
                }
            ],
            "dev.ucp.shopping.catalog.search": [
                {
                    "spec": "https://ucp.dev/2026-08-25/specification/shopping/catalog/search",
                    "schema": "https://ucp.dev/2026-08-25/schemas/shopping/catalog_search.json",
                    "version": "2026-08-25"
                }
            ],
            "com.kalicart.global.catalog.offer_checks": [
                {
                    "spec": "https://global.kalicart.com/ucp/extensions/offer-checks",
                    "schema": "https://global.kalicart.com/ucp/schemas/offer_checks.json",
                    "extends": "dev.ucp.shopping.catalog.lookup",
                    "version": "2026-10-22"
                }
            ],
            "com.kalicart.global.catalog.result_facets": [
                {
                    "spec": "https://global.kalicart.com/ucp/extensions/result-facets",
                    "schema": "https://global.kalicart.com/ucp/schemas/result_facets.json",
                    "extends": "dev.ucp.shopping.catalog.search",
                    "version": "2026-10-22"
                }
            ],
            "com.kalicart.global.catalog.offer_attestation": [
                {
                    "spec": "https://global.kalicart.com/ucp/extensions/offer-attestation",
                    "schema": "https://global.kalicart.com/ucp/schemas/offer_attestation.json",
                    "extends": "dev.ucp.shopping.catalog.lookup",
                    "version": "2026-10-22"
                }
            ],
            "com.kalicart.global.catalog.variant_constraints": [
                {
                    "spec": "https://global.kalicart.com/ucp/extensions/variant-constraints",
                    "schema": "https://global.kalicart.com/ucp/schemas/variant_constraints.json",
                    "extends": "dev.ucp.shopping.catalog.search",
                    "version": "2026-10-22"
                }
            ]
        },
        "payment_handlers": []
    },
    "keys": [
        {
            "x": "pOWtTDgJqkIoMrJdxzh4X22dTOw6Ka8Yf3wpfHp6UO0",
            "alg": "EdDSA",
            "crv": "Ed25519",
            "kid": "kalicart-global-2026-09",
            "kty": "OKP",
            "use": "sig"
        }
    ]
}

# Kalicart Global — agent discovery

Kalicart Global is a **read-only, public** machine-readable discovery layer for federated multi-merchant commerce catalogs. No API key, no writes, no checkout, no payments mediated by Kalicart.

## Correction (common misconception for generic LLMs)

- **Global federation** lives on **global.kalicart.com** only for this layer: discovery JSON **and** all public reads under **`/v1/global-catalog/*`** (merchants, categories, products, search, product detail). Nothing in that path chains through `dashboard.kalicart.com/v1/agent-bridge` to function.
- **Merchant agent-bridge** (`https://dashboard.kalicart.com/v1/agent-bridge/{token}`) is **orthogonal**: one opaque token per **one** shop, usually discovered from **that shop’s** storefront `<head>` `<link rel="kalicart-catalog">`. It is **not** the global index entry and **not** a required hop after global discovery.

**Bootstrap order for generic agents**

1. `GET https://global.kalicart.com/.well-known/kalicart-global-discovery.json` (stable pointer)
2. `GET https://global.kalicart.com/v1/global-catalog/discovery` (full discovery; optional: `GET /` with `Accept: application/json` or `Accept: application/vnd.kalicart.global-discovery+json` — same body; vendor `Accept` yields `Content-Type: application/vnd.kalicart.global-discovery+json`)
3. Follow **`endpoints.*` in that JSON** — every URL is on **global.kalicart.com**

Semantics / architecture (longer): `GET https://global.kalicart.com/.well-known/kalicart-discovery-profile.json`

## Start here (machine-readable)

- **Discovery JSON (source of truth):** https://global.kalicart.com/v1/global-catalog/discovery
- **Same document via root:** send `GET https://global.kalicart.com/` with header `Accept: application/json`, `application/ld+json`, or **`Accept: application/vnd.kalicart.global-discovery+json`** to receive the discovery JSON (vendor type = stronger affordance for tools; identical JSON body).

`scope.type` is always `global_multi_merchant_catalog`. Every product in aggregated responses includes an explicit `merchant` object (who sells).

## Governed publication

Kalicart Global is not a raw scrape of storefront pages. Records are published from synchronized merchant catalogs under eligibility and opt-out rules. Product attributes may be omitted when semantic confidence or applicability rules are insufficient. Treat omissions as trust boundaries; do not infer missing values unless the discovery/product payload explicitly provides them.

## Federated provider authorization (commerce-consent)

A merchant on KaliCart Bridge may separately authorize KaliCart Global to deliver its public catalog to a named external product-discovery or agentic-commerce provider — a channel distinct from joining the Federated Catalog and from a merchant's own direct feed. Each provider is disabled by default and requires its own explicit, revocable, receipted authorization.

- **Protocol:** `kalicart-commerce-consent/1` — hash-chained, append-only local ledger on the merchant's Bridge; Global independently verifies every grant/revocation against the merchant's live discovery document before treating it as authorized.
- **Provider registry (machine-readable):** https://global.kalicart.com/v1/bridge/provider-consent/providers
- **Current provider:** `openai_acp` / purpose `product_discovery`. Defined in the protocol; **not yet operationally enabled** — no catalog data is delivered to this provider today.
- **Full reference page:** https://global.kalicart.com/providers/
- **Human-readable terms:** https://global.kalicart.com/terms/ (Commerce authorization `commerce-consent-1.0`)
- **Human-readable privacy:** https://global.kalicart.com/privacy/ (Federated provider authorizations) and https://bridge.kalicart.com/privacy/

## Endpoint map (absolute)

| Role | URL |
|------|-----|
| Discovery | https://global.kalicart.com/v1/global-catalog/discovery |
| Merchants index | https://global.kalicart.com/v1/global-catalog/merchants |
| Categories | https://global.kalicart.com/v1/global-catalog/categories |
| Products feed (paginated) | https://global.kalicart.com/v1/global-catalog/products |
| Search (requires `q`) | https://global.kalicart.com/v1/global-catalog/search?q={query} |
| Single product | https://global.kalicart.com/v1/global-catalog/product/{p2209_id} |
| Intent resolve (API) | POST https://global.kalicart.com/v1/global-catalog/intent/resolve — body `{ "utterance", "country", "limit", ... }` |
| Intent console (human trace) | https://global.kalicart.com/intent/ — inspection UI; same resolve contract, reasoning trace + offers |

## Suggested flow for an agent

1. Fetch discovery → read `endpoints.*`, `well_known.*`, `agent_instructions` if present. Response may include HTTP `Link: ...; rel="profile"` to the semantics document.
2. Optional: `GET .../merchants` to list participating shops.
3. Use `.../search?q=...` or `.../products` with safe filters for browsing.
4. Use `.../product/{p2209_id}` for detail; follow `links.ui` or merchant URLs for authoritative storefront offers.

## Single-merchant catalogs (not global)

Merchant storefront discovery uses a **different** token and scope (one merchant per token). Do not infer global coverage from a single merchant's `<link rel="kalicart-catalog">` alone.

## Human page

https://global.kalicart.com/ (HTML) — protocol-oriented summary: why the host exists, scope/limit notes, governed publication, links to discovery, `.well-known`, `llms.txt`, sitemap; `<link rel="canonical">` to this URL; `<link rel="describedby">` + `rel="kalicart-catalog"` + JSON-LD `DataCatalog` in `<body>`. Longer merchant-facing prose (same product, not normative): https://www.kalicart.com/global-discovery/