{"document_kind":"kalicart_merchant_agent_bridge","profile":"https://dashboard.kalicart.com/.well-known/kalicart-merchant-discovery-profile.json","scope_type":"single_merchant_catalog","human_readable_summary":"Kalicart merchant discovery: one opaque token maps to one store. Follow public_catalog.* for read-only product data — no checkout and no API key on public surfaces. Not the multi-merchant global index (see global.kalicart.com /v1/global-catalog/). Optional Accept: application/vnd.kalicart.merchant-discovery+json. Inventory/prices reflect Kalicart sync snapshots and merchant-authoritative pricing, not live POS realtime. Storefront discovery tags must be present in the raw HTML document from the merchant origin (not only after JavaScript runs).","intent_flags":{"single_merchant_only":true,"global_indexable":false,"federated_search_source":false,"agent_read_surface":true},"crawler_policy":{"allow_llm_training":false,"allow_live_agent_reads":true,"allow_global_indexing":false},"capabilities":{"search":true,"offers":true,"availability":true,"cart":false,"checkout":false,"payments":false,"mutations":false,"read_only":true},"authentication":{"required":false,"scheme":"none","notes":"This discovery document and public_catalog.* require no API key. Private REST/MCP on this host uses header X-Api-Key — never embed in storefront HTML."},"private_api":{"required":true,"scheme":"api_key_header","header":"X-Api-Key","use_for":["rest_v1","mcp","taxonomy_admin"]},"freshness":{"inventory_freshness":"kalicart_sync_snapshot","price_freshness":"merchant_authoritative","is_realtime_pos":false,"discovery_cache_ttl_seconds":300,"public_catalog_http_cache_max_age_seconds":300},"anti_global_semantics":{"orthogonal_to_federated_global_catalog":true,"do_not_follow_this_url_when_building_global_index":true},"content_negotiation":{"default_content_type":"application/json; charset=utf-8","kalicart_vendor_content_type":"application/vnd.kalicart.merchant-discovery+json; charset=utf-8","how_to_request_vendor":"Send Accept: application/vnd.kalicart.merchant-discovery+json on GET https://dashboard.kalicart.com/v1/agent-bridge/f01e9a7e33e75739a1c3c4b8b16d9d0906d0268de89a4386 — identical JSON body; use with generic agents that key off Content-Type."},"agent_instructions":"0) Agent: GET the storefront page and parse the initial HTML response (view-source). Find &lt;link rel=\"kalicart-catalog\"&gt; and/or &lt;link rel=\"kalicart-agent\"&gt; with the same href; do not assume tags appear only after running merchant JavaScript. Merchant: paste the static &lt;head&gt; block from the Kalicart dashboard so the CMS/server emits profile + bridge &lt;link&gt; and &lt;meta&gt; in that HTML source. 1) GET https://dashboard.kalicart.com/v1/agent-bridge/f01e9a7e33e75739a1c3c4b8b16d9d0906d0268de89a4386 — scoped to one shop; HTTP Link includes rel=\"profile\" and rel=\"describedby\" for https://dashboard.kalicart.com/.well-known/kalicart-merchant-discovery-profile.json. 2) Use public_catalog.* URLs — token-scoped, read-only. 3) Do not use this discovery URL as a node in the global federated index — use federated APIs only on https://global.kalicart.com/v1/global-catalog/. 4) Never expose X-Api-Key in HTML; it is separate from this opaque token.","well_known":{"discovery_profile_json":"https://dashboard.kalicart.com/.well-known/kalicart-merchant-discovery-profile.json","note":"RFC 8615 profile on the Kalicart dashboard host explains merchant vs global federation."},"architecture":{"discovery_host":"https://dashboard.kalicart.com","agent_bridge_path":"/v1/agent-bridge/{opaque_token}","global_federation_host":"https://global.kalicart.com","global_read_apis_under":"https://global.kalicart.com/v1/global-catalog","merchant_scope":"This discovery document never expands into other merchants. Rotating the token in the dashboard invalidates old storefront links."},"provider":"kalicart","schema_version":"1.1","discovery_kind":"kalicart_hosted","description":"Pointers to normalized catalog data on Kalicart (machine-readable layer for agents). This URL identifies your hosted discovery document; it is not your REST API key.","scope":{"type":"single_merchant_catalog","invariant":"This discovery document is scoped to one merchant catalog only. It does not link to or expand into the global multi-merchant catalog."},"link_relation":"kalicart-catalog","link_relations":["kalicart-catalog","kalicart-agent"],"discovery_document_url":"https://dashboard.kalicart.com/v1/agent-bridge/f01e9a7e33e75739a1c3c4b8b16d9d0906d0268de89a4386","recommended_head_link_html":"<link rel=\"kalicart-catalog\" type=\"application/vnd.kalicart.merchant-discovery+json\" href=\"https://dashboard.kalicart.com/v1/agent-bridge/f01e9a7e33e75739a1c3c4b8b16d9d0906d0268de89a4386\" />","recommended_head_markup_html":"<!-- Kalicart agent discovery: keep the following link/meta lines in server-rendered <head> so they appear in the raw HTML response; crawlers and many agents do not execute storefront JavaScript. -->\n<link rel=\"describedby\" type=\"application/vnd.kalicart.merchant-discovery-profile+json\" href=\"https://dashboard.kalicart.com/.well-known/kalicart-merchant-discovery-profile.json\" />\n<link rel=\"profile\" type=\"application/vnd.kalicart.merchant-discovery-profile+json\" href=\"https://dashboard.kalicart.com/.well-known/kalicart-merchant-discovery-profile.json\" />\n<link rel=\"kalicart-catalog\" type=\"application/vnd.kalicart.merchant-discovery+json\" href=\"https://dashboard.kalicart.com/v1/agent-bridge/f01e9a7e33e75739a1c3c4b8b16d9d0906d0268de89a4386\" />\n<link rel=\"kalicart-agent\" type=\"application/vnd.kalicart.merchant-discovery+json\" href=\"https://dashboard.kalicart.com/v1/agent-bridge/f01e9a7e33e75739a1c3c4b8b16d9d0906d0268de89a4386\" />\n<meta name=\"kalicart:scope\" content=\"single-merchant-catalog\" />\n<meta name=\"kalicart:global-index\" content=\"false\" />\n<meta name=\"kalicart:indexable-by-global\" content=\"false\" />","endpoints":{"api_info":"https://dashboard.kalicart.com/api/info","rest_base":"https://dashboard.kalicart.com/v1","mcp_http":"https://dashboard.kalicart.com/mcp","public_product_schema_template":"https://dashboard.kalicart.com/v1/schema/{p2209_id}"},"public_catalog":{"products_url":"https://dashboard.kalicart.com/v1/public-catalog/f01e9a7e33e75739a1c3c4b8b16d9d0906d0268de89a4386/products","product_url_template":"https://dashboard.kalicart.com/v1/public-catalog/f01e9a7e33e75739a1c3c4b8b16d9d0906d0268de89a4386/product/{p2209_id}","categories_url":"https://dashboard.kalicart.com/v1/public-catalog/f01e9a7e33e75739a1c3c4b8b16d9d0906d0268de89a4386/categories","search_url_template":"https://dashboard.kalicart.com/v1/public-catalog/f01e9a7e33e75739a1c3c4b8b16d9d0906d0268de89a4386/search?q={query}","authentication":"none","read_only":true,"cache":"public, max-age=300"},"purchase_intent":{"status":"planned","note":"Future buyer-authorized checkout intents should use short-lived, scoped buyer consent tokens and merchant checkout URLs. Kalicart does not process payments."},"taxonomy":{"note":"Public category counts for this merchant are available without API key. Private taxonomy admin remains under /v1/taxonomy/* with X-Api-Key.","public_categories_url":"https://dashboard.kalicart.com/v1/public-catalog/f01e9a7e33e75739a1c3c4b8b16d9d0906d0268de89a4386/categories","private_example_categories_url":"https://dashboard.kalicart.com/v1/taxonomy/categories"},"merchant":{"id":"project2209-com","canonical_domain":"project2209.com"},"merchant_id":"project2209-com"}