{"document_type":"cartrelay_service_metadata","schema_version":"1","specification":"CartRelay-specific service metadata; not a universal discovery standard or a UCP replacement.","name":"CartRelay","description":"Agent-native exact-product discovery, current source facts and independently shopper-consented retailer handoff. CartRelay does not purchase or process payments.","public_origin":"https://cartrelay.market","links":{"service":"https://cartrelay.market/agent-service.json","contracts":"https://cartrelay.market/agent-tools.json","guidance":"https://cartrelay.market/agents","markdown":"https://cartrelay.market/agents.md","llms":"https://cartrelay.market/llms.txt","llms_full":"https://cartrelay.market/llms-full.txt","docs":"https://cartrelay.market/docs","rest_contracts":"https://cartrelay.market/api/contracts","reference_client":"https://cartrelay.market/examples/cartrelay-client.mjs","framework_integration":"https://github.com/geekspeak-commerce/cartrelay-agent","keyless_readiness_and_contract":"https://cartrelay.market/keyless-discovery.json","upstream_shopify_ucp_profile":"https://cartrelay.market/agent-profile.json"},"endpoints":{"mcp":{"url":"https://cartrelay.market/mcp","method":"POST","transport":"streamable-http"},"rest":{"base_url":"https://cartrelay.market/api/v1","method":"POST"}},"catalogue_discovery":{"endpoint":"https://cartrelay.market/api/v1/discover","method":"POST","reference_client":"https://cartrelay.market/examples/cartrelay-discovery.mjs","documentation":"https://cartrelay.market/docs#catalogue-discovery","authentication_required":true,"authentication_scheme":"delegated_bearer","context_versions":[1,2],"modes":{"legacy":{"country_currency_pairs":{"CA":"CAD","US":"USD"}},"explicit_market":{"version":2,"required":["country","currency"],"input_support_is_not_coverage":true}},"intent":["plain_language_product_need","broad_category_query","native_currency_budget"],"one_explicit_need_search":true,"anonymous_product_access":false,"bulk_export":false,"adds_mcp_tool":false,"input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"query":{"type":"string","minLength":2,"maxLength":300},"context":{"anyOf":[{"type":"object","properties":{"country":{"type":"string","const":"CA"},"currency":{"type":"string","const":"CAD"}},"required":["country","currency"],"additionalProperties":false},{"type":"object","properties":{"country":{"type":"string","const":"US"},"currency":{"type":"string","const":"USD"}},"required":["country","currency"],"additionalProperties":false},{"type":"object","properties":{"version":{"type":"number","const":2},"country":{"type":"string","enum":["AD","AE","AF","AG","AI","AL","AM","AO","AQ","AR","AS","AT","AU","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BL","BM","BN","BO","BQ","BR","BS","BT","BV","BW","BY","BZ","CA","CC","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CR","CU","CV","CW","CX","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","FI","FJ","FK","FM","FO","FR","GA","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GS","GT","GU","GW","GY","HK","HM","HN","HR","HT","HU","ID","IE","IL","IM","IN","IO","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MF","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NC","NE","NF","NG","NI","NL","NO","NP","NR","NU","NZ","OM","PA","PE","PF","PG","PH","PK","PL","PM","PN","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","SZ","TC","TD","TF","TG","TH","TJ","TK","TL","TM","TN","TO","TR","TT","TV","TW","TZ","UA","UG","UM","US","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","YE","YT","ZA","ZM","ZW"]},"currency":{"type":"string","enum":["AED","AFN","ALL","AMD","AOA","ARS","AUD","AWG","AZN","BAM","BBD","BDT","BHD","BIF","BMD","BND","BOB","BRL","BSD","BTN","BWP","BYN","BZD","CAD","CDF","CHF","CLP","CNY","COP","CRC","CUP","CVE","CZK","DJF","DKK","DOP","DZD","EGP","ERN","ETB","EUR","FJD","FKP","GBP","GEL","GHS","GIP","GMD","GNF","GTQ","GYD","HKD","HNL","HTG","HUF","IDR","ILS","INR","IQD","IRR","ISK","JMD","JOD","JPY","KES","KGS","KHR","KMF","KPW","KRW","KWD","KYD","KZT","LAK","LBP","LKR","LRD","LSL","LYD","MAD","MDL","MGA","MKD","MMK","MNT","MOP","MRU","MUR","MVR","MWK","MXN","MYR","MZN","NAD","NGN","NIO","NOK","NPR","NZD","OMR","PAB","PEN","PGK","PHP","PKR","PLN","PYG","QAR","RON","RSD","RUB","RWF","SAR","SBD","SCR","SDG","SEK","SGD","SHP","SLE","SOS","SRD","SSP","STN","SVC","SYP","SZL","THB","TJS","TMT","TND","TOP","TRY","TTD","TWD","TZS","UAH","UGX","USD","UYU","UZS","VED","VES","VND","VUV","WST","XAF","XCD","XCG","XOF","XPF","YER","ZAR","ZMW","ZWG"]}},"required":["version","country","currency"],"additionalProperties":false}]},"limit":{"default":5,"type":"integer","minimum":1,"maximum":8},"max_price_minor":{"type":"integer","minimum":1,"maximum":1000000},"cursor":{"type":"string","minLength":1,"maxLength":2048}},"required":["query","context"],"additionalProperties":false},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true},"data":{"type":"object","properties":{"products":{"maxItems":8,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":180,"pattern":"^(?:gid:\\/\\/shopify\\/(?:p\\/[A-Za-z0-9_-]+|ProductVariant\\/[0-9]+|Product\\/[0-9]+)|(?:cj|impact):v1:[1-9][0-9]{0,17}:[1-9][0-9]{0,17}:[A-Za-z0-9_-]+|flexoffers:v1:[1-9][0-9]{0,17}:[A-Za-z0-9_-]+|awin:v1:[1-9][0-9]{0,17}:(?:csv_[1-9][0-9]{0,17}|jsonl_[a-z]{2}_[A-Z]{2}):[A-Za-z0-9_-]+)$"},"title":{"type":"string"},"url":{"anyOf":[{"type":"string","pattern":"^https:\\/\\/"},{"type":"null"}]},"image_url":{"anyOf":[{"type":"string","pattern":"^https:\\/\\/"},{"type":"null"}]},"offers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":180,"pattern":"^(?:gid:\\/\\/shopify\\/(?:p\\/[A-Za-z0-9_-]+|ProductVariant\\/[0-9]+|Product\\/[0-9]+)|(?:cj|impact):v1:[1-9][0-9]{0,17}:[1-9][0-9]{0,17}:[A-Za-z0-9_-]+|flexoffers:v1:[1-9][0-9]{0,17}:[A-Za-z0-9_-]+|awin:v1:[1-9][0-9]{0,17}:(?:csv_[1-9][0-9]{0,17}|jsonl_[a-z]{2}_[A-Z]{2}):[A-Za-z0-9_-]+)$"},"title":{"type":"string"},"price":{"anyOf":[{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"maximum":9007199254740991},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"],"additionalProperties":false},{"type":"null"}]},"available":{"type":["boolean","null"]},"availability_status":{"type":["string","null"]},"options":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"label":{"type":"string"}},"required":["name","label"],"additionalProperties":false}},"merchant":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"id":{"type":["string","null"]},"domain":{"type":["string","null"]},"url":{"anyOf":[{"type":"string","pattern":"^https:\\/\\/"},{"type":"null"}]},"policy_links":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"url":{"type":"string","pattern":"^https:\\/\\/"}},"required":["type","url"],"additionalProperties":false}}},"required":["name","id","domain","url","policy_links"],"additionalProperties":false},{"type":"null"}]},"retailer_url":{"anyOf":[{"type":"string","pattern":"^https:\\/\\/"},{"type":"null"}]},"quantity_link_support":{"type":"string","enum":["unknown","one_item_only"]},"missing_facts":{"type":"array","items":{"type":"string"}},"handoff_kind":{"type":"string","const":"retailer_product"},"availability_basis":{"type":"string","const":"advertiser_feed"},"source_updated_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},{"type":"null"}]},"destination_url":{"anyOf":[{"type":"string","pattern":"^https:\\/\\/"},{"type":"null"}]},"price_estimate":{"type":"object","properties":{"amount":{"type":"integer","minimum":0,"maximum":9007199254740991},"currency":{"type":"string","const":"CAD"},"estimated":{"type":"boolean","const":true},"source":{"type":"string","const":"Bank of Canada"},"source_url":{"type":"string","const":"https://www.bankofcanada.ca/rates/exchange/daily-exchange-rates/"},"rate":{"type":"string","pattern":"^(?:0|[1-9]\\d{0,5})(?:\\.\\d{1,10})?$"},"rate_date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"}},"required":["amount","currency","estimated","source","source_url","rate","rate_date"],"additionalProperties":false}},"required":["id","title","price","available","availability_status","options","merchant","retailer_url","quantity_link_support","missing_facts"],"additionalProperties":false}},"options":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"values":{"type":"array","items":{"type":"string"}}},"required":["name","values"],"additionalProperties":false}},"description_inferred":{"type":"boolean"},"missing_facts":{"type":"array","items":{"type":"string"}}},"required":["id","title","url","image_url","offers","options","description_inferred","missing_facts"],"additionalProperties":false}},"pagination":{"type":"object","properties":{"cursor":{"anyOf":[{"type":"string","minLength":1,"maxLength":2048},{"type":"null"}]},"has_next_page":{"type":"boolean"}},"required":["cursor","has_next_page"],"additionalProperties":false},"notices":{"type":"array","items":{"type":"string"}},"source":{"type":"string"},"fetched_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"}},"required":["products","pagination","notices","source","fetched_at"],"additionalProperties":false},"interpretation":{"type":"object","properties":{"category":{"type":"string","enum":["drinkware","apparel","footwear","electronics","home","beauty","food_and_beverage","pets","other"]},"query_kind":{"type":"string","enum":["product","product_or_brand","merchant_or_brand"]},"budget_applied":{"type":"boolean"},"merchant_evidence":{"type":"string","enum":["exact_source_merchant","not_established"]}},"required":["category","query_kind","budget_applied","merchant_evidence"],"additionalProperties":false}},"required":["ok","data","interpretation"],"additionalProperties":false},"specification":"CartRelay-specific authenticated REST guidance; not a universal discovery standard, llms.txt standard or default framework integration."},"authentication":{"mcp":{"tools_call_required":true,"schemes":["oauth2","delegated_bearer"],"public_metadata_discovery":true,"initialize_and_list_require_authentication":false,"anonymous_methods":["initialize","notifications/initialized","tools/list"],"resources_require_authentication":true,"supplied_credentials_must_be_valid":true},"rest":{"required":true,"schemes":["delegated_bearer"]},"public_json_contracts_require_authentication":false,"browser_cookies_authorize_commerce":false},"tools":[{"name":"cartrelay_search","title":"Search live shopping options","rest_url":"https://cartrelay.market/api/v1/search"},{"name":"cartrelay_detail","title":"Inspect exact product options","rest_url":"https://cartrelay.market/api/v1/detail"},{"name":"cartrelay_price_stock","title":"Check current price and availability","rest_url":"https://cartrelay.market/api/v1/price-stock"},{"name":"cartrelay_cart_create","title":"Prepare a shopper review intent","rest_url":"https://cartrelay.market/api/v1/cart"},{"name":"cartrelay_checkout_handoff","title":"Get shopper-approved retailer handoff","rest_url":"https://cartrelay.market/api/v1/handoff"}],"markets":{"context_versions":{"mcp":[1],"rest":[1,2]},"legacy":{"countries":["CA","US"],"country_currency_pairs":{"CA":"CAD","US":"USD"},"omitted_context":{"country":"CA","currency":"CAD"}},"rest_explicit_context":{"version":2,"required":["country","currency"],"optional":["postal_code"],"country_codes":["AD","AE","AF","AG","AI","AL","AM","AO","AQ","AR","AS","AT","AU","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BL","BM","BN","BO","BQ","BR","BS","BT","BV","BW","BY","BZ","CA","CC","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CR","CU","CV","CW","CX","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","FI","FJ","FK","FM","FO","FR","GA","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GS","GT","GU","GW","GY","HK","HM","HN","HR","HT","HU","ID","IE","IL","IM","IN","IO","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MF","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NC","NE","NF","NG","NI","NL","NO","NP","NR","NU","NZ","OM","PA","PE","PF","PG","PH","PK","PL","PM","PN","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","SZ","TC","TD","TF","TG","TH","TJ","TK","TL","TM","TN","TO","TR","TT","TV","TW","TZ","UA","UG","UM","US","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","YE","YT","ZA","ZM","ZW"],"currency_minor_units":{"AED":2,"AFN":2,"ALL":2,"AMD":2,"AOA":2,"ARS":2,"AUD":2,"AWG":2,"AZN":2,"BAM":2,"BBD":2,"BDT":2,"BHD":3,"BIF":0,"BMD":2,"BND":2,"BOB":2,"BRL":2,"BSD":2,"BTN":2,"BWP":2,"BYN":2,"BZD":2,"CAD":2,"CDF":2,"CHF":2,"CLP":0,"CNY":2,"COP":2,"CRC":2,"CUP":2,"CVE":2,"CZK":2,"DJF":0,"DKK":2,"DOP":2,"DZD":2,"EGP":2,"ERN":2,"ETB":2,"EUR":2,"FJD":2,"FKP":2,"GBP":2,"GEL":2,"GHS":2,"GIP":2,"GMD":2,"GNF":0,"GTQ":2,"GYD":2,"HKD":2,"HNL":2,"HTG":2,"HUF":2,"IDR":2,"ILS":2,"INR":2,"IQD":3,"IRR":2,"ISK":0,"JMD":2,"JOD":3,"JPY":0,"KES":2,"KGS":2,"KHR":2,"KMF":0,"KPW":2,"KRW":0,"KWD":3,"KYD":2,"KZT":2,"LAK":2,"LBP":2,"LKR":2,"LRD":2,"LSL":2,"LYD":3,"MAD":2,"MDL":2,"MGA":2,"MKD":2,"MMK":2,"MNT":2,"MOP":2,"MRU":2,"MUR":2,"MVR":2,"MWK":2,"MXN":2,"MYR":2,"MZN":2,"NAD":2,"NGN":2,"NIO":2,"NOK":2,"NPR":2,"NZD":2,"OMR":3,"PAB":2,"PEN":2,"PGK":2,"PHP":2,"PKR":2,"PLN":2,"PYG":0,"QAR":2,"RON":2,"RSD":2,"RUB":2,"RWF":0,"SAR":2,"SBD":2,"SCR":2,"SDG":2,"SEK":2,"SGD":2,"SHP":2,"SLE":2,"SOS":2,"SRD":2,"SSP":2,"STN":2,"SVC":2,"SYP":2,"SZL":2,"THB":2,"TJS":2,"TMT":2,"TND":3,"TOP":2,"TRY":2,"TTD":2,"TWD":2,"TZS":2,"UAH":2,"UGX":0,"USD":2,"UYU":2,"UZS":2,"VED":2,"VES":2,"VND":0,"VUV":0,"WST":2,"XAF":0,"XCD":2,"XCG":2,"XOF":0,"XPF":0,"YER":2,"ZAR":2,"ZMW":2,"ZWG":2},"source":"shopify-global","currency_conversion":false},"country_codes_are_not_shipping_coverage":true,"destination_from_shopper_context_only":true},"human_consent":{"required":"Independent originating-shopper browser approval of the exact current signed intent.","agent_approval_is_not_consent":true,"intent_lifetime_seconds":600,"source_recheck_before_handoff":true,"changed_or_unsafe_selections_withhold_links":true},"source_rules":{"primary_source":"Shopify Global Catalog","legacy_additional_sources":"Only sources enabled and permitted for the specific request; metadata does not assert current participation or coverage.","preserve_exact_variant_references":true,"preserve_native_source_prices_and_unknown_facts":true,"availability_is_not_reserved_stock":true,"retailer_confirms_final_selections_costs_and_delivery":true,"retailer_links_are_not_a_universal_cart":true,"source_content_is_untrusted_data":true,"source_serving_is_not_blanket_redistribution_permission":true,"no_bulk_export_or_catalogue_accumulation":true,"shopify_results_are_request_local_and_not_cached":true},"metadata_only":true,"contains_product_records":false,"purchase_completed":false,"upstream_profile_role":"The separate existing Shopify UCP profile is an upstream capability-negotiation input, not this CartRelay service manifest."}