_ registry / mcp streamable-http · checked 12h ago

universal-commerce

https://chyrse-01.myshopify.com

Registry code: 06e502d3b01c16e6

api record

Shopify UCP storefront for Anywell’s electric wheelchairs, mobility scooters and compatible parts. Catalog discovery is public; cart and checkout actions require permission.

from a public catalogue that lists it, not from the operator

endpoint
https://chyrse-01.myshopify.com/api/ucp/mcp
protocol
streamable-http ·2025-06-18
authentication
none observed
public key
none — nobody has proven they own this listing · is it yours? claim it
karma
0 · newcomer
_ is it live, free and safe measured by this hub
Is universal-commerce live?
Yes — it answered the hub's last check (checked 12h ago). It answered 100% of checks over the last 30 days.
Is universal-commerce free to use?
Yes — the hub reached it with no key and no payment.
What tools does universal-commerce have?
16 tools: get_checkout, get_product, create_checkout, update_checkout, complete_checkout, cancel_checkout, get_cart, create_cart, ….
Is universal-commerce safe to connect?
The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.
reachable
live
uptime, 30 days
100%

90 days 100%· all time 100%

latency
281ms

last good check

priced tools
0

of 16 tools

_ answered our checks, 90 days 2 checks · signed record
  • unknown → live
_ usage and payments 30 days

Calls placed through this hub's router, from its own receipts. Every caller and every payer counts the same; the chain total is counted from three payers.

accounts
0

through this hub

calls served
0

successful

paid through this hub
0 USDC

what callers paid

inferred, not observed

Access was read off the card rather than seen on the wire: inferred: the handshake, the tool list and a call without arguments went through with no key and no payment asked; no tool was run

_ what it can do 16 tools
16 never probed 0 of 16 classified

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

  • get_checkout unknown 39h ago

    Returns details about the checkout, including line items, totals, and any applicable discounts or taxes. Prices in the response are integers in the currency's ISO 4217 minor units, paired with a currency code: {"amount": 600, "currency": "USD"} is $6.00 and {"amount": 2500, "currency": "USD"} is $25.00. Convert to major units before quoting a price to a buyer (divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies such as JPY are already whole units).

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "meta",
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The ID of the checkout to update. Format: 'gid://shopify/Checkout/abc123'"
        },
        "meta": {
          "type": "object",
          "required": [
            "ucp-agent"
          ],
          "properties": {
            "ucp-agent": {
              "type": "object",
              "required": [
                "profile"
              ],
              "properties": {
                "profile": {
                  "type": "string",
                  "format": "uri",
                  "description": "Agent profile URI for UCP discovery."
                }
              }
            }
          },
          "description": "Metadata for UCP agent profile discovery."
        }
      }
    }
    arguments 36 lines
  • get_product unknown 39h ago

    Retrieve complete product detail by identifier. Returns a singular product with a relevant set of variants, exact pricing, and real-time availability. Supports interactive option selection via selected and preferences parameters for variant narrowing and availability signals. Use for product detail page rendering and purchase decisions. Prices in the response are integers in the currency's ISO 4217 minor units, paired with a currency code: {"amount": 600, "currency": "USD"} is $6.00 and {"amount": 2500, "currency": "USD"} is $25.00. Convert to major units before quoting a price to a buyer (divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies such as JPY are already whole units).

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "meta",
        "catalog"
      ],
      "properties": {
        "meta": {
          "type": "object",
          "required": [
            "ucp-agent"
          ],
          "properties": {
            "ucp-agent": {
              "type": "object",
              "required": [
                "profile"
              ],
              "properties": {
                "profile": {
                  "type": "string",
                  "format": "uri",
                  "description": "Agent profile URI for UCP discovery."
                }
              }
            }
          },
          "description": "Metadata for UCP agent profile discovery."
        },
        "catalog": {
          "type": "object",
          "required": [
            "id"
          ],
          "properties": {
            "id": {
              "type": "string",
              "description": "Product ID."
            },
            "context": {
              "type": "object",
              "properties": {
                "intent": {
                  "type": "string",
                  "description": "Buyer intent."
                },
                "currency": {
                  "type": "string",
                  "description": "Currency code in ISO 4217 format."
                },
                "language": {
                  "type": "string",
                  "description": "Language tag in IETF BCP 47 format."
                },
                "postal_code": {
                  "type": "string",
                  "description": "Postal code."
                },
                "address_region": {
                  "type": "string",
                  "description": "Region or state."
                },
                "address_country": {
                  "type": "string",
                  "description": "Country code in ISO 3166-1 alpha-2 format."
                }
              },
              "description": "Buyer signals for localization and personalization.",
              "additionalProperties": true
            },
            "filters": {
              "type": "object",
              "properties": {
                "price": {
                  "type": "object",
                  "properties": {
                    "max": {
                      "type": "integer",
                      "description": "Maximum price in minor currency units."
                    },
                    "min": {
                      "type": "integer",
                      "description": "Minimum price in minor currency units."
                    }
                  },
                  "description": "Price range filter."
                },
                "available": {
                  "type": "boolean",
                  "default": true,
                  "description": "Filter by availability. Default true (only sale-ready items)."
                },
                "categories": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Category filters combined with OR logic."
                }
              },
              "description": "Narrowing criteria for catalog results.",
              "additionalProperties": true
            },
            "signals": {
              "type": "object",
              "properties": {
                "dev.ucp.buyer_ip": {
                  "type": "string",
                  "description": "Buyer IP address."
                },
                "dev.ucp.user_agent": {
                  "type": "string",
                  "description": "Buyer user agent."
                }
              },
              "description": "Platform environment data.",
              "additionalProperties": true
            },
            "selected": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "label": {
                    "type": "string"
                  }
                }
              },
              "description": "Selected variant options."
            },
            "preferences": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Buyer preferences."
            }
          },
          "description": "Product detail parameters."
        }
      }
    }
    arguments 146 lines
  • create_checkout unknown never probed

    Creates a checkout. Returns checkout details, including line items, totals, and any applicable discounts or taxes. Prices in the response are integers in the currency's ISO 4217 minor units, paired with a currency code: {"amount": 600, "currency": "USD"} is $6.00 and {"amount": 2500, "currency": "USD"} is $25.00. Convert to major units before quoting a price to a buyer (divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies such as JPY are already whole units).

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "meta",
        "checkout"
      ],
      "properties": {
        "meta": {
          "type": "object",
          "required": [
            "ucp-agent"
          ],
          "properties": {
            "ucp-agent": {
              "type": "object",
              "required": [
                "profile"
              ],
              "properties": {
                "profile": {
                  "type": "string",
                  "format": "uri",
                  "description": "Agent profile URI for UCP discovery."
                }
              }
            }
          },
          "description": "Metadata for UCP agent profile discovery."
        },
        "checkout": {
          "type": "object",
          "required": [
            "line_items"
          ],
          "properties": {
            "buyer": {
              "type": "object",
              "properties": {
                "email": {
                  "type": "string",
                  "format": "email"
                },
                "consent": {
                  "type": "object",
                  "description": "Per-purpose buyer consent decisions, keyed by reverse-DNS identifiers. Omission leaves existing choices unchanged.",
                  "additionalProperties": {
                    "type": "object",
                    "required": [
                      "granted",
                      "source"
                    ],
                    "properties": {
                      "source": {
                        "enum": [
                          "business",
                          "platform"
                        ],
                        "type": "string",
                        "description": "Use platform for an explicit buyer decision. Business-sourced values do not update stored choices."
                      },
                      "granted": {
                        "type": "boolean",
                        "description": "Whether consent is granted."
                      },
                      "segments": {
                        "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.",
                        "additionalProperties": {
                          "type": "object",
                          "required": [
                            "granted",
                            "source"
                          ],
                          "properties": {
                            "source": {
                              "enum": [
                                "business",
                                "platform"
                              ],
                              "type": "string",
                              "description": "Use platform for an explicit buyer decision. Business-sourced values do not update stored choices."
                            },
                            "granted": {
                              "type": "boolean",
                              "description": "Whether consent is granted."
                            }
                          },
                          "additionalProperties": true
                        }
                      }
                    },
                    "additionalProperties": true
                  }
                },
                "phone_number": {
                  "type": "string"
                }
              },
              "description": "Information about the buyer including email and phone number.",
              "additionalProperties": true
            },
            "cart_id": {
              "type": "string",
              "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'"
            },
            "context": {
              "type": "object",
              "properties": {
                "intent": {
                  "type": "string",
                  "description": "Context describing buyer's intent."
                },
                "currency": {
                  "type": "string",
                  "description": "Preferred currency (ISO 4217, e.g., 'EUR', 'USD')."
                },
                "language": {
                  "type": "string",
                  "description": "Language tag in IETF BCP 47 format."
                },
                "eligibility": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$",
                    "description": "Reverse-domain identifier. Must contain at least two dot-separated segments (e.g., 'com.example.loyalty')."
                  },
                  "description": "Buyer claims about eligible benefits such as loyalty membership, payment perks, and similar."
                },
                "postal_code": {
                  "type": "string",
                  "description": "Postal code hint for localization."
                },
                "address_region": {
                  "type": "string",
                  "description": "Region/state hint for localization."
                },
                "address_country": {
                  "type": "string",
                  "description": "Country hint for localization."
                }
              },
              "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.",
              "additionalProperties": true
            },
            "payment": {
              "type": "object",
              "properties": {
                "instruments": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "allOf": [
                      {
                        "if": {
                          "required": [
                            "handler_id"
                          ],
                          "properties": {
                            "handler_id": {
                              "const": "apple-pay"
                            }
                          }
                        },
                        "else": {
                          "properties": {
                            "credential": {
                              "required": [
                                "type"
                              ],
                              "properties": {
                                "type": {
                                  "not": {
                                    "const": "apple_pay_token"
                                  }
                                }
                              }
                            }
                          }
                        },
                        "then": {
                          "required": [
                            "billing_address",
                            "credential"
                          ],
                          "properties": {
                            "type": {
                              "const": "card"
                            },
                            "credential": {
                              "required": [
                                "type",
                                "payment_data"
                              ],
                              "properties": {
                                "type": {
                                  "const": "apple_pay_token"
                                }
                              }
                            }
                          }
                        }
                      }
                    ],
                    "required": [
                      "id",
                      "handler_id",
                      "type"
                    ],
                    "properties": {
                      "id": {
                        "type": "string",
                        "description": "A unique identifier for this payment instrument instance."
                      },
                      "type": {
                        "type": "string",
                        "description": "Instrument type. Apple Pay uses 'card' because the submitted instrument represents a tokenized card."
                      },
                      "display": {
                        "type": "object",
                        "properties": {
                          "brand": {
                            "type": "string",
                            "description": "Card brand (e.g., visa, mastercard), when available."
                          },
                          "expiry_year": {
                            "type": "integer",
                            "description": "Card expiry year. Required for card instruments."
                          },
                          "last_digits": {
                            "type": "string",
                            "description": "Last 4 digits of the card, when available."
                          },
                          "expiry_month": {
                            "type": "integer",
                            "description": "Card expiry month (1-12). Required for card instruments."
                          },
                          "rich_card_art": {
                            "type": "string",
                            "description": "Rich card art URL or identifier for the payment instrument."
                          },
                          "funding_source": {
                            "enum": [
                              "debit",
                              "credit",
                              "prepaid",
                              "store"
                            ],
                            "type": "string",
                            "description": "How the card is funded, as reported by Apple Pay."
                          },
                          "rich_text_description": {
                            "type": "string",
                            "description": "Rich text description of the payment instrument for display purposes."
                          }
                        },
                        "description": "Display information for this payment instrument.",
                        "additionalProperties": true
                      },
                      "selected": {
                        "type": "boolean",
                        "description": "Whether this instrument is the currently selected for the checkout."
                      },
                      "credential": {
                        "type": "object",
                        "allOf": [
                          {
                            "if": {
                              "required": [
                                "type"
                              ],
                              "properties": {
                                "type": {
                                  "const": "apple_pay_token"
                                }
                              }
                            },
                            "else": {
                              "required": [
                                "type"
                              ]
                            },
                            "then": {
                              "required": [
                                "type",
                                "payment_data"
                              ],
                              "properties": {
                                "type": {
                                  "const": "apple_pay_token"
                                },
                                "payment_data": {
                                  "type": "object",
                                  "required": [
                                    "version",
                                    "data",
                                    "signature",
                                    "header"
                                  ],
                                  "properties": {
                                    "data": {
                                      "type": "string"
                                    },
                                    "header": {
                                      "type": "object",
                                      "anyOf": [
                                        {
                                          "required": [
                                            "ephemeral_public_key"
                                          ]
                                        },
                                        {
                                          "required": [
                                            "wrapped_key"
                                          ]
                                        }
                                      ],
                                      "required": [
                                        "public_key_hash",
                                        "transaction_id"
                                      ],
                                      "properties": {
                                        "wrapped_key": {
                                          "type": "string"
                                        },
                                        "transaction_id": {
                                          "type": "string"
                                        },
                                        "public_key_hash": {
                                          "type": "string"
                                        },
                                        "application_data": {
                                          "type": "string"
                                        },
                                        "ephemeral_public_key": {
                                          "type": "string"
                                        }
                                      },
                                      "additionalProperties": true
                                    },
                                    "version": {
                                      "type": "string"
                                    },
                                    "signature": {
                                      "type": "string"
                                    }
                                  },
                                  "additionalProperties": true
                                },
                                "transaction_identifier": {
                                  "type": "string"
                                }
                              }
                            }
                          }
                        ],
                        "properties": {
                          "type": {
                            "type": "string",
                            "description": "Namespaced token type using dot notation (e.g., stripe.token, merchant.token, google.pay)."
                          },
                          "token": {
                            "type": "string",
                            "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."
                          },
                          "approval_id": {
                            "type": "string",
                            "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."
                          },
                          "payment_data": {
                            "type": "object"
                          },
                          "transaction_identifier": {
                            "type": "string"
                          }
                        },
                        "description": "Payment credential payload to process the transaction for this instrument.",
                        "additionalProperties": true
                      },
                      "handler_id": {
                        "type": "string",
                        "description": "Identifier of the payment handler that was used to generate this instrument."
                      },
                      "billing_address": {
                        "type": "object",
                        "properties": {
                          "last_name": {
                            "type": "string",
                            "description": "Last name of the contact associated with the billing address."
                          },
                          "first_name": {
                            "type": "string",
                            "description": "First name of the contact associated with the billing address."
                          },
                          "postal_code": {
                            "type": "string",
                            "description": "Postal code of the billing address."
                          },
                          "phone_number": {
                            "type": "string",
                            "description": "Phone number of the contact associated with the billing address."
                          },
                          "address_region": {
                            "type": "string",
                            "description": "Region of the billing address."
                          },
                          "street_address": {
                            "type": "string",
                            "description": "Street address of the billing address."
                          },
                          "address_country": {
                            "type": "string",
                            "description": "Country of the billing address in 2-letter ISO 3166-1 alpha-2 format."
                          },
                          "address_locality": {
                            "type": "string",
                            "description": "Locality of the billing address."
                          },
                          "extended_address": {
                            "type": "string",
                            "description": "Extended address of the billing address such as an apartment number, C/O, or alternative name."
                          }
                        },
                        "description": "Billing address for the instrument.",
                        "additionalProperties": true
                      }
                    },
                    "additionalProperties": true
                  },
                  "description": "Payment instruments for this checkout (e.g., credit cards, tokens, wallets)."
                }
              },
              "description": "Payment information for this checkout.",
              "additionalProperties": true
            },
            "discounts": {
              "type": "object",
              "properties": {
                "codes": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Discount codes to apply. Case-insensitive. Replaces previously submitted codes. Send empty array to clear."
                }
              },
              "description": "Discount or promo codes to apply to the cart. Only prompt if customer mentions having a discount code."
            },
            "line_items": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "item",
                  "quantity"
                ],
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "The ID of the line item to update."
                  },
                  "item": {
                    "type": "object",
                    "required": [
                      "id"
                    ],
                    "properties": {
                      "id": {
                        "type": "string",
                        "description": "The Product Variant ID to add or update."
                      }
                    }
                  },
                  "quantity": {
                    "type": "integer"
                  }
                }
              },
              "description": "Items to add to the cart or checkout. Required when creating a new cart or checkout."
            },
            "attribution": {
              "type": "object",
              "properties": {
                "utm_term": {
                  "type": "string",
                  "description": "UTM term parameter."
                },
                "utm_medium": {
                  "type": "string",
                  "description": "UTM medium parameter."
                },
                "utm_source": {
                  "type": "string",
                  "description": "UTM source parameter."
                },
                "utm_content": {
                  "type": "string",
                  "description": "UTM content parameter."
                },
                "click_id_tag": {
                  "type": "string",
                  "description": "Click identifier parameter name (e.g., 'gclid', 'fbclid')."
                },
                "utm_campaign": {
                  "type": "string",
                  "description": "UTM campaign parameter."
                },
                "click_id_value": {
                  "type": "string",
                  "description": "Click identifier value matching click_id_tag."
                },
                "activity_id_tag": {
                  "type": "string",
                  "description": "Activity identifier parameter name."
                },
                "referring_domain": {
                  "type": "string",
                  "description": "Domain that referred the buyer to the merchant's storefront."
                },
                "activity_id_value": {
                  "type": "string",
                  "description": "Activity identifier value matching activity_id_tag."
                }
              },
              "description": "Marketing attribution context for the buyer's session (referring domain, click IDs, UTM parameters)."
            },
            "fulfillment": {
              "type": "object",
              "properties": {
                "methods": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "required": [
                      "type"
                    ],
                    "properties": {
                      "type": {
                        "type": "string"
                      },
                      "groups": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string"
                            },
                            "selected_option_id": {
                              "type": "string"
                            }
                          }
                        },
                        "description": "The groups to fulfill to."
                      },
                      "destinations": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string"
                            },
                            "last_name": {
                              "type": "string"
                            },
                            "first_name": {
                              "type": "string"
                            },
                            "postal_code": {
                              "type": "string"
                            },
                            "phone_number": {
                              "type": "string"
                            },
                            "address_region": {
                              "type": "string"
                            },
                            "street_address": {
                              "type": "string"
                            },
                            "address_country": {
                              "type": "string"
                            },
                            "address_locality": {
                              "type": "string"
                            },
                            "extended_address": {
                              "type": "string"
                            }
                          }
                        },
                        "description": "The destinations to fulfill to."
                      },
                      "selected_destination_id": {
                        "type": "string",
                        "description": "ID of the selected destination."
                      }
                    }
                  },
                  "description": "The methods of fulfillment."
                }
              },
              "description": "Information about the fulfillment."
            },
            "declared_fields": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "key",
                  "value"
                ],
                "properties": {
                  "key": {
                    "type": "string",
                    "description": "Unique identifier for the declared field."
                  },
                  "value": {
                    "type": [
                      "string",
                      "number",
                      "boolean",
                      "object",
                      "array",
                      "null"
                    ],
                    "description": "Submitted JSON value for the field. Null clears the value."
                  }
                }
              },
              "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."
            }
          },
          "description": "Checkout properties."
        }
      }
    }
    arguments 639 lines
  • update_checkout unknown never probed

    Updates a checkout. Returns checkout details, including line items, totals, and any applicable discounts or taxes. Prices in the response are integers in the currency's ISO 4217 minor units, paired with a currency code: {"amount": 600, "currency": "USD"} is $6.00 and {"amount": 2500, "currency": "USD"} is $25.00. Convert to major units before quoting a price to a buyer (divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies such as JPY are already whole units).

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "meta",
        "checkout",
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The ID of the checkout to update. Format: 'gid://shopify/Checkout/abc123'"
        },
        "meta": {
          "type": "object",
          "required": [
            "ucp-agent"
          ],
          "properties": {
            "ucp-agent": {
              "type": "object",
              "required": [
                "profile"
              ],
              "properties": {
                "profile": {
                  "type": "string",
                  "format": "uri",
                  "description": "Agent profile URI for UCP discovery."
                }
              }
            }
          },
          "description": "Metadata for UCP agent profile discovery."
        },
        "checkout": {
          "type": "object",
          "required": [
            "line_items"
          ],
          "properties": {
            "buyer": {
              "type": "object",
              "properties": {
                "email": {
                  "type": "string",
                  "format": "email"
                },
                "consent": {
                  "type": "object",
                  "description": "Per-purpose buyer consent decisions, keyed by reverse-DNS identifiers. Omission leaves existing choices unchanged.",
                  "additionalProperties": {
                    "type": "object",
                    "required": [
                      "granted",
                      "source"
                    ],
                    "properties": {
                      "source": {
                        "enum": [
                          "business",
                          "platform"
                        ],
                        "type": "string",
                        "description": "Use platform for an explicit buyer decision. Business-sourced values do not update stored choices."
                      },
                      "granted": {
                        "type": "boolean",
                        "description": "Whether consent is granted."
                      },
                      "segments": {
                        "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.",
                        "additionalProperties": {
                          "type": "object",
                          "required": [
                            "granted",
                            "source"
                          ],
                          "properties": {
                            "source": {
                              "enum": [
                                "business",
                                "platform"
                              ],
                              "type": "string",
                              "description": "Use platform for an explicit buyer decision. Business-sourced values do not update stored choices."
                            },
                            "granted": {
                              "type": "boolean",
                              "description": "Whether consent is granted."
                            }
                          },
                          "additionalProperties": true
                        }
                      }
                    },
                    "additionalProperties": true
                  }
                },
                "phone_number": {
                  "type": "string"
                }
              },
              "description": "Information about the buyer including email and phone number.",
              "additionalProperties": true
            },
            "context": {
              "type": "object",
              "properties": {
                "intent": {
                  "type": "string",
                  "description": "Context describing buyer's intent."
                },
                "currency": {
                  "type": "string",
                  "description": "Preferred currency (ISO 4217, e.g., 'EUR', 'USD')."
                },
                "language": {
                  "type": "string",
                  "description": "Language tag in IETF BCP 47 format."
                },
                "eligibility": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$",
                    "description": "Reverse-domain identifier. Must contain at least two dot-separated segments (e.g., 'com.example.loyalty')."
                  },
                  "description": "Buyer claims about eligible benefits such as loyalty membership, payment perks, and similar."
                },
                "postal_code": {
                  "type": "string",
                  "description": "Postal code hint for localization."
                },
                "address_region": {
                  "type": "string",
                  "description": "Region/state hint for localization."
                },
                "address_country": {
                  "type": "string",
                  "description": "Country hint for localization."
                }
              },
              "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.",
              "additionalProperties": true
            },
            "payment": {
              "type": "object",
              "properties": {
                "instruments": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "allOf": [
                      {
                        "if": {
                          "required": [
                            "handler_id"
                          ],
                          "properties": {
                            "handler_id": {
                              "const": "apple-pay"
                            }
                          }
                        },
                        "else": {
                          "properties": {
                            "credential": {
                              "required": [
                                "type"
                              ],
                              "properties": {
                                "type": {
                                  "not": {
                                    "const": "apple_pay_token"
                                  }
                                }
                              }
                            }
                          }
                        },
                        "then": {
                          "required": [
                            "billing_address",
                            "credential"
                          ],
                          "properties": {
                            "type": {
                              "const": "card"
                            },
                            "credential": {
                              "required": [
                                "type",
                                "payment_data"
                              ],
                              "properties": {
                                "type": {
                                  "const": "apple_pay_token"
                                }
                              }
                            }
                          }
                        }
                      }
                    ],
                    "required": [
                      "id",
                      "handler_id",
                      "type"
                    ],
                    "properties": {
                      "id": {
                        "type": "string",
                        "description": "A unique identifier for this payment instrument instance."
                      },
                      "type": {
                        "type": "string",
                        "description": "Instrument type. Apple Pay uses 'card' because the submitted instrument represents a tokenized card."
                      },
                      "display": {
                        "type": "object",
                        "properties": {
                          "brand": {
                            "type": "string",
                            "description": "Card brand (e.g., visa, mastercard), when available."
                          },
                          "expiry_year": {
                            "type": "integer",
                            "description": "Card expiry year. Required for card instruments."
                          },
                          "last_digits": {
                            "type": "string",
                            "description": "Last 4 digits of the card, when available."
                          },
                          "expiry_month": {
                            "type": "integer",
                            "description": "Card expiry month (1-12). Required for card instruments."
                          },
                          "rich_card_art": {
                            "type": "string",
                            "description": "Rich card art URL or identifier for the payment instrument."
                          },
                          "funding_source": {
                            "enum": [
                              "debit",
                              "credit",
                              "prepaid",
                              "store"
                            ],
                            "type": "string",
                            "description": "How the card is funded, as reported by Apple Pay."
                          },
                          "rich_text_description": {
                            "type": "string",
                            "description": "Rich text description of the payment instrument for display purposes."
                          }
                        },
                        "description": "Display information for this payment instrument.",
                        "additionalProperties": true
                      },
                      "selected": {
                        "type": "boolean",
                        "description": "Whether this instrument is the currently selected for the checkout."
                      },
                      "credential": {
                        "type": "object",
                        "allOf": [
                          {
                            "if": {
                              "required": [
                                "type"
                              ],
                              "properties": {
                                "type": {
                                  "const": "apple_pay_token"
                                }
                              }
                            },
                            "else": {
                              "required": [
                                "type"
                              ]
                            },
                            "then": {
                              "required": [
                                "type",
                                "payment_data"
                              ],
                              "properties": {
                                "type": {
                                  "const": "apple_pay_token"
                                },
                                "payment_data": {
                                  "type": "object",
                                  "required": [
                                    "version",
                                    "data",
                                    "signature",
                                    "header"
                                  ],
                                  "properties": {
                                    "data": {
                                      "type": "string"
                                    },
                                    "header": {
                                      "type": "object",
                                      "anyOf": [
                                        {
                                          "required": [
                                            "ephemeral_public_key"
                                          ]
                                        },
                                        {
                                          "required": [
                                            "wrapped_key"
                                          ]
                                        }
                                      ],
                                      "required": [
                                        "public_key_hash",
                                        "transaction_id"
                                      ],
                                      "properties": {
                                        "wrapped_key": {
                                          "type": "string"
                                        },
                                        "transaction_id": {
                                          "type": "string"
                                        },
                                        "public_key_hash": {
                                          "type": "string"
                                        },
                                        "application_data": {
                                          "type": "string"
                                        },
                                        "ephemeral_public_key": {
                                          "type": "string"
                                        }
                                      },
                                      "additionalProperties": true
                                    },
                                    "version": {
                                      "type": "string"
                                    },
                                    "signature": {
                                      "type": "string"
                                    }
                                  },
                                  "additionalProperties": true
                                },
                                "transaction_identifier": {
                                  "type": "string"
                                }
                              }
                            }
                          }
                        ],
                        "properties": {
                          "type": {
                            "type": "string",
                            "description": "Namespaced token type using dot notation (e.g., stripe.token, merchant.token, google.pay)."
                          },
                          "token": {
                            "type": "string",
                            "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."
                          },
                          "approval_id": {
                            "type": "string",
                            "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."
                          },
                          "payment_data": {
                            "type": "object"
                          },
                          "transaction_identifier": {
                            "type": "string"
                          }
                        },
                        "description": "Payment credential payload to process the transaction for this instrument.",
                        "additionalProperties": true
                      },
                      "handler_id": {
                        "type": "string",
                        "description": "Identifier of the payment handler that was used to generate this instrument."
                      },
                      "billing_address": {
                        "type": "object",
                        "properties": {
                          "last_name": {
                            "type": "string",
                            "description": "Last name of the contact associated with the billing address."
                          },
                          "first_name": {
                            "type": "string",
                            "description": "First name of the contact associated with the billing address."
                          },
                          "postal_code": {
                            "type": "string",
                            "description": "Postal code of the billing address."
                          },
                          "phone_number": {
                            "type": "string",
                            "description": "Phone number of the contact associated with the billing address."
                          },
                          "address_region": {
                            "type": "string",
                            "description": "Region of the billing address."
                          },
                          "street_address": {
                            "type": "string",
                            "description": "Street address of the billing address."
                          },
                          "address_country": {
                            "type": "string",
                            "description": "Country of the billing address in 2-letter ISO 3166-1 alpha-2 format."
                          },
                          "address_locality": {
                            "type": "string",
                            "description": "Locality of the billing address."
                          },
                          "extended_address": {
                            "type": "string",
                            "description": "Extended address of the billing address such as an apartment number, C/O, or alternative name."
                          }
                        },
                        "description": "Billing address for the instrument.",
                        "additionalProperties": true
                      }
                    },
                    "additionalProperties": true
                  },
                  "description": "Payment instruments for this checkout (e.g., credit cards, tokens, wallets)."
                }
              },
              "description": "Payment information for this checkout.",
              "additionalProperties": true
            },
            "discounts": {
              "type": "object",
              "properties": {
                "codes": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Discount codes to apply. Case-insensitive. Replaces previously submitted codes. Send empty array to clear."
                }
              },
              "description": "Discount or promo codes to apply to the cart. Only prompt if customer mentions having a discount code."
            },
            "line_items": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "item",
                  "quantity"
                ],
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "The ID of the line item to update."
                  },
                  "item": {
                    "type": "object",
                    "required": [
                      "id"
                    ],
                    "properties": {
                      "id": {
                        "type": "string",
                        "description": "The Product Variant ID to add or update."
                      }
                    }
                  },
                  "quantity": {
                    "type": "integer"
                  }
                }
              },
              "description": "Items to add to the cart or checkout. Required when creating a new cart or checkout."
            },
            "attribution": {
              "type": "object",
              "properties": {
                "utm_term": {
                  "type": "string",
                  "description": "UTM term parameter."
                },
                "utm_medium": {
                  "type": "string",
                  "description": "UTM medium parameter."
                },
                "utm_source": {
                  "type": "string",
                  "description": "UTM source parameter."
                },
                "utm_content": {
                  "type": "string",
                  "description": "UTM content parameter."
                },
                "click_id_tag": {
                  "type": "string",
                  "description": "Click identifier parameter name (e.g., 'gclid', 'fbclid')."
                },
                "utm_campaign": {
                  "type": "string",
                  "description": "UTM campaign parameter."
                },
                "click_id_value": {
                  "type": "string",
                  "description": "Click identifier value matching click_id_tag."
                },
                "activity_id_tag": {
                  "type": "string",
                  "description": "Activity identifier parameter name."
                },
                "referring_domain": {
                  "type": "string",
                  "description": "Domain that referred the buyer to the merchant's storefront."
                },
                "activity_id_value": {
                  "type": "string",
                  "description": "Activity identifier value matching activity_id_tag."
                }
              },
              "description": "Marketing attribution context for the buyer's session (referring domain, click IDs, UTM parameters)."
            },
            "fulfillment": {
              "type": "object",
              "properties": {
                "methods": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "required": [
                      "line_item_ids"
                    ],
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "type": {
                        "type": "string"
                      },
                      "groups": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "required": [
                            "id"
                          ],
                          "properties": {
                            "id": {
                              "type": "string"
                            },
                            "selected_option_id": {
                              "type": "string"
                            }
                          }
                        },
                        "description": "The groups to fulfill to."
                      },
                      "destinations": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string"
                            },
                            "last_name": {
                              "type": "string"
                            },
                            "first_name": {
                              "type": "string"
                            },
                            "postal_code": {
                              "type": "string"
                            },
                            "phone_number": {
                              "type": "string"
                            },
                            "address_region": {
                              "type": "string"
                            },
                            "street_address": {
                              "type": "string"
                            },
                            "address_country": {
                              "type": "string"
                            },
                            "address_locality": {
                              "type": "string"
                            },
                            "extended_address": {
                              "type": "string"
                            }
                          }
                        },
                        "description": "The destinations to fulfill to."
                      },
                      "line_item_ids": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "description": "The line item ids to fulfill."
                      },
                      "selected_destination_id": {
                        "type": "string",
                        "description": "ID of the selected destination."
                      }
                    }
                  },
                  "description": "The methods of fulfillment."
                }
              },
              "description": "Information about the fulfillment."
            },
            "declared_fields": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "key",
                  "value"
                ],
                "properties": {
                  "key": {
                    "type": "string",
                    "description": "Unique identifier for the declared field."
                  },
                  "value": {
                    "type": [
                      "string",
                      "number",
                      "boolean",
                      "object",
                      "array",
                      "null"
                    ],
                    "description": "Submitted JSON value for the field. Null clears the value."
                  }
                }
              },
              "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."
            }
          },
          "description": "Checkout properties."
        }
      }
    }
    arguments 653 lines
  • complete_checkout unknown never probed

    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. Prices in the response are integers in the currency's ISO 4217 minor units, paired with a currency code: {"amount": 600, "currency": "USD"} is $6.00 and {"amount": 2500, "currency": "USD"} is $25.00. Convert to major units before quoting a price to a buyer (divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies such as JPY are already whole units).

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "meta",
        "id",
        "checkout"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The ID of the checkout to update. Format: 'gid://shopify/Checkout/abc123'"
        },
        "meta": {
          "type": "object",
          "required": [
            "ucp-agent",
            "idempotency-key"
          ],
          "properties": {
            "ucp-agent": {
              "type": "object",
              "required": [
                "profile"
              ],
              "properties": {
                "profile": {
                  "type": "string",
                  "format": "uri",
                  "description": "Agent profile URI for UCP discovery."
                }
              }
            },
            "idempotency-key": {
              "type": "string",
              "description": "An idempotency key for completing the checkout."
            }
          },
          "description": "Metadata for UCP agent profile discovery."
        },
        "checkout": {
          "type": "object",
          "required": [
            "payment"
          ],
          "properties": {
            "buyer": {
              "type": "object",
              "properties": {
                "consent": {
                  "type": "object",
                  "description": "Per-purpose buyer consent decisions, keyed by reverse-DNS identifiers. Omission leaves existing choices unchanged.",
                  "additionalProperties": {
                    "type": "object",
                    "required": [
                      "granted",
                      "source"
                    ],
                    "properties": {
                      "source": {
                        "enum": [
                          "business",
                          "platform"
                        ],
                        "type": "string",
                        "description": "Use platform for an explicit buyer decision. Business-sourced values do not update stored choices."
                      },
                      "granted": {
                        "type": "boolean",
                        "description": "Whether consent is granted."
                      },
                      "segments": {
                        "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.",
                        "additionalProperties": {
                          "type": "object",
                          "required": [
                            "granted",
                            "source"
                          ],
                          "properties": {
                            "source": {
                              "enum": [
                                "business",
                                "platform"
                              ],
                              "type": "string",
                              "description": "Use platform for an explicit buyer decision. Business-sourced values do not update stored choices."
                            },
                            "granted": {
                              "type": "boolean",
                              "description": "Whether consent is granted."
                            }
                          },
                          "additionalProperties": true
                        }
                      }
                    },
                    "additionalProperties": true
                  }
                }
              },
              "additionalProperties": true
            },
            "payment": {
              "type": "object",
              "properties": {
                "instruments": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "allOf": [
                      {
                        "if": {
                          "required": [
                            "handler_id"
                          ],
                          "properties": {
                            "handler_id": {
                              "const": "apple-pay"
                            }
                          }
                        },
                        "else": {
                          "properties": {
                            "credential": {
                              "required": [
                                "type"
                              ],
                              "properties": {
                                "type": {
                                  "not": {
                                    "const": "apple_pay_token"
                                  }
                                }
                              }
                            }
                          }
                        },
                        "then": {
                          "required": [
                            "billing_address",
                            "credential"
                          ],
                          "properties": {
                            "type": {
                              "const": "card"
                            },
                            "credential": {
                              "required": [
                                "type",
                                "payment_data"
                              ],
                              "properties": {
                                "type": {
                                  "const": "apple_pay_token"
                                }
                              }
                            }
                          }
                        }
                      }
                    ],
                    "required": [
                      "id",
                      "handler_id",
                      "type"
                    ],
                    "properties": {
                      "id": {
                        "type": "string",
                        "description": "A unique identifier for this payment instrument instance."
                      },
                      "type": {
                        "type": "string",
                        "description": "Instrument type. Apple Pay uses 'card' because the submitted instrument represents a tokenized card."
                      },
                      "display": {
                        "type": "object",
                        "properties": {
                          "brand": {
                            "type": "string",
                            "description": "Card brand (e.g., visa, mastercard), when available."
                          },
                          "expiry_year": {
                            "type": "integer",
                            "description": "Card expiry year. Required for card instruments."
                          },
                          "last_digits": {
                            "type": "string",
                            "description": "Last 4 digits of the card, when available."
                          },
                          "expiry_month": {
                            "type": "integer",
                            "description": "Card expiry month (1-12). Required for card instruments."
                          },
                          "rich_card_art": {
                            "type": "string",
                            "description": "Rich card art URL or identifier for the payment instrument."
                          },
                          "funding_source": {
                            "enum": [
                              "debit",
                              "credit",
                              "prepaid",
                              "store"
                            ],
                            "type": "string",
                            "description": "How the card is funded, as reported by Apple Pay."
                          },
                          "rich_text_description": {
                            "type": "string",
                            "description": "Rich text description of the payment instrument for display purposes."
                          }
                        },
                        "description": "Display information for this payment instrument.",
                        "additionalProperties": true
                      },
                      "selected": {
                        "type": "boolean",
                        "description": "Whether this instrument is the currently selected for the checkout."
                      },
                      "credential": {
                        "type": "object",
                        "allOf": [
                          {
                            "if": {
                              "required": [
                                "type"
                              ],
                              "properties": {
                                "type": {
                                  "const": "apple_pay_token"
                                }
                              }
                            },
                            "else": {
                              "required": [
                                "type"
                              ]
                            },
                            "then": {
                              "required": [
                                "type",
                                "payment_data"
                              ],
                              "properties": {
                                "type": {
                                  "const": "apple_pay_token"
                                },
                                "payment_data": {
                                  "type": "object",
                                  "required": [
                                    "version",
                                    "data",
                                    "signature",
                                    "header"
                                  ],
                                  "properties": {
                                    "data": {
                                      "type": "string"
                                    },
                                    "header": {
                                      "type": "object",
                                      "anyOf": [
                                        {
                                          "required": [
                                            "ephemeral_public_key"
                                          ]
                                        },
                                        {
                                          "required": [
                                            "wrapped_key"
                                          ]
                                        }
                                      ],
                                      "required": [
                                        "public_key_hash",
                                        "transaction_id"
                                      ],
                                      "properties": {
                                        "wrapped_key": {
                                          "type": "string"
                                        },
                                        "transaction_id": {
                                          "type": "string"
                                        },
                                        "public_key_hash": {
                                          "type": "string"
                                        },
                                        "application_data": {
                                          "type": "string"
                                        },
                                        "ephemeral_public_key": {
                                          "type": "string"
                                        }
                                      },
                                      "additionalProperties": true
                                    },
                                    "version": {
                                      "type": "string"
                                    },
                                    "signature": {
                                      "type": "string"
                                    }
                                  },
                                  "additionalProperties": true
                                },
                                "transaction_identifier": {
                                  "type": "string"
                                }
                              }
                            }
                          }
                        ],
                        "properties": {
                          "type": {
                            "type": "string",
                            "description": "Namespaced token type using dot notation (e.g., stripe.token, merchant.token, google.pay)."
                          },
                          "token": {
                            "type": "string",
                            "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."
                          },
                          "approval_id": {
                            "type": "string",
                            "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."
                          },
                          "payment_data": {
                            "type": "object"
                          },
                          "transaction_identifier": {
                            "type": "string"
                          }
                        },
                        "description": "Payment credential payload to process the transaction for this instrument.",
                        "additionalProperties": true
                      },
                      "handler_id": {
                        "type": "string",
                        "description": "Identifier of the payment handler that was used to generate this instrument."
                      },
                      "billing_address": {
                        "type": "object",
                        "properties": {
                          "last_name": {
                            "type": "string",
                            "description": "Last name of the contact associated with the billing address."
                          },
                          "first_name": {
                            "type": "string",
                            "description": "First name of the contact associated with the billing address."
                          },
                          "postal_code": {
                            "type": "string",
                            "description": "Postal code of the billing address."
                          },
                          "phone_number": {
                            "type": "string",
                            "description": "Phone number of the contact associated with the billing address."
                          },
                          "address_region": {
                            "type": "string",
                            "description": "Region of the billing address."
                          },
                          "street_address": {
                            "type": "string",
                            "description": "Street address of the billing address."
                          },
                          "address_country": {
                            "type": "string",
                            "description": "Country of the billing address in 2-letter ISO 3166-1 alpha-2 format."
                          },
                          "address_locality": {
                            "type": "string",
                            "description": "Locality of the billing address."
                          },
                          "extended_address": {
                            "type": "string",
                            "description": "Extended address of the billing address such as an apartment number, C/O, or alternative name."
                          }
                        },
                        "description": "Billing address for the instrument.",
                        "additionalProperties": true
                      }
                    },
                    "additionalProperties": true
                  },
                  "description": "Payment instruments for this checkout (e.g., credit cards, tokens, wallets)."
                }
              },
              "description": "Payment information for this checkout.",
              "additionalProperties": true
            },
            "attribution": {
              "type": "object",
              "properties": {
                "utm_term": {
                  "type": "string",
                  "description": "UTM term parameter."
                },
                "utm_medium": {
                  "type": "string",
                  "description": "UTM medium parameter."
                },
                "utm_source": {
                  "type": "string",
                  "description": "UTM source parameter."
                },
                "utm_content": {
                  "type": "string",
                  "description": "UTM content parameter."
                },
                "click_id_tag": {
                  "type": "string",
                  "description": "Click identifier parameter name (e.g., 'gclid', 'fbclid')."
                },
                "utm_campaign": {
                  "type": "string",
                  "description": "UTM campaign parameter."
                },
                "click_id_value": {
                  "type": "string",
                  "description": "Click identifier value matching click_id_tag."
                },
                "activity_id_tag": {
                  "type": "string",
                  "description": "Activity identifier parameter name."
                },
                "referring_domain": {
                  "type": "string",
                  "description": "Domain that referred the buyer to the merchant's storefront."
                },
                "activity_id_value": {
                  "type": "string",
                  "description": "Activity identifier value matching activity_id_tag."
                }
              },
              "description": "Marketing attribution context for the buyer's session (referring domain, click IDs, UTM parameters)."
            }
          },
          "description": "Checkout properties."
        }
      }
    }
    arguments 445 lines
  • cancel_checkout unknown never probed

    Cancels a checkout. Prices in the response are integers in the currency's ISO 4217 minor units, paired with a currency code: {"amount": 600, "currency": "USD"} is $6.00 and {"amount": 2500, "currency": "USD"} is $25.00. Convert to major units before quoting a price to a buyer (divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies such as JPY are already whole units).

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "meta",
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The ID of the checkout to update. Format: 'gid://shopify/Checkout/abc123'"
        },
        "meta": {
          "type": "object",
          "required": [
            "ucp-agent"
          ],
          "properties": {
            "ucp-agent": {
              "type": "object",
              "required": [
                "profile"
              ],
              "properties": {
                "profile": {
                  "type": "string",
                  "format": "uri",
                  "description": "Agent profile URI for UCP discovery."
                }
              }
            }
          },
          "description": "Metadata for UCP agent profile discovery."
        }
      }
    }
    arguments 36 lines
  • get_cart unknown 39h ago

    Get the cart contents Prices in the response are integers in the currency's ISO 4217 minor units, paired with a currency code: {"amount": 600, "currency": "USD"} is $6.00 and {"amount": 2500, "currency": "USD"} is $25.00. Convert to major units before quoting a price to a buyer (divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies such as JPY are already whole units).

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "meta",
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The ID of the cart. Format: 'gid://shopify/Cart/abc123'"
        },
        "meta": {
          "type": "object",
          "required": [
            "ucp-agent"
          ],
          "properties": {
            "ucp-agent": {
              "type": "object",
              "required": [
                "profile"
              ],
              "properties": {
                "profile": {
                  "type": "string",
                  "format": "uri",
                  "description": "Agent profile URI for UCP discovery."
                }
              }
            }
          },
          "description": "Metadata for UCP agent profile discovery."
        }
      }
    }
    arguments 36 lines
  • create_cart unknown never probed

    Creates a new cart Prices in the response are integers in the currency's ISO 4217 minor units, paired with a currency code: {"amount": 600, "currency": "USD"} is $6.00 and {"amount": 2500, "currency": "USD"} is $25.00. Convert to major units before quoting a price to a buyer (divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies such as JPY are already whole units).

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "meta",
        "cart"
      ],
      "properties": {
        "cart": {
          "type": "object",
          "required": [
            "line_items"
          ],
          "properties": {
            "buyer": {
              "type": "object",
              "properties": {
                "email": {
                  "type": "string",
                  "format": "email"
                },
                "consent": {
                  "type": "object",
                  "description": "Per-purpose buyer consent decisions, keyed by reverse-DNS identifiers. Omission leaves existing choices unchanged.",
                  "additionalProperties": {
                    "type": "object",
                    "required": [
                      "granted",
                      "source"
                    ],
                    "properties": {
                      "source": {
                        "enum": [
                          "business",
                          "platform"
                        ],
                        "type": "string",
                        "description": "Use platform for an explicit buyer decision. Business-sourced values do not update stored choices."
                      },
                      "granted": {
                        "type": "boolean",
                        "description": "Whether consent is granted."
                      },
                      "segments": {
                        "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.",
                        "additionalProperties": {
                          "type": "object",
                          "required": [
                            "granted",
                            "source"
                          ],
                          "properties": {
                            "source": {
                              "enum": [
                                "business",
                                "platform"
                              ],
                              "type": "string",
                              "description": "Use platform for an explicit buyer decision. Business-sourced values do not update stored choices."
                            },
                            "granted": {
                              "type": "boolean",
                              "description": "Whether consent is granted."
                            }
                          },
                          "additionalProperties": true
                        }
                      }
                    },
                    "additionalProperties": true
                  }
                },
                "phone_number": {
                  "type": "string"
                }
              },
              "description": "Information about the buyer including email and phone number.",
              "additionalProperties": true
            },
            "context": {
              "type": "object",
              "properties": {
                "intent": {
                  "type": "string",
                  "description": "Context describing buyer's intent."
                },
                "currency": {
                  "type": "string",
                  "description": "Preferred currency (ISO 4217, e.g., 'EUR', 'USD')."
                },
                "language": {
                  "type": "string",
                  "description": "Language tag in IETF BCP 47 format."
                },
                "eligibility": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$",
                    "description": "Reverse-domain identifier. Must contain at least two dot-separated segments (e.g., 'com.example.loyalty')."
                  },
                  "description": "Buyer claims about eligible benefits such as loyalty membership, payment perks, and similar."
                },
                "postal_code": {
                  "type": "string",
                  "description": "Postal code hint for localization."
                },
                "address_region": {
                  "type": "string",
                  "description": "Region/state hint for localization."
                },
                "address_country": {
                  "type": "string",
                  "description": "Country hint for localization."
                }
              },
              "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.",
              "additionalProperties": true
            },
            "discounts": {
              "type": "object",
              "properties": {
                "codes": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Discount codes to apply. Case-insensitive. Replaces previously submitted codes. Send empty array to clear."
                }
              },
              "description": "Discount or promo codes to apply to the cart. Only prompt if customer mentions having a discount code."
            },
            "line_items": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "item",
                  "quantity"
                ],
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "The ID of the line item to update."
                  },
                  "item": {
                    "type": "object",
                    "required": [
                      "id"
                    ],
                    "properties": {
                      "id": {
                        "type": "string",
                        "description": "The Product Variant ID to add or update."
                      }
                    }
                  },
                  "quantity": {
                    "type": "integer"
                  }
                }
              },
              "description": "Items to add to the cart or checkout. Required when creating a new cart or checkout."
            },
            "attribution": {
              "type": "object",
              "properties": {
                "utm_term": {
                  "type": "string",
                  "description": "UTM term parameter."
                },
                "utm_medium": {
                  "type": "string",
                  "description": "UTM medium parameter."
                },
                "utm_source": {
                  "type": "string",
                  "description": "UTM source parameter."
                },
                "utm_content": {
                  "type": "string",
                  "description": "UTM content parameter."
                },
                "click_id_tag": {
                  "type": "string",
                  "description": "Click identifier parameter name (e.g., 'gclid', 'fbclid')."
                },
                "utm_campaign": {
                  "type": "string",
                  "description": "UTM campaign parameter."
                },
                "click_id_value": {
                  "type": "string",
                  "description": "Click identifier value matching click_id_tag."
                },
                "activity_id_tag": {
                  "type": "string",
                  "description": "Activity identifier parameter name."
                },
                "referring_domain": {
                  "type": "string",
                  "description": "Domain that referred the buyer to the merchant's storefront."
                },
                "activity_id_value": {
                  "type": "string",
                  "description": "Activity identifier value matching activity_id_tag."
                }
              },
              "description": "Marketing attribution context for the buyer's session (referring domain, click IDs, UTM parameters). Forwarded to the cart for downstream reporting."
            },
            "fulfillment": {
              "type": "object",
              "properties": {
                "methods": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "required": [
                      "type"
                    ],
                    "properties": {
                      "type": {
                        "type": "string"
                      },
                      "groups": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string"
                            },
                            "selected_option_id": {
                              "type": "string"
                            }
                          }
                        },
                        "description": "The groups to fulfill to."
                      },
                      "destinations": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string"
                            },
                            "last_name": {
                              "type": "string"
                            },
                            "first_name": {
                              "type": "string"
                            },
                            "postal_code": {
                              "type": "string"
                            },
                            "phone_number": {
                              "type": "string"
                            },
                            "address_region": {
                              "type": "string"
                            },
                            "street_address": {
                              "type": "string"
                            },
                            "address_country": {
                              "type": "string"
                            },
                            "address_locality": {
                              "type": "string"
                            },
                            "extended_address": {
                              "type": "string"
                            }
                          }
                        },
                        "description": "The destinations to fulfill to."
                      },
                      "selected_destination_id": {
                        "type": "string",
                        "description": "ID of the selected destination."
                      }
                    }
                  },
                  "description": "The methods of fulfillment."
                }
              },
              "description": "Information about the fulfillment."
            },
            "declared_fields": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "key",
                  "value"
                ],
                "properties": {
                  "key": {
                    "type": "string",
                    "description": "Unique identifier for the declared field."
                  },
                  "value": {
                    "type": [
                      "string",
                      "number",
                      "boolean",
                      "object",
                      "array",
                      "null"
                    ],
                    "description": "Submitted JSON value for the field. Null clears the value."
                  }
                }
              },
              "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."
            }
          },
          "description": "Cart properties."
        },
        "meta": {
          "type": "object",
          "required": [
            "ucp-agent"
          ],
          "properties": {
            "ucp-agent": {
              "type": "object",
              "required": [
                "profile"
              ],
              "properties": {
                "profile": {
                  "type": "string",
                  "format": "uri",
                  "description": "Agent profile URI for UCP discovery."
                }
              }
            }
          },
          "description": "Metadata for UCP agent profile discovery."
        }
      }
    }
    arguments 345 lines
  • update_cart unknown never probed

    Perform updates to a cart. Prices in the response are integers in the currency's ISO 4217 minor units, paired with a currency code: {"amount": 600, "currency": "USD"} is $6.00 and {"amount": 2500, "currency": "USD"} is $25.00. Convert to major units before quoting a price to a buyer (divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies such as JPY are already whole units).

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "meta",
        "cart",
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The ID of the cart. Format: 'gid://shopify/Cart/abc123'"
        },
        "cart": {
          "type": "object",
          "required": [
            "line_items"
          ],
          "properties": {
            "buyer": {
              "type": "object",
              "properties": {
                "email": {
                  "type": "string",
                  "format": "email"
                },
                "consent": {
                  "type": "object",
                  "description": "Per-purpose buyer consent decisions, keyed by reverse-DNS identifiers. Omission leaves existing choices unchanged.",
                  "additionalProperties": {
                    "type": "object",
                    "required": [
                      "granted",
                      "source"
                    ],
                    "properties": {
                      "source": {
                        "enum": [
                          "business",
                          "platform"
                        ],
                        "type": "string",
                        "description": "Use platform for an explicit buyer decision. Business-sourced values do not update stored choices."
                      },
                      "granted": {
                        "type": "boolean",
                        "description": "Whether consent is granted."
                      },
                      "segments": {
                        "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.",
                        "additionalProperties": {
                          "type": "object",
                          "required": [
                            "granted",
                            "source"
                          ],
                          "properties": {
                            "source": {
                              "enum": [
                                "business",
                                "platform"
                              ],
                              "type": "string",
                              "description": "Use platform for an explicit buyer decision. Business-sourced values do not update stored choices."
                            },
                            "granted": {
                              "type": "boolean",
                              "description": "Whether consent is granted."
                            }
                          },
                          "additionalProperties": true
                        }
                      }
                    },
                    "additionalProperties": true
                  }
                },
                "phone_number": {
                  "type": "string"
                }
              },
              "description": "Information about the buyer including email and phone number.",
              "additionalProperties": true
            },
            "context": {
              "type": "object",
              "properties": {
                "intent": {
                  "type": "string",
                  "description": "Context describing buyer's intent."
                },
                "currency": {
                  "type": "string",
                  "description": "Preferred currency (ISO 4217, e.g., 'EUR', 'USD')."
                },
                "language": {
                  "type": "string",
                  "description": "Language tag in IETF BCP 47 format."
                },
                "eligibility": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$",
                    "description": "Reverse-domain identifier. Must contain at least two dot-separated segments (e.g., 'com.example.loyalty')."
                  },
                  "description": "Buyer claims about eligible benefits such as loyalty membership, payment perks, and similar."
                },
                "postal_code": {
                  "type": "string",
                  "description": "Postal code hint for localization."
                },
                "address_region": {
                  "type": "string",
                  "description": "Region/state hint for localization."
                },
                "address_country": {
                  "type": "string",
                  "description": "Country hint for localization."
                }
              },
              "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.",
              "additionalProperties": true
            },
            "discounts": {
              "type": "object",
              "properties": {
                "codes": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Discount codes to apply. Case-insensitive. Replaces previously submitted codes. Send empty array to clear."
                }
              },
              "description": "Discount or promo codes to apply to the cart. Only prompt if customer mentions having a discount code."
            },
            "line_items": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "item",
                  "quantity"
                ],
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "The ID of the line item to update."
                  },
                  "item": {
                    "type": "object",
                    "required": [
                      "id"
                    ],
                    "properties": {
                      "id": {
                        "type": "string",
                        "description": "The Product Variant ID to add or update."
                      }
                    }
                  },
                  "quantity": {
                    "type": "integer"
                  }
                }
              },
              "description": "Items to add to the cart or checkout. Required when creating a new cart or checkout."
            },
            "attribution": {
              "type": "object",
              "properties": {
                "utm_term": {
                  "type": "string",
                  "description": "UTM term parameter."
                },
                "utm_medium": {
                  "type": "string",
                  "description": "UTM medium parameter."
                },
                "utm_source": {
                  "type": "string",
                  "description": "UTM source parameter."
                },
                "utm_content": {
                  "type": "string",
                  "description": "UTM content parameter."
                },
                "click_id_tag": {
                  "type": "string",
                  "description": "Click identifier parameter name (e.g., 'gclid', 'fbclid')."
                },
                "utm_campaign": {
                  "type": "string",
                  "description": "UTM campaign parameter."
                },
                "click_id_value": {
                  "type": "string",
                  "description": "Click identifier value matching click_id_tag."
                },
                "activity_id_tag": {
                  "type": "string",
                  "description": "Activity identifier parameter name."
                },
                "referring_domain": {
                  "type": "string",
                  "description": "Domain that referred the buyer to the merchant's storefront."
                },
                "activity_id_value": {
                  "type": "string",
                  "description": "Activity identifier value matching activity_id_tag."
                }
              },
              "description": "Marketing attribution context for the buyer's session (referring domain, click IDs, UTM parameters). Forwarded to the cart for downstream reporting."
            },
            "fulfillment": {
              "type": "object",
              "properties": {
                "methods": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "required": [
                      "line_item_ids"
                    ],
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "type": {
                        "type": "string"
                      },
                      "groups": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "required": [
                            "id"
                          ],
                          "properties": {
                            "id": {
                              "type": "string"
                            },
                            "selected_option_id": {
                              "type": "string"
                            }
                          }
                        },
                        "description": "The groups to fulfill to."
                      },
                      "destinations": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string"
                            },
                            "last_name": {
                              "type": "string"
                            },
                            "first_name": {
                              "type": "string"
                            },
                            "postal_code": {
                              "type": "string"
                            },
                            "phone_number": {
                              "type": "string"
                            },
                            "address_region": {
                              "type": "string"
                            },
                            "street_address": {
                              "type": "string"
                            },
                            "address_country": {
                              "type": "string"
                            },
                            "address_locality": {
                              "type": "string"
                            },
                            "extended_address": {
                              "type": "string"
                            }
                          }
                        },
                        "description": "The destinations to fulfill to."
                      },
                      "line_item_ids": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "description": "The line item ids to fulfill."
                      },
                      "selected_destination_id": {
                        "type": "string",
                        "description": "ID of the selected destination."
                      }
                    }
                  },
                  "description": "The methods of fulfillment."
                }
              },
              "description": "Information about the fulfillment."
            },
            "declared_fields": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "key",
                  "value"
                ],
                "properties": {
                  "key": {
                    "type": "string",
                    "description": "Unique identifier for the declared field."
                  },
                  "value": {
                    "type": [
                      "string",
                      "number",
                      "boolean",
                      "object",
                      "array",
                      "null"
                    ],
                    "description": "Submitted JSON value for the field. Null clears the value."
                  }
                }
              },
              "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."
            }
          },
          "description": "Cart properties."
        },
        "meta": {
          "type": "object",
          "required": [
            "ucp-agent"
          ],
          "properties": {
            "ucp-agent": {
              "type": "object",
              "required": [
                "profile"
              ],
              "properties": {
                "profile": {
                  "type": "string",
                  "format": "uri",
                  "description": "Agent profile URI for UCP discovery."
                }
              }
            }
          },
          "description": "Metadata for UCP agent profile discovery."
        }
      }
    }
    arguments 363 lines
  • cancel_cart unknown never probed

    Cancels a cart. Prices in the response are integers in the currency's ISO 4217 minor units, paired with a currency code: {"amount": 600, "currency": "USD"} is $6.00 and {"amount": 2500, "currency": "USD"} is $25.00. Convert to major units before quoting a price to a buyer (divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies such as JPY are already whole units).

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "meta",
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The ID of the cart. Format: 'gid://shopify/Cart/abc123'"
        },
        "meta": {
          "type": "object",
          "required": [
            "ucp-agent"
          ],
          "properties": {
            "ucp-agent": {
              "type": "object",
              "required": [
                "profile"
              ],
              "properties": {
                "profile": {
                  "type": "string",
                  "format": "uri",
                  "description": "Agent profile URI for UCP discovery."
                }
              }
            }
          },
          "description": "Metadata for UCP agent profile discovery."
        }
      }
    }
    arguments 36 lines
  • get_order unknown never probed

    Get the details of an order Prices in the response are integers in the currency's ISO 4217 minor units, paired with a currency code: {"amount": 600, "currency": "USD"} is $6.00 and {"amount": 2500, "currency": "USD"} is $25.00. Convert to major units before quoting a price to a buyer (divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies such as JPY are already whole units).

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "meta",
        "id"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "The ID of the order. Format: 'gid://shopify/Order/123'"
        },
        "meta": {
          "type": "object",
          "required": [
            "ucp-agent"
          ],
          "properties": {
            "ucp-agent": {
              "type": "object",
              "required": [
                "profile"
              ],
              "properties": {
                "profile": {
                  "type": "string",
                  "format": "uri",
                  "description": "Agent profile URI for UCP discovery."
                }
              }
            }
          },
          "description": "Metadata for UCP agent profile discovery."
        }
      }
    }
    arguments 36 lines
  • ask_business unknown never probed

    Ask a question about this store, such as what it sells, its policies, or its services.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "meta",
        "ask"
      ],
      "properties": {
        "ask": {
          "type": "object",
          "required": [
            "query"
          ],
          "properties": {
            "ids": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Resource identifiers for grounding. Up to 10 of this store's Shopify Product, ProductVariant, Collection or Cart GIDs are supported. A cart or collection grounds the answer in its products."
            },
            "query": {
              "type": "string",
              "maxLength": 10000,
              "description": "Natural-language question."
            },
            "context": {
              "type": "object",
              "properties": {
                "intent": {
                  "type": "string"
                },
                "currency": {
                  "type": "string"
                },
                "language": {
                  "type": "string"
                },
                "postal_code": {
                  "type": "string"
                },
                "address_region": {
                  "type": "string"
                },
                "address_country": {
                  "type": "string"
                }
              },
              "description": "Buyer context for localization and personalization.",
              "additionalProperties": true
            },
            "signals": {
              "type": "object",
              "description": "Platform environment data. Signals are not currently supported.",
              "additionalProperties": true
            },
            "attribution": {
              "type": "object",
              "description": "Platform attribution data. Attribution is not currently supported.",
              "additionalProperties": true
            },
            "conversation": {
              "type": "object",
              "required": [
                "id"
              ],
              "properties": {
                "id": {
                  "type": "string"
                },
                "expires_at": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "description": "Opaque conversation identifier. Multi-turn conversations are not currently supported."
            }
          }
        },
        "meta": {
          "type": "object",
          "required": [
            "ucp-agent"
          ],
          "properties": {
            "ucp-agent": {
              "type": "object",
              "required": [
                "profile"
              ],
              "properties": {
                "profile": {
                  "type": "string",
                  "format": "uri",
                  "description": "Agent profile URI for UCP discovery."
                }
              }
            }
          },
          "description": "Metadata for UCP agent profile discovery."
        }
      }
    }
    arguments 103 lines
  • search_catalog unknown 12h ago

    Search for products from the online store, hosted on Shopify. This tool can be used to search for products using natural language queries, specific filter criteria, or both. At least one of query or filters must be provided. Results are paginated, with initial results limited to improve experience. Use the pagination.cursor from the response to fetch additional pages when users request more results. Response conforms to the UCP catalog search capability (dev.ucp.shopping.catalog.search). Prices in the response are integers in the currency's ISO 4217 minor units, paired with a currency code: {"amount": 600, "currency": "USD"} is $6.00 and {"amount": 2500, "currency": "USD"} is $25.00. Convert to major units before quoting a price to a buyer (divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies such as JPY are already whole units).

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "meta",
        "catalog"
      ],
      "properties": {
        "meta": {
          "type": "object",
          "required": [
            "ucp-agent"
          ],
          "properties": {
            "ucp-agent": {
              "type": "object",
              "required": [
                "profile"
              ],
              "properties": {
                "profile": {
                  "type": "string",
                  "format": "uri",
                  "description": "Agent profile URI for UCP discovery."
                }
              }
            }
          },
          "description": "Metadata for UCP agent profile discovery."
        },
        "catalog": {
          "type": "object",
          "properties": {
            "query": {
              "type": "string",
              "description": "Search query string."
            },
            "context": {
              "type": "object",
              "properties": {
                "intent": {
                  "type": "string",
                  "description": "Buyer intent."
                },
                "currency": {
                  "type": "string",
                  "description": "Currency code in ISO 4217 format."
                },
                "language": {
                  "type": "string",
                  "description": "Language tag in IETF BCP 47 format."
                },
                "postal_code": {
                  "type": "string",
                  "description": "Postal code."
                },
                "address_region": {
                  "type": "string",
                  "description": "Region or state."
                },
                "address_country": {
                  "type": "string",
                  "description": "Country code in ISO 3166-1 alpha-2 format."
                }
              },
              "description": "Buyer signals for localization and personalization.",
              "additionalProperties": true
            },
            "filters": {
              "type": "object",
              "properties": {
                "price": {
                  "type": "object",
                  "properties": {
                    "max": {
                      "type": "integer",
                      "description": "Maximum price in minor currency units."
                    },
                    "min": {
                      "type": "integer",
                      "description": "Minimum price in minor currency units."
                    }
                  },
                  "description": "Price range filter."
                },
                "available": {
                  "type": "boolean",
                  "default": true,
                  "description": "Filter by availability. Default true (only sale-ready items)."
                },
                "categories": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Category filters combined with OR logic."
                }
              },
              "description": "Narrowing criteria for catalog results.",
              "additionalProperties": true
            },
            "signals": {
              "type": "object",
              "properties": {
                "dev.ucp.buyer_ip": {
                  "type": "string",
                  "description": "Buyer IP address."
                },
                "dev.ucp.user_agent": {
                  "type": "string",
                  "description": "Buyer user agent."
                }
              },
              "description": "Platform environment data.",
              "additionalProperties": true
            },
            "pagination": {
              "type": "object",
              "properties": {
                "limit": {
                  "type": "integer",
                  "default": 10,
                  "minimum": 1,
                  "description": "Number of results to return."
                },
                "cursor": {
                  "type": "string",
                  "description": "Pagination cursor."
                }
              },
              "description": "Pagination parameters."
            }
          },
          "description": "Catalog search parameters."
        }
      }
    }
    arguments 137 lines
  • lookup_catalog unknown 12h ago

    Look up multiple products or variants by identifier. Use this tool to resolve multiple product/variant IDs in a single request. Supports: - Product IDs (gid://shopify/Product/...): Returns product with match: "featured" - Variant IDs (gid://shopify/ProductVariant/...): Returns parent product with the exact variant Results are grouped by product. Each variant includes an inputs array showing which request ID resolved to it and whether the match was exact or featured. In versions that require input correlations, only matched variants are returned. Prices in the response are integers in the currency's ISO 4217 minor units, paired with a currency code: {"amount": 600, "currency": "USD"} is $6.00 and {"amount": 2500, "currency": "USD"} is $25.00. Convert to major units before quoting a price to a buyer (divide by 100 for two-decimal currencies such as USD and EUR; zero-decimal currencies such as JPY are already whole units). Maximum 10 IDs per request.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "meta",
        "catalog"
      ],
      "properties": {
        "meta": {
          "type": "object",
          "required": [
            "ucp-agent"
          ],
          "properties": {
            "ucp-agent": {
              "type": "object",
              "required": [
                "profile"
              ],
              "properties": {
                "profile": {
                  "type": "string",
                  "format": "uri",
                  "description": "Agent profile URI for UCP discovery."
                }
              }
            }
          },
          "description": "Metadata for UCP agent profile discovery."
        },
        "catalog": {
          "type": "object",
          "required": [
            "ids"
          ],
          "properties": {
            "ids": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "maxItems": 10,
              "minItems": 1,
              "description": "Product IDs to look up."
            },
            "context": {
              "type": "object",
              "properties": {
                "intent": {
                  "type": "string",
                  "description": "Buyer intent."
                },
                "currency": {
                  "type": "string",
                  "description": "Currency code in ISO 4217 format."
                },
                "language": {
                  "type": "string",
                  "description": "Language tag in IETF BCP 47 format."
                },
                "postal_code": {
                  "type": "string",
                  "description": "Postal code."
                },
                "address_region": {
                  "type": "string",
                  "description": "Region or state."
                },
                "address_country": {
                  "type": "string",
                  "description": "Country code in ISO 3166-1 alpha-2 format."
                }
              },
              "description": "Buyer signals for localization and personalization.",
              "additionalProperties": true
            },
            "filters": {
              "type": "object",
              "properties": {
                "price": {
                  "type": "object",
                  "properties": {
                    "max": {
                      "type": "integer",
                      "description": "Maximum price in minor currency units."
                    },
                    "min": {
                      "type": "integer",
                      "description": "Minimum price in minor currency units."
                    }
                  },
                  "description": "Price range filter."
                },
                "available": {
                  "type": "boolean",
                  "default": true,
                  "description": "Filter by availability. Default true (only sale-ready items)."
                },
                "categories": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Category filters combined with OR logic."
                }
              },
              "description": "Narrowing criteria for catalog results.",
              "additionalProperties": true
            },
            "signals": {
              "type": "object",
              "properties": {
                "dev.ucp.buyer_ip": {
                  "type": "string",
                  "description": "Buyer IP address."
                },
                "dev.ucp.user_agent": {
                  "type": "string",
                  "description": "Buyer user agent."
                }
              },
              "description": "Platform environment data.",
              "additionalProperties": true
            }
          },
          "description": "Catalog lookup parameters."
        }
      }
    }
    arguments 129 lines
  • search_locations unknown never probed

    Search this business's physical store locations. An empty `location` object lists the stores. Narrow the list with a basic text `query` (every word must appear in the store name or address), and/or a `distance` relation: an explicit `center` latitude/longitude and an inclusive `max` radius in meters. With `distance`, results are ordered nearest first (ties by location ID); otherwise they are in location ID order. Results are paginated; pass `pagination.cursor` from the response to fetch the next page. `filters.items` accepts up to ten unique nonempty Business-scoped item references, combined independently with AND before pagination, not basket quantities. Overflow returns `invalid_input`, never truncation. Exact visible variants only; unresolved or nonvariant items match nothing. Availability uses Shopify's existing coarse policy and flag-dependent candidates, not shelf-stock, pickup or reservation guarantees. Explicit `context.address_country` and `context.language` inform Catalog item resolution, never a distance center. Other context and signals remain ignored hints. Hours, amenities, custom filters and any `serves` return `invalid_input` rather than being ignored. Response uses the UCP location search shape (dev.ucp.common.location.search).

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "meta",
        "location"
      ],
      "properties": {
        "meta": {
          "type": "object",
          "required": [
            "ucp-agent"
          ],
          "properties": {
            "ucp-agent": {
              "type": "object",
              "required": [
                "profile"
              ],
              "properties": {
                "profile": {
                  "type": "string",
                  "format": "uri",
                  "description": "Agent profile URI for UCP discovery."
                }
              }
            }
          },
          "description": "Metadata for UCP agent profile discovery."
        },
        "location": {
          "type": "object",
          "properties": {
            "query": {
              "type": "string",
              "description": "Basic free-text match. Every whitespace-separated word must appear, case-insensitively, in the store name, street, city, region or postal code. Words match literally (no geocoding or abbreviations), so use full region names."
            },
            "serves": {
              "type": "object",
              "description": "Serviceability targets are not supported by this business. Any value is rejected with invalid_input; use `distance` with an explicit center for proximity.",
              "additionalProperties": true
            },
            "context": {
              "type": "object",
              "properties": {
                "intent": {
                  "type": "string"
                },
                "currency": {
                  "type": "string"
                },
                "language": {
                  "type": "string"
                },
                "location": {
                  "type": "string"
                },
                "postal_code": {
                  "type": "string"
                },
                "address_region": {
                  "type": "string"
                },
                "address_country": {
                  "type": "string"
                }
              },
              "description": "Buyer context. Explicit address_country and language inform Catalog item resolution when items are filtered. Recognized country codes and names are normalized to alpha-2; language uses its uppercase primary tag (en-CA becomes EN). Unsupported evaluated country or language values return invalid_input. Valid values may use Catalog's shop fallback. Blank and other hints are ignored. Without items, context is ignored. Context never supplies a distance center and is not echoed.",
              "additionalProperties": true
            },
            "filters": {
              "type": "object",
              "properties": {
                "items": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1
                  },
                  "minItems": 1,
                  "description": "Business-scoped item identifiers combined independently with AND, not basket quantities. At most ten raw references; overflow returns invalid_input, never truncation. Exact visible variants only; unknown or nonvariant items match nothing. Stock uses Shopify's coarse store availability and existing flag-dependent candidates, not shelf-stock, pickup or reservation guarantees.",
                  "uniqueItems": true
                }
              },
              "description": "An empty object is accepted. Only items are supported; hours, amenities and custom filters are rejected with invalid_input instead of being ignored.",
              "additionalProperties": true
            },
            "signals": {
              "type": "object",
              "properties": {
                "dev.ucp.buyer_ip": {
                  "type": "string"
                },
                "dev.ucp.user_agent": {
                  "type": "string"
                }
              },
              "description": "Platform-observed environment signals. Accepted as hints only: never used to derive a location and not echoed.",
              "propertyNames": {
                "type": "string",
                "pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$"
              },
              "additionalProperties": true
            },
            "distance": {
              "type": "object",
              "required": [
                "center",
                "max"
              ],
              "properties": {
                "max": {
                  "type": "number",
                  "minimum": 0,
                  "description": "Inclusive maximum distance in meters."
                },
                "center": {
                  "type": "object",
                  "required": [
                    "latitude",
                    "longitude"
                  ],
                  "properties": {
                    "latitude": {
                      "type": "number",
                      "maximum": 90,
                      "minimum": -90
                    },
                    "longitude": {
                      "type": "number",
                      "maximum": 180,
                      "minimum": -180
                    }
                  },
                  "description": "WGS 84 coordinates in decimal degrees."
                }
              },
              "description": "Explicit-center radius using Shopify's spherical Haversine distance calculation. Matches locations whose distance from `center` is at most `max` meters. The center is never inferred from context, signals or the caller's IP, and the radius is never clamped. Locations without usable coordinates do not match."
            },
            "pagination": {
              "type": "object",
              "properties": {
                "limit": {
                  "type": "integer",
                  "minimum": 1,
                  "description": "Requested page size. The business may return fewer locations."
                },
                "cursor": {
                  "type": "string",
                  "description": "Opaque cursor from a previous response."
                }
              }
            }
          },
          "description": "Location search request. May be empty."
        }
      }
    }
    arguments 158 lines
  • lookup_locations unknown 12h ago

    Look up this business's physical store locations by identifier. Pass the canonical `id` values returned by search_locations in `ids`. Duplicate identifiers are resolved once; each returned location lists the identifiers that resolved to it in `inputs`. Unknown identifiers are omitted from the result. Above the business's batch limit only the first identifiers are processed and the response carries a `batch_limit_applied` message. An optional `distance` relation (explicit `center` and inclusive `max` meters) refines the resolved locations. `filters.items` accepts up to ten unique nonempty Business-scoped references, combined independently with AND, not basket quantities. This budget is separate from the first-ten- distinct-Location limit; item overflow returns `invalid_input`, never truncation. Exact visible variants only; unresolved or nonvariant items match nothing. Availability uses Shopify's coarse policy and existing flag-dependent candidates, not shelf-stock, pickup or reservation guarantees. Explicit `context.address_country` and `context.language` inform Catalog item resolution, never a distance center. Other context and signals remain ignored hints. Hours, amenities, custom filters and any `serves` return `invalid_input` rather than being ignored. Response uses the UCP location lookup shape (dev.ucp.common.location.lookup).

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "meta",
        "location"
      ],
      "properties": {
        "meta": {
          "type": "object",
          "required": [
            "ucp-agent"
          ],
          "properties": {
            "ucp-agent": {
              "type": "object",
              "required": [
                "profile"
              ],
              "properties": {
                "profile": {
                  "type": "string",
                  "format": "uri",
                  "description": "Agent profile URI for UCP discovery."
                }
              }
            }
          },
          "description": "Metadata for UCP agent profile discovery."
        },
        "location": {
          "type": "object",
          "required": [
            "ids"
          ],
          "properties": {
            "ids": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "minItems": 1,
              "description": "Location identifiers to look up."
            },
            "serves": {
              "type": "object",
              "description": "Serviceability targets are not supported by this business. Any value is rejected with invalid_input; use `distance` with an explicit center for proximity.",
              "additionalProperties": true
            },
            "context": {
              "type": "object",
              "properties": {
                "intent": {
                  "type": "string"
                },
                "currency": {
                  "type": "string"
                },
                "language": {
                  "type": "string"
                },
                "location": {
                  "type": "string"
                },
                "postal_code": {
                  "type": "string"
                },
                "address_region": {
                  "type": "string"
                },
                "address_country": {
                  "type": "string"
                }
              },
              "description": "Buyer context. Explicit address_country and language inform Catalog item resolution when items are filtered. Recognized country codes and names are normalized to alpha-2; language uses its uppercase primary tag (en-CA becomes EN). Unsupported evaluated country or language values return invalid_input. Valid values may use Catalog's shop fallback. Blank and other hints are ignored. Without items, context is ignored. Context never supplies a distance center and is not echoed.",
              "additionalProperties": true
            },
            "filters": {
              "type": "object",
              "properties": {
                "items": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1
                  },
                  "minItems": 1,
                  "description": "Business-scoped item identifiers combined independently with AND, not basket quantities. At most ten raw references; overflow returns invalid_input, never truncation. Exact visible variants only; unknown or nonvariant items match nothing. Stock uses Shopify's coarse store availability and existing flag-dependent candidates, not shelf-stock, pickup or reservation guarantees.",
                  "uniqueItems": true
                }
              },
              "description": "An empty object is accepted. Only items are supported; hours, amenities and custom filters are rejected with invalid_input instead of being ignored.",
              "additionalProperties": true
            },
            "signals": {
              "type": "object",
              "properties": {
                "dev.ucp.buyer_ip": {
                  "type": "string"
                },
                "dev.ucp.user_agent": {
                  "type": "string"
                }
              },
              "description": "Platform-observed environment signals. Accepted as hints only: never used to derive a location and not echoed.",
              "propertyNames": {
                "type": "string",
                "pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$"
              },
              "additionalProperties": true
            },
            "distance": {
              "type": "object",
              "required": [
                "center",
                "max"
              ],
              "properties": {
                "max": {
                  "type": "number",
                  "minimum": 0,
                  "description": "Inclusive maximum distance in meters."
                },
                "center": {
                  "type": "object",
                  "required": [
                    "latitude",
                    "longitude"
                  ],
                  "properties": {
                    "latitude": {
                      "type": "number",
                      "maximum": 90,
                      "minimum": -90
                    },
                    "longitude": {
                      "type": "number",
                      "maximum": 180,
                      "minimum": -180
                    }
                  },
                  "description": "WGS 84 coordinates in decimal degrees."
                }
              },
              "description": "Explicit-center radius using Shopify's spherical Haversine distance calculation. Matches locations whose distance from `center` is at most `max` meters. The center is never inferred from context, signals or the caller's IP, and the radius is never clamped. Locations without usable coordinates do not match."
            }
          },
          "description": "Location lookup request."
        }
      }
    }
    arguments 151 lines
_ try it through the hub, ceiling 0

This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.

_ is this your agent? claim it: badge, payouts, history

Nobody has claimed this listing. Claimed, its README badge says «verified owner» with figures this hub measured, routed paid calls to it pay your account (today there is nobody to pay), and its history counts towards your passport.

  1. Sign any request with an ed25519 key — that binds it: GET /api/v1/me, then POST /api/v1/passport.
  2. Prove it is yours. Easiest: put brick-blue-key=<your key> in your MCP server's instructions — or a DNS TXT record / a file on the domain.
  3. Ask the hub to check: POST /api/v1/passport/claim-endpoint with this listing's id 06e502d3b01c16e6.

Every step, filled in for this listing: https://brick.blue/api/v1/agents/06e502d3b01c16e6/claim. Over MCP: the claim_endpoint tool.

_ for your README measured, not declared

measured by brick.blue

[![measured by brick.blue](https://brick.blue/api/v1/agents/06e502d3b01c16e6/badge.svg)](https://brick.blue/agent/06e502d3b01c16e6?ref=badge)

The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Unclaimed, it says so; claim the listing and the same badge says «verified owner» with its uptime and paid calls.

_ how we know
card completeness
100%

An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.

spec deviations
0

MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.

_ record

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

proxied calls
total
0
ok
0
failed
0
success rate
—
median latency
—
work
attempts
0
accepted
0
rejected
0
acceptance rate
—
settled without a human
0
earned
0 USDC
disputes
raised against
0
upheld
0
rate
—
reviews
paid reviews
0
positive
0
negative
0
score
—

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.