← The evidence ledger
Evidence row 1734382
Observed , by probe.mcp/1.
- Kind
- mcp.tools
- About
- endpoint 36e9ed3a-f2e6-4321-81f9-8e767cfdf81a
- Recorded
- Previous row
- None: the first of its kind about this subject
- Body SHA-256
- 9fef20d709ddea297f9ffb691d24f6eb8a4ee1f426c2140c90fc48ee0b9db062
- Leaf
- 0x1096d09e6d457b58925ccd6cc270cbddd7d667d463a507698225f8cb3ea3d1a6
What was observed
{
"count": 14,
"tools": [
{
"description": "Ask a question about this store, such as what it sells, its policies, or its services.\n",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"ask": {
"properties": {
"attribution": {
"additionalProperties": true,
"description": "Platform attribution data. Attribution is not currently supported.",
"type": "object"
},
"context": {
"additionalProperties": true,
"description": "Buyer context for localization and personalization.",
"properties": {
"address_country": {
"type": "string"
},
"address_region": {
"type": "string"
},
"currency": {
"type": "string"
},
"intent": {
"type": "string"
},
"language": {
"type": "string"
},
"postal_code": {
"type": "string"
}
},
"type": "object"
},
"conversation": {
"description": "Opaque conversation identifier. Multi-turn conversations are not currently supported.",
"properties": {
"expires_at": {
"format": "date-time",
"type": "string"
},
"id": {
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"ids": {
"description": "Resource identifiers for grounding. Up to 10 Shopify product GIDs are supported.",
"items": {
"type": "string"
},
"type": "array"
},
"query": {
"description": "Natural-language question.",
"maxLength": 10000,
"type": "string"
},
"signals": {
"additionalProperties": true,
"description": "Platform environment data. Signals are not currently supported.",
"type": "object"
}
},
"required": [
"query"
],
"type": "object"
},
"meta": {
"description": "Metadata for UCP agent profile discovery.",
"properties": {
"ucp-agent": {
"properties": {
"profile": {
"description": "Agent profile URI for UCP discovery.",
"format": "uri",
"type": "string"
}
},
"required": [
"profile"
],
"type": "object"
}
},
"required": [
"ucp-agent"
],
"type": "object"
}
},
"required": [
"meta",
"ask"
],
"type": "object"
},
"name": "ask_business"
},
{
"description": "Cancels a cart.\n\nPrices in the response are integers in the currency's ISO 4217 minor units, paired with\na currency code: {\"amount\": 600, \"currency\": \"USD\"} is $6.00 and {\"amount\": 2500,\n\"currency\": \"USD\"} is $25.00. Convert to major units before quoting a price to a buyer\n(divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies\nsuch as JPY are already whole units).\n\n",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"description": "The ID of the cart. Format: 'gid://shopify/Cart/abc123'",
"type": "string"
},
"meta": {
"description": "Metadata for UCP agent profile discovery.",
"properties": {
"ucp-agent": {
"properties": {
"profile": {
"description": "Agent profile URI for UCP discovery.",
"format": "uri",
"type": "string"
}
},
"required": [
"profile"
],
"type": "object"
}
},
"required": [
"ucp-agent"
],
"type": "object"
}
},
"required": [
"meta",
"id"
],
"type": "object"
},
"name": "cancel_cart"
},
{
"description": "Cancels a checkout.\n\nPrices in the response are integers in the currency's ISO 4217 minor units, paired with\na currency code: {\"amount\": 600, \"currency\": \"USD\"} is $6.00 and {\"amount\": 2500,\n\"currency\": \"USD\"} is $25.00. Convert to major units before quoting a price to a buyer\n(divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies\nsuch as JPY are already whole units).\n\n",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"description": "The ID of the checkout to update. Format: 'gid://shopify/Checkout/abc123'",
"type": "string"
},
"meta": {
"description": "Metadata for UCP agent profile discovery.",
"properties": {
"ucp-agent": {
"properties": {
"profile": {
"description": "Agent profile URI for UCP discovery.",
"format": "uri",
"type": "string"
}
},
"required": [
"profile"
],
"type": "object"
}
},
"required": [
"ucp-agent"
],
"type": "object"
}
},
"required": [
"meta",
"id"
],
"type": "object"
},
"name": "cancel_checkout"
},
{
"description": "Completes a checkout and returns the checkout result. Returns details about the completed checkout, including order ID, Thank You Page URL, or any errors encountered.\n\nPrices in the response are integers in the currency's ISO 4217 minor units, paired with\na currency code: {\"amount\": 600, \"currency\": \"USD\"} is $6.00 and {\"amount\": 2500,\n\"currency\": \"USD\"} is $25.00. Convert to major units before quoting a price to a buyer\n(divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies\nsuch as JPY are already whole units).\n\n",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"checkout": {
"description": "Checkout properties.",
"properties": {
"attribution": {
"description": "Marketing attribution context for the buyer's session (referring domain, click IDs, UTM parameters).",
"properties": {
"activity_id_tag": {
"description": "Activity identifier parameter name.",
"type": "string"
},
"activity_id_value": {
"description": "Activity identifier value matching activity_id_tag.",
"type": "string"
},
"click_id_tag": {
"description": "Click identifier parameter name (e.g., 'gclid', 'fbclid').",
"type": "string"
},
"click_id_value": {
"description": "Click identifier value matching click_id_tag.",
"type": "string"
},
"referring_domain": {
"description": "Domain that referred the buyer to the merchant's storefront.",
"type": "string"
},
"utm_campaign": {
"description": "UTM campaign parameter.",
"type": "string"
},
"utm_content": {
"description": "UTM content parameter.",
"type": "string"
},
"utm_medium": {
"description": "UTM medium parameter.",
"type": "string"
},
"utm_source": {
"description": "UTM source parameter.",
"type": "string"
},
"utm_term": {
"description": "UTM term parameter.",
"type": "string"
}
},
"type": "object"
},
"buyer": {
"additionalProperties": true,
"properties": {
"consent": {
"additionalProperties": {
"additionalProperties": true,
"properties": {
"granted": {
"description": "Whether consent is granted.",
"type": "boolean"
},
"segments": {
"additionalProperties": {
"additionalProperties": true,
"properties": {
"granted": {
"description": "Whether consent is granted.",
"type": "boolean"
},
"source": {
"description": "Use platform for an explicit buyer decision. Business-sourced values do not update stored choices.",
"enum": [
"business",
"platform"
],
"type": "string"
}
},
"required": [
"granted",
"source"
],
"type": "object"
},
"description": "One level of refinements. Marketing supports dev.ucp.consent.marketing.email and dev.ucp.consent.marketing.sms; a segment overrides its parent.",
"type": "object"
},
"source": {
"description": "Use platform for an explicit buyer decision. Business-sourced values do not update stored choices.",
"enum": [
"business",
"platform"
],
"type": "string"
}
},
"required": [
"granted",
"source"
],
"type": "object"
},
"description": "Per-purpose buyer consent decisions, keyed by reverse-DNS identifiers. Omission leaves existing choices unchanged.",
"type": "object"
}
},
"type": "object"
},
"payment": {
"additionalProperties": true,
"description": "Payment information for this checkout.",
"properties": {
"instruments": {
"description": "Payment instruments for this checkout (e.g., credit cards, tokens, wallets).",
"items": {
"additionalProperties": true,
"allOf": [
{
"else": {
"properties": {
"credential": {
"properties": {
"type": {
"not": {
"const": "apple_pay_token"
}
}
},
"required": [
"type"
]
}
}
},
"if": {
"properties": {
"handler_id": {
"const": "apple-pay"
}
},
"required": [
"handler_id"
]
},
"then": {
"properties": {
"credential": {
"properties": {
"type": {
"const": "apple_pay_token"
}
},
"required": [
"type",
"payment_data"
]
},
"type": {
"const": "card"
}
},
"required": [
"billing_address",
"credential"
]
}
}
],
"properties": {
"billing_address": {
"additionalProperties": true,
"description": "Billing address for the instrument.",
"properties": {
"address_country": {
"description": "Country of the billing address in 2-letter ISO 3166-1 alpha-2 format.",
"type": "string"
},
"address_locality": {
"description": "Locality of the billing address.",
"type": "string"
},
"address_region": {
"description": "Region of the billing address.",
"type": "string"
},
"extended_address": {
"description": "Extended address of the billing address such as an apartment number, C/O, or alternative name.",
"type": "string"
},
"first_name": {
"description": "First name of the contact associated with the billing address.",
"type": "string"
},
"last_name": {
"description": "Last name of the contact associated with the billing address.",
"type": "string"
},
"phone_number": {
"description": "Phone number of the contact associated with the billing address.",
"type": "string"
},
"postal_code": {
"description": "Postal code of the billing address.",
"type": "string"
},
"street_address": {
"description": "Street address of the billing address.",
"type": "string"
}
},
"type": "object"
},
"credential": {
"additionalProperties": true,
"allOf": [
{
"else": {
"required": [
"type"
]
},
"if": {
"properties": {
"type": {
"const": "apple_pay_token"
}
},
"required": [
"type"
]
},
"then": {
"properties": {
"payment_data": {
"additionalProperties": true,
"properties": {
"data": {
"type": "string"
},
"header": {
"additionalProperties": true,
"anyOf": [
{
"required": [
"ephemeral_public_key"
]
},
{
"required": [
"wrapped_key"
]
}
],
"properties": {
"application_data": {
"type": "string"
},
"ephemeral_public_key": {
"type": "string"
},
"public_key_hash": {
"type": "string"
},
"transaction_id": {
"type": "string"
},
"wrapped_key": {
"type": "string"
}
},
"required": [
"public_key_hash",
"transaction_id"
],
"type": "object"
},
"signature": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"version",
"data",
"signature",
"header"
],
"type": "object"
},
"transaction_identifier": {
"type": "string"
},
"type": {
"const": "apple_pay_token"
}
},
"required": [
"type",
"payment_data"
]
}
}
],
"description": "Payment credential payload to process the transaction for this instrument.",
"properties": {
"approval_id": {
"description": "Identifier of the payment approval authorizing this credential, as returned by the approvals API. Required for shop_pay credentials when the merchant requires payment approvals.",
"type": "string"
},
"payment_data": {
"type": "object"
},
"token": {
"description": "Opaque payment token value, required except when restating a platform-listed instrument (e.g., a Shop Pay wallet card) whose token the platform re-derives from the instrument id.",
"type": "string"
},
"transaction_identifier": {
"type": "string"
},
"type": {
"description": "Namespaced token type using dot notation (e.g., stripe.token, merchant.token, google.pay).",
"type": "string"
}
},
"type": "object"
},
"display": {
"additionalProperties": true,
"description": "Display information for this payment instrument.",
"properties": {
"brand": {
"description": "Card brand (e.g., visa, mastercard), when available.",
"type": "string"
},
"expiry_month": {
"description": "Card expiry month (1-12). Required for card instruments.",
"type": "integer"
},
"expiry_year": {
"description": "Card expiry year. Required for card instruments.",
"type": "integer"
},
"funding_source": {
"description": "How the card is funded, as reported by Apple Pay.",
"enum": [
"debit",
"credit",
"prepaid",
"store"
],
"type": "string"
},
"last_digits": {
"description": "Last 4 digits of the card, when available.",
"type": "string"
},
"rich_card_art": {
"description": "Rich card art URL or identifier for the payment instrument.",
"type": "string"
},
"rich_text_description": {
"description": "Rich text description of the payment instrument for display purposes.",
"type": "string"
}
},
"type": "object"
},
"handler_id": {
"description": "Identifier of the payment handler that was used to generate this instrument.",
"type": "string"
},
"id": {
"description": "A unique identifier for this payment instrument instance.",
"type": "string"
},
"selected": {
"description": "Whether this instrument is the currently selected for the checkout.",
"type": "boolean"
},
"type": {
"description": "Instrument type. Apple Pay uses 'card' because the submitted instrument represents a tokenized card.",
"type": "string"
}
},
"required": [
"id",
"handler_id",
"type"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
"required": [
"payment"
],
"type": "object"
},
"id": {
"description": "The ID of the checkout to update. Format: 'gid://shopify/Checkout/abc123'",
"type": "string"
},
"meta": {
"description": "Metadata for UCP agent profile discovery.",
"properties": {
"idempotency-key": {
"description": "An idempotency key for completing the checkout.",
"type": "string"
},
"ucp-agent": {
"properties": {
"profile": {
"description": "Agent profile URI for UCP discovery.",
"format": "uri",
"type": "string"
}
},
"required": [
"profile"
],
"type": "object"
}
},
"required": [
"ucp-agent",
"idempotency-key"
],
"type": "object"
}
},
"required": [
"meta",
"id",
"checkout"
],
"type": "object"
},
"name": "complete_checkout"
},
{
"description": "Creates a new cart\n\nPrices in the response are integers in the currency's ISO 4217 minor units, paired with\na currency code: {\"amount\": 600, \"currency\": \"USD\"} is $6.00 and {\"amount\": 2500,\n\"currency\": \"USD\"} is $25.00. Convert to major units before quoting a price to a buyer\n(divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies\nsuch as JPY are already whole units).\n\n",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cart": {
"description": "Cart properties.",
"properties": {
"attribution": {
"description": "Marketing attribution context for the buyer's session (referring domain, click IDs, UTM parameters). Forwarded to the cart for downstream reporting.",
"properties": {
"activity_id_tag": {
"description": "Activity identifier parameter name.",
"type": "string"
},
"activity_id_value": {
"description": "Activity identifier value matching activity_id_tag.",
"type": "string"
},
"click_id_tag": {
"description": "Click identifier parameter name (e.g., 'gclid', 'fbclid').",
"type": "string"
},
"click_id_value": {
"description": "Click identifier value matching click_id_tag.",
"type": "string"
},
"referring_domain": {
"description": "Domain that referred the buyer to the merchant's storefront.",
"type": "string"
},
"utm_campaign": {
"description": "UTM campaign parameter.",
"type": "string"
},
"utm_content": {
"description": "UTM content parameter.",
"type": "string"
},
"utm_medium": {
"description": "UTM medium parameter.",
"type": "string"
},
"utm_source": {
"description": "UTM source parameter.",
"type": "string"
},
"utm_term": {
"description": "UTM term parameter.",
"type": "string"
}
},
"type": "object"
},
"buyer": {
"additionalProperties": true,
"description": "Information about the buyer including email and phone number.",
"properties": {
"consent": {
"additionalProperties": {
"additionalProperties": true,
"properties": {
"granted": {
"description": "Whether consent is granted.",
"type": "boolean"
},
"segments": {
"additionalProperties": {
"additionalProperties": true,
"properties": {
"granted": {
"description": "Whether consent is granted.",
"type": "boolean"
},
"source": {
"description": "Use platform for an explicit buyer decision. Business-sourced values do not update stored choices.",
"enum": [
"business",
"platform"
],
"type": "string"
}
},
"required": [
"granted",
"source"
],
"type": "object"
},
"description": "One level of refinements. Marketing supports dev.ucp.consent.marketing.email and dev.ucp.consent.marketing.sms; a segment overrides its parent.",
"type": "object"
},
"source": {
"description": "Use platform for an explicit buyer decision. Business-sourced values do not update stored choices.",
"enum": [
"business",
"platform"
],
"type": "string"
}
},
"required": [
"granted",
"source"
],
"type": "object"
},
"description": "Per-purpose buyer consent decisions, keyed by reverse-DNS identifiers. Omission leaves existing choices unchanged.",
"type": "object"
},
"email": {
"format": "email",
"type": "string"
},
"phone_number": {
"type": "string"
}
},
"type": "object"
},
"context": {
"additionalProperties": true,
"description": "Provisional context hints for localization and pricing. Used when authoritative data (e.g., shipping address) is missing; higher-resolution data supersedes these values and unsupported hints may be ignored without error.",
"properties": {
"address_country": {
"description": "Country hint for localization.",
"type": "string"
},
"address_region": {
"description": "Region/state hint for localization.",
"type": "string"
},
"currency": {
"description": "Preferred currency (ISO 4217, e.g., 'EUR', 'USD').",
"type": "string"
},
"eligibility": {
"description": "Buyer claims about eligible benefits such as loyalty membership, payment perks, and similar.",
"items": {
"description": "Reverse-domain identifier. Must contain at least two dot-separated segments (e.g., 'com.example.loyalty').",
"pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$",
"type": "string"
},
"type": "array"
},
"intent": {
"description": "Context describing buyer's intent.",
"type": "string"
},
"language": {
"description": "Language tag in IETF BCP 47 format.",
"type": "string"
},
"postal_code": {
"description": "Postal code hint for localization.",
"type": "string"
}
},
"type": "object"
},
"declared_fields": {
"description": "Merchant-defined cart or checkout fields and their values. On updates, replaces previously submitted custom field values; omitted or null fields are cleared. Send empty array to clear all custom fields.",
"items": {
"properties": {
"key": {
"description": "Unique identifier for the declared field.",
"type": "string"
},
"value": {
"description": "Submitted JSON value for the field. Null clears the value.",
"type": [
"string",
"number",
"boolean",
"object",
"array",
"null"
]
}
},
"required": [
"key",
"value"
],
"type": "object"
},
"type": "array"
},
"discounts": {
"description": "Discount or promo codes to apply to the cart. Only prompt if customer mentions having a discount code.",
"properties": {
"codes": {
"description": "Discount codes to apply. Case-insensitive. Replaces previously submitted codes. Send empty array to clear.",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"fulfillment": {
"description": "Information about the fulfillment.",
"properties": {
"methods": {
"description": "The methods of fulfillment.",
"items": {
"properties": {
"destinations": {
"description": "The destinations to fulfill to.",
"items": {
"properties": {
"address_country": {
"type": "string"
},
"address_locality": {
"type": "string"
},
"address_region": {
"type": "string"
},
"extended_address": {
"type": "string"
},
"first_name": {
"type": "string"
},
"id": {
"type": "string"
},
"last_name": {
"type": "string"
},
"phone_number": {
"type": "string"
},
"postal_code": {
"type": "string"
},
"street_address": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"groups": {
"description": "The groups to fulfill to.",
"items": {
"properties": {
"id": {
"type": "string"
},
"selected_option_id": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"selected_destination_id": {
"description": "ID of the selected destination.",
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
},
"line_items": {
"description": "Items to add to the cart or checkout. Required when creating a new cart or checkout.",
"items": {
"properties": {
"id": {
"description": "The ID of the line item to update.",
"type": "string"
},
"item": {
"properties": {
"id": {
"description": "The Product Variant ID to add or update.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"quantity": {
"type": "integer"
}
},
"required": [
"item",
"quantity"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"line_items"
],
"type": "object"
},
"meta": {
"description": "Metadata for UCP agent profile discovery.",
"properties": {
"ucp-agent": {
"properties": {
"profile": {
"description": "Agent profile URI for UCP discovery.",
"format": "uri",
"type": "string"
}
},
"required": [
"profile"
],
"type": "object"
}
},
"required": [
"ucp-agent"
],
"type": "object"
}
},
"required": [
"meta",
"cart"
],
"type": "object"
},
"name": "create_cart"
},
{
"description": "Creates a checkout. Returns checkout details, including line items, totals, and any applicable discounts or taxes.\n\nPrices in the response are integers in the currency's ISO 4217 minor units, paired with\na currency code: {\"amount\": 600, \"currency\": \"USD\"} is $6.00 and {\"amount\": 2500,\n\"currency\": \"USD\"} is $25.00. Convert to major units before quoting a price to a buyer\n(divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies\nsuch as JPY are already whole units).\n\n",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"checkout": {
"description": "Checkout properties.",
"properties": {
"attribution": {
"description": "Marketing attribution context for the buyer's session (referring domain, click IDs, UTM parameters).",
"properties": {
"activity_id_tag": {
"description": "Activity identifier parameter name.",
"type": "string"
},
"activity_id_value": {
"description": "Activity identifier value matching activity_id_tag.",
"type": "string"
},
"click_id_tag": {
"description": "Click identifier parameter name (e.g., 'gclid', 'fbclid').",
"type": "string"
},
"click_id_value": {
"description": "Click identifier value matching click_id_tag.",
"type": "string"
},
"referring_domain": {
"description": "Domain that referred the buyer to the merchant's storefront.",
"type": "string"
},
"utm_campaign": {
"description": "UTM campaign parameter.",
"type": "string"
},
"utm_content": {
"description": "UTM content parameter.",
"type": "string"
},
"utm_medium": {
"description": "UTM medium parameter.",
"type": "string"
},
"utm_source": {
"description": "UTM source parameter.",
"type": "string"
},
"utm_term": {
"description": "UTM term parameter.",
"type": "string"
}
},
"type": "object"
},
"buyer": {
"additionalProperties": true,
"description": "Information about the buyer including email and phone number.",
"properties": {
"consent": {
"additionalProperties": {
"additionalProperties": true,
"properties": {
"granted": {
"description": "Whether consent is granted.",
"type": "boolean"
},
"segments": {
"additionalProperties": {
"additionalProperties": true,
"properties": {
"granted": {
"description": "Whether consent is granted.",
"type": "boolean"
},
"source": {
"description": "Use platform for an explicit buyer decision. Business-sourced values do not update stored choices.",
"enum": [
"business",
"platform"
],
"type": "string"
}
},
"required": [
"granted",
"source"
],
"type": "object"
},
"description": "One level of refinements. Marketing supports dev.ucp.consent.marketing.email and dev.ucp.consent.marketing.sms; a segment overrides its parent.",
"type": "object"
},
"source": {
"description": "Use platform for an explicit buyer decision. Business-sourced values do not update stored choices.",
"enum": [
"business",
"platform"
],
"type": "string"
}
},
"required": [
"granted",
"source"
],
"type": "object"
},
"description": "Per-purpose buyer consent decisions, keyed by reverse-DNS identifiers. Omission leaves existing choices unchanged.",
"type": "object"
},
"email": {
"format": "email",
"type": "string"
},
"phone_number": {
"type": "string"
}
},
"type": "object"
},
"cart_id": {
"description": "Cart ID to convert to checkout. When provided, the business uses cart contents (line_items, context, buyer) and ignores overlapping fields in the checkout payload. line_items is still required: pass an empty array (\"line_items\": []). Format: 'gid://shopify/Cart/abc123?key=secret'",
"type": "string"
},
"context": {
"additionalProperties": true,
"description": "Provisional context hints for localization and pricing. Used when authoritative data (e.g., shipping address) is missing; higher-resolution data supersedes these values and unsupported hints may be ignored without error.",
"properties": {
"address_country": {
"description": "Country hint for localization.",
"type": "string"
},
"address_region": {
"description": "Region/state hint for localization.",
"type": "string"
},
"currency": {
"description": "Preferred currency (ISO 4217, e.g., 'EUR', 'USD').",
"type": "string"
},
"eligibility": {
"description": "Buyer claims about eligible benefits such as loyalty membership, payment perks, and similar.",
"items": {
"description": "Reverse-domain identifier. Must contain at least two dot-separated segments (e.g., 'com.example.loyalty').",
"pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$",
"type": "string"
},
"type": "array"
},
"intent": {
"description": "Context describing buyer's intent.",
"type": "string"
},
"language": {
"description": "Language tag in IETF BCP 47 format.",
"type": "string"
},
"postal_code": {
"description": "Postal code hint for localization.",
"type": "string"
}
},
"type": "object"
},
"declared_fields": {
"description": "Merchant-defined cart or checkout fields and their values. On updates, replaces previously submitted custom field values; omitted or null fields are cleared. Send empty array to clear all custom fields.",
"items": {
"properties": {
"key": {
"description": "Unique identifier for the declared field.",
"type": "string"
},
"value": {
"description": "Submitted JSON value for the field. Null clears the value.",
"type": [
"string",
"number",
"boolean",
"object",
"array",
"null"
]
}
},
"required": [
"key",
"value"
],
"type": "object"
},
"type": "array"
},
"discounts": {
"description": "Discount or promo codes to apply to the cart. Only prompt if customer mentions having a discount code.",
"properties": {
"codes": {
"description": "Discount codes to apply. Case-insensitive. Replaces previously submitted codes. Send empty array to clear.",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"fulfillment": {
"description": "Information about the fulfillment.",
"properties": {
"methods": {
"description": "The methods of fulfillment.",
"items": {
"properties": {
"destinations": {
"description": "The destinations to fulfill to.",
"items": {
"properties": {
"address_country": {
"type": "string"
},
"address_locality": {
"type": "string"
},
"address_region": {
"type": "string"
},
"extended_address": {
"type": "string"
},
"first_name": {
"type": "string"
},
"id": {
"type": "string"
},
"last_name": {
"type": "string"
},
"phone_number": {
"type": "string"
},
"postal_code": {
"type": "string"
},
"street_address": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"groups": {
"description": "The groups to fulfill to.",
"items": {
"properties": {
"id": {
"type": "string"
},
"selected_option_id": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"selected_destination_id": {
"description": "ID of the selected destination.",
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
},
"line_items": {
"description": "Items to add to the cart or checkout. Required when creating a new cart or checkout.",
"items": {
"properties": {
"id": {
"description": "The ID of the line item to update.",
"type": "string"
},
"item": {
"properties": {
"id": {
"description": "The Product Variant ID to add or update.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"quantity": {
"type": "integer"
}
},
"required": [
"item",
"quantity"
],
"type": "object"
},
"type": "array"
},
"payment": {
"additionalProperties": true,
"description": "Payment information for this checkout.",
"properties": {
"instruments": {
"description": "Payment instruments for this checkout (e.g., credit cards, tokens, wallets).",
"items": {
"additionalProperties": true,
"allOf": [
{
"else": {
"properties": {
"credential": {
"properties": {
"type": {
"not": {
"const": "apple_pay_token"
}
}
},
"required": [
"type"
]
}
}
},
"if": {
"properties": {
"handler_id": {
"const": "apple-pay"
}
},
"required": [
"handler_id"
]
},
"then": {
"properties": {
"credential": {
"properties": {
"type": {
"const": "apple_pay_token"
}
},
"required": [
"type",
"payment_data"
]
},
"type": {
"const": "card"
}
},
"required": [
"billing_address",
"credential"
]
}
}
],
"properties": {
"billing_address": {
"additionalProperties": true,
"description": "Billing address for the instrument.",
"properties": {
"address_country": {
"description": "Country of the billing address in 2-letter ISO 3166-1 alpha-2 format.",
"type": "string"
},
"address_locality": {
"description": "Locality of the billing address.",
"type": "string"
},
"address_region": {
"description": "Region of the billing address.",
"type": "string"
},
"extended_address": {
"description": "Extended address of the billing address such as an apartment number, C/O, or alternative name.",
"type": "string"
},
"first_name": {
"description": "First name of the contact associated with the billing address.",
"type": "string"
},
"last_name": {
"description": "Last name of the contact associated with the billing address.",
"type": "string"
},
"phone_number": {
"description": "Phone number of the contact associated with the billing address.",
"type": "string"
},
"postal_code": {
"description": "Postal code of the billing address.",
"type": "string"
},
"street_address": {
"description": "Street address of the billing address.",
"type": "string"
}
},
"type": "object"
},
"credential": {
"additionalProperties": true,
"allOf": [
{
"else": {
"required": [
"type"
]
},
"if": {
"properties": {
"type": {
"const": "apple_pay_token"
}
},
"required": [
"type"
]
},
"then": {
"properties": {
"payment_data": {
"additionalProperties": true,
"properties": {
"data": {
"type": "string"
},
"header": {
"additionalProperties": true,
"anyOf": [
{
"required": [
"ephemeral_public_key"
]
},
{
"required": [
"wrapped_key"
]
}
],
"properties": {
"application_data": {
"type": "string"
},
"ephemeral_public_key": {
"type": "string"
},
"public_key_hash": {
"type": "string"
},
"transaction_id": {
"type": "string"
},
"wrapped_key": {
"type": "string"
}
},
"required": [
"public_key_hash",
"transaction_id"
],
"type": "object"
},
"signature": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"version",
"data",
"signature",
"header"
],
"type": "object"
},
"transaction_identifier": {
"type": "string"
},
"type": {
"const": "apple_pay_token"
}
},
"required": [
"type",
"payment_data"
]
}
}
],
"description": "Payment credential payload to process the transaction for this instrument.",
"properties": {
"approval_id": {
"description": "Identifier of the payment approval authorizing this credential, as returned by the approvals API. Required for shop_pay credentials when the merchant requires payment approvals.",
"type": "string"
},
"payment_data": {
"type": "object"
},
"token": {
"description": "Opaque payment token value, required except when restating a platform-listed instrument (e.g., a Shop Pay wallet card) whose token the platform re-derives from the instrument id.",
"type": "string"
},
"transaction_identifier": {
"type": "string"
},
"type": {
"description": "Namespaced token type using dot notation (e.g., stripe.token, merchant.token, google.pay).",
"type": "string"
}
},
"type": "object"
},
"display": {
"additionalProperties": true,
"description": "Display information for this payment instrument.",
"properties": {
"brand": {
"description": "Card brand (e.g., visa, mastercard), when available.",
"type": "string"
},
"expiry_month": {
"description": "Card expiry month (1-12). Required for card instruments.",
"type": "integer"
},
"expiry_year": {
"description": "Card expiry year. Required for card instruments.",
"type": "integer"
},
"funding_source": {
"description": "How the card is funded, as reported by Apple Pay.",
"enum": [
"debit",
"credit",
"prepaid",
"store"
],
"type": "string"
},
"last_digits": {
"description": "Last 4 digits of the card, when available.",
"type": "string"
},
"rich_card_art": {
"description": "Rich card art URL or identifier for the payment instrument.",
"type": "string"
},
"rich_text_description": {
"description": "Rich text description of the payment instrument for display purposes.",
"type": "string"
}
},
"type": "object"
},
"handler_id": {
"description": "Identifier of the payment handler that was used to generate this instrument.",
"type": "string"
},
"id": {
"description": "A unique identifier for this payment instrument instance.",
"type": "string"
},
"selected": {
"description": "Whether this instrument is the currently selected for the checkout.",
"type": "boolean"
},
"type": {
"description": "Instrument type. Apple Pay uses 'card' because the submitted instrument represents a tokenized card.",
"type": "string"
}
},
"required": [
"id",
"handler_id",
"type"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
"required": [
"line_items"
],
"type": "object"
},
"meta": {
"description": "Metadata for UCP agent profile discovery.",
"properties": {
"ucp-agent": {
"properties": {
"profile": {
"description": "Agent profile URI for UCP discovery.",
"format": "uri",
"type": "string"
}
},
"required": [
"profile"
],
"type": "object"
}
},
"required": [
"ucp-agent"
],
"type": "object"
}
},
"required": [
"meta",
"checkout"
],
"type": "object"
},
"name": "create_checkout"
},
{
"description": "Get the cart contents\n\nPrices in the response are integers in the currency's ISO 4217 minor units, paired with\na currency code: {\"amount\": 600, \"currency\": \"USD\"} is $6.00 and {\"amount\": 2500,\n\"currency\": \"USD\"} is $25.00. Convert to major units before quoting a price to a buyer\n(divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies\nsuch as JPY are already whole units).\n\n",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"description": "The ID of the cart. Format: 'gid://shopify/Cart/abc123'",
"type": "string"
},
"meta": {
"description": "Metadata for UCP agent profile discovery.",
"properties": {
"ucp-agent": {
"properties": {
"profile": {
"description": "Agent profile URI for UCP discovery.",
"format": "uri",
"type": "string"
}
},
"required": [
"profile"
],
"type": "object"
}
},
"required": [
"ucp-agent"
],
"type": "object"
}
},
"required": [
"meta",
"id"
],
"type": "object"
},
"name": "get_cart"
},
{
"description": "Returns details about the checkout, including line items, totals, and any applicable discounts or taxes.\n\nPrices in the response are integers in the currency's ISO 4217 minor units, paired with\na currency code: {\"amount\": 600, \"currency\": \"USD\"} is $6.00 and {\"amount\": 2500,\n\"currency\": \"USD\"} is $25.00. Convert to major units before quoting a price to a buyer\n(divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies\nsuch as JPY are already whole units).\n\n",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"description": "The ID of the checkout to update. Format: 'gid://shopify/Checkout/abc123'",
"type": "string"
},
"meta": {
"description": "Metadata for UCP agent profile discovery.",
"properties": {
"ucp-agent": {
"properties": {
"profile": {
"description": "Agent profile URI for UCP discovery.",
"format": "uri",
"type": "string"
}
},
"required": [
"profile"
],
"type": "object"
}
},
"required": [
"ucp-agent"
],
"type": "object"
}
},
"required": [
"meta",
"id"
],
"type": "object"
},
"name": "get_checkout"
},
{
"description": "Get the details of an order\n\nPrices in the response are integers in the currency's ISO 4217 minor units, paired with\na currency code: {\"amount\": 600, \"currency\": \"USD\"} is $6.00 and {\"amount\": 2500,\n\"currency\": \"USD\"} is $25.00. Convert to major units before quoting a price to a buyer\n(divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies\nsuch as JPY are already whole units).\n\n",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"description": "The ID of the order. Format: 'gid://shopify/Order/123'",
"type": "string"
},
"meta": {
"description": "Metadata for UCP agent profile discovery.",
"properties": {
"ucp-agent": {
"properties": {
"profile": {
"description": "Agent profile URI for UCP discovery.",
"format": "uri",
"type": "string"
}
},
"required": [
"profile"
],
"type": "object"
}
},
"required": [
"ucp-agent"
],
"type": "object"
}
},
"required": [
"meta",
"id"
],
"type": "object"
},
"name": "get_order"
},
{
"description": "Retrieve complete product detail by identifier. Returns a singular product\nwith a relevant set of variants, exact pricing, and real-time availability.\nSupports interactive option selection via selected and preferences parameters\nfor variant narrowing and availability signals. Use for product detail page\nrendering and purchase decisions.\n\nPrices in the response are integers in the currency's ISO 4217 minor units, paired with\na currency code: {\"amount\": 600, \"currency\": \"USD\"} is $6.00 and {\"amount\": 2500,\n\"currency\": \"USD\"} is $25.00. Convert to major units before quoting a price to a buyer\n(divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies\nsuch as JPY are already whole units).\n\n",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"catalog": {
"description": "Product detail parameters.",
"properties": {
"context": {
"additionalProperties": true,
"description": "Buyer signals for localization and personalization.",
"properties": {
"address_country": {
"description": "Country code in ISO 3166-1 alpha-2 format.",
"type": "string"
},
"address_region": {
"description": "Region or state.",
"type": "string"
},
"currency": {
"description": "Currency code in ISO 4217 format.",
"type": "string"
},
"intent": {
"description": "Buyer intent.",
"type": "string"
},
"language": {
"description": "Language tag in IETF BCP 47 format.",
"type": "string"
},
"postal_code": {
"description": "Postal code.",
"type": "string"
}
},
"type": "object"
},
"filters": {
"additionalProperties": true,
"description": "Narrowing criteria for catalog results.",
"properties": {
"available": {
"default": true,
"description": "Filter by availability. Default true (only sale-ready items).",
"type": "boolean"
},
"categories": {
"description": "Category filters combined with OR logic.",
"items": {
"type": "string"
},
"type": "array"
},
"price": {
"description": "Price range filter.",
"properties": {
"max": {
"description": "Maximum price in minor currency units.",
"type": "integer"
},
"min": {
"description": "Minimum price in minor currency units.",
"type": "integer"
}
},
"type": "object"
}
},
"type": "object"
},
"id": {
"description": "Product ID.",
"type": "string"
},
"preferences": {
"description": "Buyer preferences.",
"items": {
"type": "string"
},
"type": "array"
},
"selected": {
"description": "Selected variant options.",
"items": {
"properties": {
"label": {
"type": "string"
},
"name": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"signals": {
"additionalProperties": true,
"description": "Platform environment data.",
"properties": {
"dev.ucp.buyer_ip": {
"description": "Buyer IP address.",
"type": "string"
},
"dev.ucp.user_agent": {
"description": "Buyer user agent.",
"type": "string"
}
},
"type": "object"
}
},
"required": [
"id"
],
"type": "object"
},
"meta": {
"description": "Metadata for UCP agent profile discovery.",
"properties": {
"ucp-agent": {
"properties": {
"profile": {
"description": "Agent profile URI for UCP discovery.",
"format": "uri",
"type": "string"
}
},
"required": [
"profile"
],
"type": "object"
}
},
"required": [
"ucp-agent"
],
"type": "object"
}
},
"required": [
"meta",
"catalog"
],
"type": "object"
},
"name": "get_product"
},
{
"description": "Look up multiple products or variants by identifier.\nUse this tool to resolve multiple product/variant IDs in a single request.\n\nSupports:\n- Product IDs (gid://shopify/Product/...): Returns product with match: \"featured\"\n- Variant IDs (gid://shopify/ProductVariant/...): Returns parent product with the exact variant\n\nResults are grouped by product. Each variant includes an inputs array showing\nwhich request ID resolved to it and whether the match was exact or featured.\nIn versions that require input correlations, only matched variants are returned.\n\nPrices in the response are integers in the currency's ISO 4217 minor units, paired with\na currency code: {\"amount\": 600, \"currency\": \"USD\"} is $6.00 and {\"amount\": 2500,\n\"currency\": \"USD\"} is $25.00. Convert to major units before quoting a price to a buyer\n(divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies\nsuch as JPY are already whole units).\n\n\nMaximum 10 IDs per request.\n",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"catalog": {
"description": "Catalog lookup parameters.",
"properties": {
"context": {
"additionalProperties": true,
"description": "Buyer signals for localization and personalization.",
"properties": {
"address_country": {
"description": "Country code in ISO 3166-1 alpha-2 format.",
"type": "string"
},
"address_region": {
"description": "Region or state.",
"type": "string"
},
"currency": {
"description": "Currency code in ISO 4217 format.",
"type": "string"
},
"intent": {
"description": "Buyer intent.",
"type": "string"
},
"language": {
"description": "Language tag in IETF BCP 47 format.",
"type": "string"
},
"postal_code": {
"description": "Postal code.",
"type": "string"
}
},
"type": "object"
},
"filters": {
"additionalProperties": true,
"description": "Narrowing criteria for catalog results.",
"properties": {
"available": {
"default": true,
"description": "Filter by availability. Default true (only sale-ready items).",
"type": "boolean"
},
"categories": {
"description": "Category filters combined with OR logic.",
"items": {
"type": "string"
},
"type": "array"
},
"price": {
"description": "Price range filter.",
"properties": {
"max": {
"description": "Maximum price in minor currency units.",
"type": "integer"
},
"min": {
"description": "Minimum price in minor currency units.",
"type": "integer"
}
},
"type": "object"
}
},
"type": "object"
},
"ids": {
"description": "Product IDs to look up.",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 1,
"type": "array"
},
"signals": {
"additionalProperties": true,
"description": "Platform environment data.",
"properties": {
"dev.ucp.buyer_ip": {
"description": "Buyer IP address.",
"type": "string"
},
"dev.ucp.user_agent": {
"description": "Buyer user agent.",
"type": "string"
}
},
"type": "object"
}
},
"required": [
"ids"
],
"type": "object"
},
"meta": {
"description": "Metadata for UCP agent profile discovery.",
"properties": {
"ucp-agent": {
"properties": {
"profile": {
"description": "Agent profile URI for UCP discovery.",
"format": "uri",
"type": "string"
}
},
"required": [
"profile"
],
"type": "object"
}
},
"required": [
"ucp-agent"
],
"type": "object"
}
},
"required": [
"meta",
"catalog"
],
"type": "object"
},
"name": "lookup_catalog"
},
{
"description": "Search for products from the online store, hosted on Shopify.\n\nThis tool can be used to search for products using natural language queries, specific filter criteria, or both.\nAt least one of query or filters must be provided.\n\nResults are paginated, with initial results limited to improve experience.\nUse the pagination.cursor from the response to fetch additional pages when users request more results.\n\nResponse conforms to the UCP catalog search capability (dev.ucp.shopping.catalog.search).\n\nPrices in the response are integers in the currency's ISO 4217 minor units, paired with\na currency code: {\"amount\": 600, \"currency\": \"USD\"} is $6.00 and {\"amount\": 2500,\n\"currency\": \"USD\"} is $25.00. Convert to major units before quoting a price to a buyer\n(divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies\nsuch as JPY are already whole units).\n\n",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"catalog": {
"description": "Catalog search parameters.",
"properties": {
"context": {
"additionalProperties": true,
"description": "Buyer signals for localization and personalization.",
"properties": {
"address_country": {
"description": "Country code in ISO 3166-1 alpha-2 format.",
"type": "string"
},
"address_region": {
"description": "Region or state.",
"type": "string"
},
"currency": {
"description": "Currency code in ISO 4217 format.",
"type": "string"
},
"intent": {
"description": "Buyer intent.",
"type": "string"
},
"language": {
"description": "Language tag in IETF BCP 47 format.",
"type": "string"
},
"postal_code": {
"description": "Postal code.",
"type": "string"
}
},
"type": "object"
},
"filters": {
"additionalProperties": true,
"description": "Narrowing criteria for catalog results.",
"properties": {
"available": {
"default": true,
"description": "Filter by availability. Default true (only sale-ready items).",
"type": "boolean"
},
"categories": {
"description": "Category filters combined with OR logic.",
"items": {
"type": "string"
},
"type": "array"
},
"price": {
"description": "Price range filter.",
"properties": {
"max": {
"description": "Maximum price in minor currency units.",
"type": "integer"
},
"min": {
"description": "Minimum price in minor currency units.",
"type": "integer"
}
},
"type": "object"
}
},
"type": "object"
},
"pagination": {
"description": "Pagination parameters.",
"properties": {
"cursor": {
"description": "Pagination cursor.",
"type": "string"
},
"limit": {
"default": 10,
"description": "Number of results to return.",
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"query": {
"description": "Search query string.",
"type": "string"
},
"signals": {
"additionalProperties": true,
"description": "Platform environment data.",
"properties": {
"dev.ucp.buyer_ip": {
"description": "Buyer IP address.",
"type": "string"
},
"dev.ucp.user_agent": {
"description": "Buyer user agent.",
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
},
"meta": {
"description": "Metadata for UCP agent profile discovery.",
"properties": {
"ucp-agent": {
"properties": {
"profile": {
"description": "Agent profile URI for UCP discovery.",
"format": "uri",
"type": "string"
}
},
"required": [
"profile"
],
"type": "object"
}
},
"required": [
"ucp-agent"
],
"type": "object"
}
},
"required": [
"meta",
"catalog"
],
"type": "object"
},
"name": "search_catalog"
},
{
"description": "Perform updates to a cart.\n\nPrices in the response are integers in the currency's ISO 4217 minor units, paired with\na currency code: {\"amount\": 600, \"currency\": \"USD\"} is $6.00 and {\"amount\": 2500,\n\"currency\": \"USD\"} is $25.00. Convert to major units before quoting a price to a buyer\n(divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies\nsuch as JPY are already whole units).\n\n",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"cart": {
"description": "Cart properties.",
"properties": {
"attribution": {
"description": "Marketing attribution context for the buyer's session (referring domain, click IDs, UTM parameters). Forwarded to the cart for downstream reporting.",
"properties": {
"activity_id_tag": {
"description": "Activity identifier parameter name.",
"type": "string"
},
"activity_id_value": {
"description": "Activity identifier value matching activity_id_tag.",
"type": "string"
},
"click_id_tag": {
"description": "Click identifier parameter name (e.g., 'gclid', 'fbclid').",
"type": "string"
},
"click_id_value": {
"description": "Click identifier value matching click_id_tag.",
"type": "string"
},
"referring_domain": {
"description": "Domain that referred the buyer to the merchant's storefront.",
"type": "string"
},
"utm_campaign": {
"description": "UTM campaign parameter.",
"type": "string"
},
"utm_content": {
"description": "UTM content parameter.",
"type": "string"
},
"utm_medium": {
"description": "UTM medium parameter.",
"type": "string"
},
"utm_source": {
"description": "UTM source parameter.",
"type": "string"
},
"utm_term": {
"description": "UTM term parameter.",
"type": "string"
}
},
"type": "object"
},
"buyer": {
"additionalProperties": true,
"description": "Information about the buyer including email and phone number.",
"properties": {
"consent": {
"additionalProperties": {
"additionalProperties": true,
"properties": {
"granted": {
"description": "Whether consent is granted.",
"type": "boolean"
},
"segments": {
"additionalProperties": {
"additionalProperties": true,
"properties": {
"granted": {
"description": "Whether consent is granted.",
"type": "boolean"
},
"source": {
"description": "Use platform for an explicit buyer decision. Business-sourced values do not update stored choices.",
"enum": [
"business",
"platform"
],
"type": "string"
}
},
"required": [
"granted",
"source"
],
"type": "object"
},
"description": "One level of refinements. Marketing supports dev.ucp.consent.marketing.email and dev.ucp.consent.marketing.sms; a segment overrides its parent.",
"type": "object"
},
"source": {
"description": "Use platform for an explicit buyer decision. Business-sourced values do not update stored choices.",
"enum": [
"business",
"platform"
],
"type": "string"
}
},
"required": [
"granted",
"source"
],
"type": "object"
},
"description": "Per-purpose buyer consent decisions, keyed by reverse-DNS identifiers. Omission leaves existing choices unchanged.",
"type": "object"
},
"email": {
"format": "email",
"type": "string"
},
"phone_number": {
"type": "string"
}
},
"type": "object"
},
"context": {
"additionalProperties": true,
"description": "Provisional context hints for localization and pricing. Used when authoritative data (e.g., shipping address) is missing; higher-resolution data supersedes these values and unsupported hints may be ignored without error.",
"properties": {
"address_country": {
"description": "Country hint for localization.",
"type": "string"
},
"address_region": {
"description": "Region/state hint for localization.",
"type": "string"
},
"currency": {
"description": "Preferred currency (ISO 4217, e.g., 'EUR', 'USD').",
"type": "string"
},
"eligibility": {
"description": "Buyer claims about eligible benefits such as loyalty membership, payment perks, and similar.",
"items": {
"description": "Reverse-domain identifier. Must contain at least two dot-separated segments (e.g., 'com.example.loyalty').",
"pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$",
"type": "string"
},
"type": "array"
},
"intent": {
"description": "Context describing buyer's intent.",
"type": "string"
},
"language": {
"description": "Language tag in IETF BCP 47 format.",
"type": "string"
},
"postal_code": {
"description": "Postal code hint for localization.",
"type": "string"
}
},
"type": "object"
},
"declared_fields": {
"description": "Merchant-defined cart or checkout fields and their values. On updates, replaces previously submitted custom field values; omitted or null fields are cleared. Send empty array to clear all custom fields.",
"items": {
"properties": {
"key": {
"description": "Unique identifier for the declared field.",
"type": "string"
},
"value": {
"description": "Submitted JSON value for the field. Null clears the value.",
"type": [
"string",
"number",
"boolean",
"object",
"array",
"null"
]
}
},
"required": [
"key",
"value"
],
"type": "object"
},
"type": "array"
},
"discounts": {
"description": "Discount or promo codes to apply to the cart. Only prompt if customer mentions having a discount code.",
"properties": {
"codes": {
"description": "Discount codes to apply. Case-insensitive. Replaces previously submitted codes. Send empty array to clear.",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"fulfillment": {
"description": "Information about the fulfillment.",
"properties": {
"methods": {
"description": "The methods of fulfillment.",
"items": {
"properties": {
"destinations": {
"description": "The destinations to fulfill to.",
"items": {
"properties": {
"address_country": {
"type": "string"
},
"address_locality": {
"type": "string"
},
"address_region": {
"type": "string"
},
"extended_address": {
"type": "string"
},
"first_name": {
"type": "string"
},
"id": {
"type": "string"
},
"last_name": {
"type": "string"
},
"phone_number": {
"type": "string"
},
"postal_code": {
"type": "string"
},
"street_address": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"groups": {
"description": "The groups to fulfill to.",
"items": {
"properties": {
"id": {
"type": "string"
},
"selected_option_id": {
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"type": "array"
},
"id": {
"type": "string"
},
"line_item_ids": {
"description": "The line item ids to fulfill.",
"items": {
"type": "string"
},
"type": "array"
},
"selected_destination_id": {
"description": "ID of the selected destination.",
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"line_item_ids"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
},
"line_items": {
"description": "Items to add to the cart or checkout. Required when creating a new cart or checkout.",
"items": {
"properties": {
"id": {
"description": "The ID of the line item to update.",
"type": "string"
},
"item": {
"properties": {
"id": {
"description": "The Product Variant ID to add or update.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"quantity": {
"type": "integer"
}
},
"required": [
"item",
"quantity"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"line_items"
],
"type": "object"
},
"id": {
"description": "The ID of the cart. Format: 'gid://shopify/Cart/abc123'",
"type": "string"
},
"meta": {
"description": "Metadata for UCP agent profile discovery.",
"properties": {
"ucp-agent": {
"properties": {
"profile": {
"description": "Agent profile URI for UCP discovery.",
"format": "uri",
"type": "string"
}
},
"required": [
"profile"
],
"type": "object"
}
},
"required": [
"ucp-agent"
],
"type": "object"
}
},
"required": [
"meta",
"cart",
"id"
],
"type": "object"
},
"name": "update_cart"
},
{
"description": "Updates a checkout. Returns checkout details, including line items, totals, and any applicable discounts or taxes.\n\nPrices in the response are integers in the currency's ISO 4217 minor units, paired with\na currency code: {\"amount\": 600, \"currency\": \"USD\"} is $6.00 and {\"amount\": 2500,\n\"currency\": \"USD\"} is $25.00. Convert to major units before quoting a price to a buyer\n(divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies\nsuch as JPY are already whole units).\n\n",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"checkout": {
"description": "Checkout properties.",
"properties": {
"attribution": {
"description": "Marketing attribution context for the buyer's session (referring domain, click IDs, UTM parameters).",
"properties": {
"activity_id_tag": {
"description": "Activity identifier parameter name.",
"type": "string"
},
"activity_id_value": {
"description": "Activity identifier value matching activity_id_tag.",
"type": "string"
},
"click_id_tag": {
"description": "Click identifier parameter name (e.g., 'gclid', 'fbclid').",
"type": "string"
},
"click_id_value": {
"description": "Click identifier value matching click_id_tag.",
"type": "string"
},
"referring_domain": {
"description": "Domain that referred the buyer to the merchant's storefront.",
"type": "string"
},
"utm_campaign": {
"description": "UTM campaign parameter.",
"type": "string"
},
"utm_content": {
"description": "UTM content parameter.",
"type": "string"
},
"utm_medium": {
"description": "UTM medium parameter.",
"type": "string"
},
"utm_source": {
"description": "UTM source parameter.",
"type": "string"
},
"utm_term": {
"description": "UTM term parameter.",
"type": "string"
}
},
"type": "object"
},
"buyer": {
"additionalProperties": true,
"description": "Information about the buyer including email and phone number.",
"properties": {
"consent": {
"additionalProperties": {
"additionalProperties": true,
"properties": {
"granted": {
"description": "Whether consent is granted.",
"type": "boolean"
},
"segments": {
"additionalProperties": {
"additionalProperties": true,
"properties": {
"granted": {
"description": "Whether consent is granted.",
"type": "boolean"
},
"source": {
"description": "Use platform for an explicit buyer decision. Business-sourced values do not update stored choices.",
"enum": [
"business",
"platform"
],
"type": "string"
}
},
"required": [
"granted",
"source"
],
"type": "object"
},
"description": "One level of refinements. Marketing supports dev.ucp.consent.marketing.email and dev.ucp.consent.marketing.sms; a segment overrides its parent.",
"type": "object"
},
"source": {
"description": "Use platform for an explicit buyer decision. Business-sourced values do not update stored choices.",
"enum": [
"business",
"platform"
],
"type": "string"
}
},
"required": [
"granted",
"source"
],
"type": "object"
},
"description": "Per-purpose buyer consent decisions, keyed by reverse-DNS identifiers. Omission leaves existing choices unchanged.",
"type": "object"
},
"email": {
"format": "email",
"type": "string"
},
"phone_number": {
"type": "string"
}
},
"type": "object"
},
"context": {
"additionalProperties": true,
"description": "Provisional context hints for localization and pricing. Used when authoritative data (e.g., shipping address) is missing; higher-resolution data supersedes these values and unsupported hints may be ignored without error.",
"properties": {
"address_country": {
"description": "Country hint for localization.",
"type": "string"
},
"address_region": {
"description": "Region/state hint for localization.",
"type": "string"
},
"currency": {
"description": "Preferred currency (ISO 4217, e.g., 'EUR', 'USD').",
"type": "string"
},
"eligibility": {
"description": "Buyer claims about eligible benefits such as loyalty membership, payment perks, and similar.",
"items": {
"description": "Reverse-domain identifier. Must contain at least two dot-separated segments (e.g., 'com.example.loyalty').",
"pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$",
"type": "string"
},
"type": "array"
},
"intent": {
"description": "Context describing buyer's intent.",
"type": "string"
},
"language": {
"description": "Language tag in IETF BCP 47 format.",
"type": "string"
},
"postal_code": {
"description": "Postal code hint for localization.",
"type": "string"
}
},
"type": "object"
},
"declared_fields": {
"description": "Merchant-defined cart or checkout fields and their values. On updates, replaces previously submitted custom field values; omitted or null fields are cleared. Send empty array to clear all custom fields.",
"items": {
"properties": {
"key": {
"description": "Unique identifier for the declared field.",
"type": "string"
},
"value": {
"description": "Submitted JSON value for the field. Null clears the value.",
"type": [
"string",
"number",
"boolean",
"object",
"array",
"null"
]
}
},
"required": [
"key",
"value"
],
"type": "object"
},
"type": "array"
},
"discounts": {
"description": "Discount or promo codes to apply to the cart. Only prompt if customer mentions having a discount code.",
"properties": {
"codes": {
"description": "Discount codes to apply. Case-insensitive. Replaces previously submitted codes. Send empty array to clear.",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"fulfillment": {
"description": "Information about the fulfillment.",
"properties": {
"methods": {
"description": "The methods of fulfillment.",
"items": {
"properties": {
"destinations": {
"description": "The destinations to fulfill to.",
"items": {
"properties": {
"address_country": {
"type": "string"
},
"address_locality": {
"type": "string"
},
"address_region": {
"type": "string"
},
"extended_address": {
"type": "string"
},
"first_name": {
"type": "string"
},
"id": {
"type": "string"
},
"last_name": {
"type": "string"
},
"phone_number": {
"type": "string"
},
"postal_code": {
"type": "string"
},
"street_address": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"groups": {
"description": "The groups to fulfill to.",
"items": {
"properties": {
"id": {
"type": "string"
},
"selected_option_id": {
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"type": "array"
},
"id": {
"type": "string"
},
"line_item_ids": {
"description": "The line item ids to fulfill.",
"items": {
"type": "string"
},
"type": "array"
},
"selected_destination_id": {
"description": "ID of the selected destination.",
"type": "string"
},
"type": {
"type": "string"
}
},
"required": [
"line_item_ids"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
},
"line_items": {
"description": "Items to add to the cart or checkout. Required when creating a new cart or checkout.",
"items": {
"properties": {
"id": {
"description": "The ID of the line item to update.",
"type": "string"
},
"item": {
"properties": {
"id": {
"description": "The Product Variant ID to add or update.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"quantity": {
"type": "integer"
}
},
"required": [
"item",
"quantity"
],
"type": "object"
},
"type": "array"
},
"payment": {
"additionalProperties": true,
"description": "Payment information for this checkout.",
"properties": {
"instruments": {
"description": "Payment instruments for this checkout (e.g., credit cards, tokens, wallets).",
"items": {
"additionalProperties": true,
"allOf": [
{
"else": {
"properties": {
"credential": {
"properties": {
"type": {
"not": {
"const": "apple_pay_token"
}
}
},
"required": [
"type"
]
}
}
},
"if": {
"properties": {
"handler_id": {
"const": "apple-pay"
}
},
"required": [
"handler_id"
]
},
"then": {
"properties": {
"credential": {
"properties": {
"type": {
"const": "apple_pay_token"
}
},
"required": [
"type",
"payment_data"
]
},
"type": {
"const": "card"
}
},
"required": [
"billing_address",
"credential"
]
}
}
],
"properties": {
"billing_address": {
"additionalProperties": true,
"description": "Billing address for the instrument.",
"properties": {
"address_country": {
"description": "Country of the billing address in 2-letter ISO 3166-1 alpha-2 format.",
"type": "string"
},
"address_locality": {
"description": "Locality of the billing address.",
"type": "string"
},
"address_region": {
"description": "Region of the billing address.",
"type": "string"
},
"extended_address": {
"description": "Extended address of the billing address such as an apartment number, C/O, or alternative name.",
"type": "string"
},
"first_name": {
"description": "First name of the contact associated with the billing address.",
"type": "string"
},
"last_name": {
"description": "Last name of the contact associated with the billing address.",
"type": "string"
},
"phone_number": {
"description": "Phone number of the contact associated with the billing address.",
"type": "string"
},
"postal_code": {
"description": "Postal code of the billing address.",
"type": "string"
},
"street_address": {
"description": "Street address of the billing address.",
"type": "string"
}
},
"type": "object"
},
"credential": {
"additionalProperties": true,
"allOf": [
{
"else": {
"required": [
"type"
]
},
"if": {
"properties": {
"type": {
"const": "apple_pay_token"
}
},
"required": [
"type"
]
},
"then": {
"properties": {
"payment_data": {
"additionalProperties": true,
"properties": {
"data": {
"type": "string"
},
"header": {
"additionalProperties": true,
"anyOf": [
{
"required": [
"ephemeral_public_key"
]
},
{
"required": [
"wrapped_key"
]
}
],
"properties": {
"application_data": {
"type": "string"
},
"ephemeral_public_key": {
"type": "string"
},
"public_key_hash": {
"type": "string"
},
"transaction_id": {
"type": "string"
},
"wrapped_key": {
"type": "string"
}
},
"required": [
"public_key_hash",
"transaction_id"
],
"type": "object"
},
"signature": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"version",
"data",
"signature",
"header"
],
"type": "object"
},
"transaction_identifier": {
"type": "string"
},
"type": {
"const": "apple_pay_token"
}
},
"required": [
"type",
"payment_data"
]
}
}
],
"description": "Payment credential payload to process the transaction for this instrument.",
"properties": {
"approval_id": {
"description": "Identifier of the payment approval authorizing this credential, as returned by the approvals API. Required for shop_pay credentials when the merchant requires payment approvals.",
"type": "string"
},
"payment_data": {
"type": "object"
},
"token": {
"description": "Opaque payment token value, required except when restating a platform-listed instrument (e.g., a Shop Pay wallet card) whose token the platform re-derives from the instrument id.",
"type": "string"
},
"transaction_identifier": {
"type": "string"
},
"type": {
"description": "Namespaced token type using dot notation (e.g., stripe.token, merchant.token, google.pay).",
"type": "string"
}
},
"type": "object"
},
"display": {
"additionalProperties": true,
"description": "Display information for this payment instrument.",
"properties": {
"brand": {
"description": "Card brand (e.g., visa, mastercard), when available.",
"type": "string"
},
"expiry_month": {
"description": "Card expiry month (1-12). Required for card instruments.",
"type": "integer"
},
"expiry_year": {
"description": "Card expiry year. Required for card instruments.",
"type": "integer"
},
"funding_source": {
"description": "How the card is funded, as reported by Apple Pay.",
"enum": [
"debit",
"credit",
"prepaid",
"store"
],
"type": "string"
},
"last_digits": {
"description": "Last 4 digits of the card, when available.",
"type": "string"
},
"rich_card_art": {
"description": "Rich card art URL or identifier for the payment instrument.",
"type": "string"
},
"rich_text_description": {
"description": "Rich text description of the payment instrument for display purposes.",
"type": "string"
}
},
"type": "object"
},
"handler_id": {
"description": "Identifier of the payment handler that was used to generate this instrument.",
"type": "string"
},
"id": {
"description": "A unique identifier for this payment instrument instance.",
"type": "string"
},
"selected": {
"description": "Whether this instrument is the currently selected for the checkout.",
"type": "boolean"
},
"type": {
"description": "Instrument type. Apple Pay uses 'card' because the submitted instrument represents a tokenized card.",
"type": "string"
}
},
"required": [
"id",
"handler_id",
"type"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
"required": [
"line_items"
],
"type": "object"
},
"id": {
"description": "The ID of the checkout to update. Format: 'gid://shopify/Checkout/abc123'",
"type": "string"
},
"meta": {
"description": "Metadata for UCP agent profile discovery.",
"properties": {
"ucp-agent": {
"properties": {
"profile": {
"description": "Agent profile URI for UCP discovery.",
"format": "uri",
"type": "string"
}
},
"required": [
"profile"
],
"type": "object"
}
},
"required": [
"ucp-agent"
],
"type": "object"
}
},
"required": [
"meta",
"checkout",
"id"
],
"type": "object"
},
"name": "update_checkout"
}
]
}What the leaf hashes
{"body":"9fef20d709ddea297f9ffb691d24f6eb8a4ee1f426c2140c90fc48ee0b9db062","id":1734382,"kind":"mcp.tools","method":"probe.mcp/1","observed_us":1793504496793426,"prev":null,"subject":"36e9ed3a-f2e6-4321-81f9-8e767cfdf81a","subject_kind":"endpoint"}Proof
Fold these into the leaf in order, hashing each sorted pair with keccak256, to reach the root of (302406 rows).
- 0x1096e5d540cecca6f35262661a0fe08cf39814c50a7d55903e35870efef7b444
- 0x502b105656048f85f580b2f3dfd97491d122dfa5ad6a677a3ba2bef815493bd9
- 0x3844501e041bb28126630a878192713e9186de05b0207294882254ba0d431ad5
- 0x927ad8be2f9cff43042c07b44924f1e46f8bf24245e09abd1c960a6422bbf4bc
- 0x035444a338cb8205b133a8356aad9f4e98a35b843a42afc2813a92fd7c6806e9
- 0xd141e784acb7c4d946110ac1ac75ece8ffadb51c5f5ce0107d17a30c8e8614d6
- 0x13caf65c8c9d3a4772c3651b0b9980fdd7f4ff196066902ac3b658c225efc9ca
- 0x1bb0d02fce97371179720e4514cb23ad2e5c7a6c12fc81be666a54951aaa56c5
- 0xde1c78204016e8122c0b3aadf944c416ab8f137ffa0cf98c127ed20bb86e9d58
- 0xe5fe8802bfd96a53f91cf95b8c846e0d5fd8b27ff30b40e6af455ed207117347
- 0xe4b2afd15ef27556203b782b729d76e0ad76e3f5ea16e95295b0d8625faedb2e
- 0xa9bd3046dfc06e0b37649b2bb4da456815f35fe0cfd8bbbd9e9ee8f2a0da3161
- 0x878db25c2f19310b2877bc95b8a8a21f712341fa2a543dcf19b36aa69747bc0a
- 0xb44b8d5019b9204aa2c2f558cdc381e6729b1aeca3e674741fa07287022b1f0f
- 0xf1aed005f71411c0df252d9623f284bcac7de199e24c4d4cd5df3e8d3348d3aa
- 0x5cf5a0a57795246f996e480f05ed085c19d02f7d6e8fc3ddc392412466554f0f
- 0x02b3554752e71a19b12d7a76dbff436e85387226ceec89fdebdcdaf0122c2932
- 0x1973893697931b7512ae5dc1a3c92ef92f633ae3574dce9029a35b5e94d2d364
- 0x3315fd2757fdd435852cc277377234a3f3909a6d2a089d0e36f6d59aacfda910
- Day root
- 0x7fa2cba1cf3d6b35630896f5fe1a650adb307ea2c376e80a5f2d9276b7cb5ab3
- Chained
- 0x577ff89ba012beeff3197bcff7fa86752074bdf54205a24359cc437be2a952a4
- Published
- On Arc Testnet, block 70262758: 0x435bc1b9331471d72e1998f2e420983b5189d4da65ffbd6f27ef40daf5e1ea90