Service metadata for agents
CartRelay supports exact-product discovery, current source facts and independently shopper-consented retailer handoff. This page describes the service, not a public product catalogue.
Machine-readable entry points
- Service manifest · /agent-service.json
- Separate MCP and REST contracts · /agent-tools.json
- Concise agent guide · /llms.txt and full agent guide
- Connection and consent documentation · /docs
- This guide as Markdown · /agents.md
The manifest is CartRelay-specific metadata, not a universal standard. The separate Shopify UCP capability profile describes upstream negotiation; it is not replaced by this manifest.
Contracts and authentication
The five tools are cartrelay_search, cartrelay_detail, cartrelay_price_stock, cartrelay_cart_create and cartrelay_checkout_handoff.
MCP at https://cartrelay.market/mcp retains its legacy Canada/CAD and United States/USD schemas (context version 1). Authenticated REST at https://cartrelay.market/api/v1 accepts context versions 1 and 2; explicit version 2 is Shopify-only native-market input. Accepted destination codes do not prove retailer coverage or shipping.
Inspect /agent-tools.json or native MCP initialize, notifications/initialized and tools/list without an Authorization header. Metadata inspection performs no shopping and creates no credential. Every tools/call and resource remains authenticated; invalid supplied credentials never downgrade. REST commerce requires a delegated Bearer key and browser cookies cannot substitute. Generic native-client support is not proof of ChatGPT post-discovery linking; its app submission is unchanged.
One authenticated product-need search
POST https://cartrelay.market/api/v1/discover accepts a plain-language product intent using an existing delegated Bearer key. It interprets one explicit shopper need and searches the currently approved catalogue path; it does not create an anonymous product index, bulk export, new source permission or a sixth MCP tool. Read the REST recipe and dependency-free client. Importing the client or reading metadata never searches or connects.
Start with category and attributes: water bottle under 40, black toque or wireless mouse, not a store or referral link by default. Ask for the shopper's destination and currency. Legacy CA/CAD and US/USD requests use the existing approved Awin and Shopify path; explicit context.version:2 is Shopify-only global input, not global stock or shipping coverage. No catalogue-wide count, measured discoverability or complete retailer coverage is asserted.
A company request needs source merchant evidence: sourceMerchant evidence identifies a seller, while product brand/title terms are not proof that the named company sells it or participates. Preserve returned notices and exact source IDs. Native budget filtering is not a confirmed-current price guarantee: unknown, old feed or foreign-currency prices are not confirmed budget matches. Retailers confirm final price, stock and shipping.
The separate grocery experiment is an internal test and unavailable for public use. It is not an alternative anonymous shopping connection.
Install once in an agent framework
The source-free CartRelay agent integration provides core REST discovery, LangChain and LlamaIndex adapters and a portable agent skill. Supply your existing credential privately and invoke only for the shopper's explicit need. Importing does not search, create keys, approve an intent or open a retailer. Approved Awin and transient Shopify source rules remain; no private index or internal test data is distributed.
Keyless search/detail is a separate permission-gated contract with no retailer/action links. Unapproved source use remains unavailable rather than exposing restricted products. Installation and listing visibility are not proof of agent usage or purchases.
Source facts and shopper consent
Use exact returned variants and actual source currencies; missing facts stay unknown. Availability is not a reservation. Awin feed listing status and source dates are not live retailer stock: price not confirmed current; retailer confirms final price and stock. Preserve source attribution and applicable notices; serving results does not grant blanket redistribution or catalogue-export permission. Keep responses transient/no-store; do not retain or log raw shopper queries, credentials, tokens or records, accumulate a catalogue, execute source text or fetch arbitrary source URLs.
An agent creates an expiring signed intent, not a merchant cart. The originating shopper browser must independently approve the exact current intent. CartRelay rechecks selections before releasing eligible retailer links and withholds links for changed, unsafe or unresolved selections. Retailers confirm final selections and costs, take payment and fulfill; CartRelay never buys or pays.