{
  "live": {
    "slug": "shop-mcp",
    "probe": {
      "target": "https://mcp.shop.com/",
      "method": "mcp-initialize",
      "lastAt": "2026-10-18T00:25:39.603731133Z",
      "lastOk": true,
      "lastStatus": 200,
      "lastMs": 167,
      "lastNote": "answered, but not with an initialize result",
      "authRequired": false,
      "uptime24h": 100,
      "uptime30d": 100,
      "p50ms24h": 146,
      "p95ms24h": 216,
      "samples24h": 26,
      "samples30d": 26,
      "days": [
        {
          "date": "2026-10-17",
          "probes": 21,
          "ok": 21
        },
        {
          "date": "2026-10-18",
          "probes": 5,
          "ok": 5
        }
      ]
    },
    "pages": [
      {
        "url": "https://shopify.dev/changelog",
        "kind": "changelog",
        "status": 200,
        "checkedAt": "2026-10-17T23:09:58.147311051Z",
        "changedAt": "2026-10-17T23:09:58.147311051Z",
        "fingerprint": "c91a4fcc1230"
      },
      {
        "url": "https://www.shopify.com/legal/privacy/consumers",
        "kind": "privacy",
        "status": 200,
        "checkedAt": "2026-10-17T23:20:19.881279119Z",
        "changedAt": "0001-01-01T00:00:00Z",
        "fingerprint": "53c8cca74cf9"
      },
      {
        "url": "https://www.shopify.com/legal/api-terms",
        "kind": "terms",
        "status": 200,
        "checkedAt": "2026-10-17T23:20:15.799218659Z",
        "changedAt": "0001-01-01T00:00:00Z",
        "fingerprint": "14ed8b03cca8"
      }
    ],
    "mcpTools": {
      "url": "https://mcp.shop.com/",
      "checkedAt": "2026-10-17T22:40:31.040770591Z",
      "status": "ok",
      "protocol": "2026-07-28",
      "tools": [
        {
          "name": "create_checkout",
          "description": "Prepare Shop/UCP checkout only when asked. No separate spend request is needed. Use exact variant IDs/quantities. Share continue_url unchanged for Review and pay, including requires_escalation. Never recreate: get/update its ID. Address incomplete via update. Complete ready_for_complete only after buyer approval. Creates no order.",
          "inputSchema": {
            "$defs": {
              "d0": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "additionalProperties": true,
                "name": "dev.ucp.shopping.checkout",
                "properties": {
                  "buyer": {
                    "additionalProperties": true,
                    "properties": {
                      "email": {
                        "type": "string"
                      },
                      "first_name": {
                        "type": "string"
                      },
                      "last_name": {
                        "type": "string"
                      },
                      "phone_number": {
                        "description": "Buyer phone in E.164.",
                        "type": "string"
                      }
                    },
                    "title": "Buyer",
                    "type": "object"
                  },
                  "context": {
                    "additionalProperties": true,
                    "allOf": [
                      {
                        "additionalProperties": true,
                        "description": "Coarse locality; not an address.",
                        "properties": {
                          "address_country": {
                            "description": "ISO 3166-1 alpha-2, e.g. US.",
                            "type": "string"
                          },
                          "address_region": {
                            "type": "string"
                          },
                          "postal_code": {
                            "type": "string"
                          }
                        },
                        "title": "Locality",
                        "type": "object"
                      },
                      {
                        "additionalProperties": true,
                        "properties": {
                          "currency": {
                            "description": "ISO 4217 preference/filter currency; verify output.",
                            "type": "string"
                          },
                          "eligibility": {
                            "description": "Nonidentifying reverse-domain benefits; ignore unknowns.",
                            "items": {
                              "$ref": "#/$defs/d10"
                            },
                            "type": "array",
                            "uniqueItems": true
                          },
                          "intent": {
                            "description": "Relevance hint, e.g. 'gift under $50'.",
                            "type": "string"
                          },
                          "language": {
                            "description": "BCP 47 preference, e.g. fr-CA.",
                            "type": "string"
                          },
                          "location": {
                            "description": "Opaque merchant location ID, not locality.",
                            "type": "string"
                          },
                          "payment": {
                            "description": "Advertised handlers, most preferred first; ignore unknowns.",
                            "items": {
                              "properties": {
                                "handler": {
                                  "allOf": [
                                    {
                                      "$ref": "#/$defs/d10"
                                    }
                                  ],
                                  "description": "Merchant ucp.payment_handlers key."
                                },
                                "types": {
                                  "description": "Instrument types, most preferred first; ignore unknowns.",
                                  "items": {
                                    "type": "string"
                                  },
                                  "type": "array"
                                }
                              },
                              "required": [
                                "handler"
                              ],
                              "type": "object"
                            },
                            "type": "array"
                          }
                        },
                        "type": "object"
                      }
                    ],
                    "description": "Soft relevance/localization; checkout wins.",
                    "title": "Context",
                    "type": "object"
                  },
                  "line_items": {
                    "description": "On update send every line; omissions delete, never merge.",
                    "items": {
                      "description": "Uses parent cart/checkout currency.",
                      "properties": {
                        "item": {
                          "properties": {
                            "id": {
                              "description": "Copy exact returned variant ID; never rebuild/truncate.",
                              "type": "string"
                            },
                            "quantity_unit": {
                              "allOf": [
                                {
                                  "allOf": [
                                    {
                                      "if": {
                                        "properties": {
                                          "unit": {
                                            "const": "C62"
                                          }
                                        },
                                        "required": [
                                          "unit"
                                        ]
                                      },
                                      "properties": {
                                        "display_text": {
                                          "description": "Printable label for unrecognized units.",
                                          "type": "string"
                                        },
                                        "scale": {
                                          "default": 0,
                                          "description": "One step = 10^-scale units; omitted=0; C62 needs 0.",
                                          "maximum": 15,
                                          "minimum": 0,
                                          "type": "integer"
                                        },
                                        "unit": {
                                          "description": "UN/CEFACT Rec 20 code, else stable opaque custom ID.",
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "unit",
                                        "display_text"
                                      ],
                                      "then": {
                                        "properties": {
                                          "scale": {
                                            "const": 0
                                          }
                                        }
                                      },
                                      "title": "Unit",
                                      "type": "object"
                                    },
                                    {
                                      "properties": {
                                        "increment": {
                                          "default": 1,
                                          "description": "Step multiple (default 1); merchant may revise/reject, never reinterpret.",
                                          "minimum": 1,
                                          "type": "integer"
                                        }
                                      },
                                      "type": "object"
                                    }
                                  ],
                                  "description": "Sale basis is unit+scale, not display_text/increment.",
                                  "title": "Quantity Unit"
                                }
                              ],
                              "description": "Omit for merchant basis; else assert unit/scale. C62/0 = each."
                            }
                          },
                          "required": [
                            "id"
                          ],
                          "title": "Item",
                          "type": "object"
                        },
                        "quantity": {
                          "description": "Integer sale-basis steps; missing quantity_unit is not each.",
                          "maximum": 9007199254740991,
                          "minimum": 1,
                          "type": "integer"
                        }
                      },
                      "required": [
                        "item",
                        "quantity"
                      ],
                      "title": "Line Item",
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "payment": {
                    "$schema": "https://json-schema.org/draft/2020-12/schema",
                    "description": "Only after shopper selects an instrument.",
                    "properties": {
                      "instruments": {
                        "items": {
                          "allOf": [
                            {
                              "$schema": "https://json-schema.org/draft/2020-12/schema",
                              "additionalProperties": true,
                              "properties": {
                                "billing_address": {
                                  "properties": {
                                    "address_country": {
                                      "$ref": "#/$defs/d1"
                                    },
                                    "address_locality": {
                                      "$ref": "#/$defs/d2"
                                    },
                                    "address_region": {
                                      "$ref": "#/$defs/d3"
                                    },
                                    "extended_address": {
                                      "$ref": "#/$defs/d4"
                                    },
                                    "first_name": {
                                      "$ref": "#/$defs/d5"
                                    },
                                    "last_name": {
                                      "$ref": "#/$defs/d6"
                                    },
                                    "phone_number": {
                                      "$ref": "#/$defs/d7"
                                    },
                                    "postal_code": {
                                      "$ref": "#/$defs/d8"
                                    },
                                    "street_address": {
                                      "$ref": "#/$defs/d9"
                                    }
                                  },
                                  "title": "Postal Address",
                                  "type": "object"
                                },
                                "credential": {
                                  "additionalProperties": true,
                                  "description": "Shape defined by the handler.",
                                  "properties": {
                                    "type": {
                                      "description": "Type the handler requires.",
                                      "type": "string"
                                    }
                                  },
                                  "required": [
                                    "type"
                                  ],
                                  "title": "Payment Credential",
                                  "type": "object"
                                },
                                "display": {
                                  "type": "object"
                                },
                                "handler_id": {
                                  "description": "Merchant-advertised handler ID.",
                                  "type": "string"
                                },
                                "id": {
                                  "description": "Opaque; never reuse across merchants.",
                                  "type": "string"
                                },
                                "type": {
                                  "description": "Handler category, e.g. card.",
                                  "type": "string"
                                }
                              },
                              "required": [
                                "id",
                                "handler_id",
                                "type"
                              ],
                              "title": "Payment Instrument",
                              "type": "object"
                            },
                            {
                              "properties": {
                                "selected": {
                                  "description": "True only on the one shopper-approved instrument.",
                                  "type": "boolean"
                                }
                              },
                              "type": "object"
                            }
                          ],
                          "title": "Selected Payment Instrument"
                        },
                        "type": "array"
                      }
                    },
                    "title": "Payment",
                    "type": "object"
                  },
                  "signals": {
                    "additionalProperties": true,
                    "description": "Observed/verified platform facts; no buyer claims.",
                    "properties": {
                      "dev.ucp.buyer_ip": {
                        "type": "string"
                      },
                      "dev.ucp.user_agent": {
                        "type": "string"
                      }
                    },
                    "propertyNames": {
                      "allOf": [
                        {
                          "$ref": "#/$defs/d10"
                        }
                      ]
                    },
                    "title": "Signals",
                    "type": "object"
                  }
                },
                "required": [
                  "line_items"
                ],
                "title": "Checkout",
                "type": "object",
                "version": "2026-08-25"
              },
              "d1": {
                "description": "ISO 3166-1 alpha-2, e.g. US.",
                "type": "string"
              },
              "d10": {
                "description": "Reverse domain, 2+ segments.",
                "examples": [
                  "dev.ucp.shopping.checkout",
                  "dev.ucp.common.identity_linking",
                  "com.example.loyalty_gold",
                  "com.example-shop.checkout",
                  "com.2example.cart",
                  "uk.co.example-shop.checkout",
                  "xn--p1ai.example.checkout"
                ],
                "pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$",
                "title": "Reverse Domain Name",
                "type": "string"
              },
              "d2": {
                "type": "string"
              },
              "d3": {
                "type": "string"
              },
              "d4": {
                "type": "string"
              },
              "d5": {
                "type": "string"
              },
              "d6": {
                "type": "string"
              },
              "d7": {
                "type": "string"
              },
              "d8": {
                "type": "string"
              },
              "d9": {
                "type": "string"
              }
            },
            "additionalProperties": false,
            "properties": {
              "checkout": {
                "allOf": [
                  {
                    "allOf": [
                      {
                        "$ref": "#/$defs/d0"
                      },
                      {
                        "properties": {
                          "discounts": {
                            "properties": {
                              "codes": {
                                "description": "Replace case-insensitively; [] clears all.",
                                "items": {
                                  "type": "string"
                                },
                                "type": "array"
                              }
                            },
                            "type": "object"
                          }
                        },
                        "type": "object"
                      }
                    ],
                    "title": "Checkout with Discount"
                  },
                  {
                    "allOf": [
                      {
                        "$ref": "#/$defs/d0"
                      },
                      {
                        "properties": {
                          "fulfillment": {
                            "allOf": [
                              {
                                "properties": {
                                  "methods": {
                                    "description": "Methods covering the checkout's line items.",
                                    "items": {
                                      "allOf": [
                                        {
                                          "if": {
                                            "properties": {
                                              "type": {
                                                "const": "shipping"
                                              }
                                            },
                                            "required": [
                                              "type"
                                            ]
                                          },
                                          "then": {
                                            "properties": {
                                              "destinations": {
                                                "description": "Platform-authored shipping addresses.",
                                                "items": {
                                                  "allOf": [
                                                    {
                                                      "properties": {
                                                        "address_country": {
                                                          "$ref": "#/$defs/d1"
                                                        },
                                                        "address_locality": {
                                                          "$ref": "#/$defs/d2"
                                                        },
                                                        "address_region": {
                                                          "$ref": "#/$defs/d3"
                                                        },
                                                        "extended_address": {
                                                          "$ref": "#/$defs/d4"
                                                        },
                                                        "first_name": {
                                                          "$ref": "#/$defs/d5"
                                                        },
                                                        "last_name": {
                                                          "$ref": "#/$defs/d6"
                                                        },
                                                        "phone_number": {
                                                          "$ref": "#/$defs/d7"
                                                        },
                                                        "postal_code": {
                                                          "$ref": "#/$defs/d8"
                                                        },
                                                        "street_address": {
                                                          "$ref": "#/$defs/d9"
                                                        }
                                                      },
                                                      "title": "Postal Address",
                                                      "type": "object"
                                                    },
                                                    {
                                                      "properties": {
                                                        "id": {
                                                          "description": "Platform-assigned ID for this address.",
                                                          "type": "string"
                                                        },
                                                        "type": {
                                                          "const": "shipping_address",
                                                          "type": "string"
                                                        }
                                                      },
                                                      "required": [],
                                                      "type": "object"
                                                    }
                                                  ],
                                                  "title": "Shipping Destination",
                                                  "type": "object"
                                                },
                                                "type": "array"
                                              }
                                            }
                                          }
                                        },
                                        {
                                          "if": {
                                            "properties": {
                                              "type": {
                                                "const": "pickup"
                                              }
                                            },
                                            "required": [
                                              "type"
                                            ]
                                          },
                                          "then": {
                                            "properties": {}
                                          }
                                        }
                                      ],
                                      "dependentRequired": {
                                        "destinations": [
                                          "type"
                                        ]
                                      },
                                      "properties": {
                                        "groups": {
                                          "description": "Merchant groups; select returned options.",
                                          "items": {
                                            "additionalProperties": true,
                                            "properties": {
                                              "selected_option_id": {
                                                "description": "Option ID returned for this group.",
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              }
                                            },
                                            "required": [],
                                            "title": "Fulfillment Group",
                                            "type": "object"
                                          },
                                          "type": "array"
                                        },
                                        "selected_destination_id": {
                                          "description": "Merchant-scoped; need not be returned.",
                                          "type": [
                                            "string",
                                            "null"
                                          ]
                                        },
                                        "type": {
                                          "description": "Shipping, pickup, or another supported type.",
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "type"
                                      ],
                                      "title": "Fulfillment Method",
                                      "type": "object"
                                    },
                                    "type": "array"
                                  }
                                },
                                "title": "Fulfillment",
                                "type": "object"
                              }
                            ]
                          }
                        },
                        "type": "object"
                      }
                    ],
                    "title": "Checkout with Fulfillment"
                  },
                  {
                    "not": {
                      "required": [
                        "attribution"
                      ]
                    }
                  }
                ],
                "type": "object"
              },
              "meta": {
                "additionalProperties": false,
                "properties": {
                  "idempotency-key": {
                    "description": "UUID for one write; reuse for exact retries. complete_checkout derives if omitted.",
                    "format": "uuid",
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "shop": {
                "description": "Exact seller.domain storefront hostname from offer; no scheme/path; one seller per cart/checkout.",
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "checkout",
              "shop"
            ],
            "type": "object"
          },
          "annotations": {
            "destructiveHint": true,
            "idempotentHint": false,
            "openWorldHint": true,
            "readOnlyHint": false
          }
        },
        {
          "name": "get_checkout",
          "description": "Read with the same shop/exact opaque ID before update/completion or after an uncertain write. continue_url is Review and pay, not a product page/purchase proof.",
          "inputSchema": {
            "additionalProperties": false,
            "properties": {
              "id": {
                "type": "string"
              },
              "shop": {
                "description": "Exact seller.domain storefront hostname from offer; no scheme/path; one seller per cart/checkout.",
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "id",
              "shop"
            ],
            "type": "object"
          },
          "annotations": {
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true,
            "readOnlyHint": true
          }
        },
        {
          "name": "update_checkout",
          "description": "Replace full checkout, not patch/payment. Read first; change only authorized fields; retain all other request fields, including empty objects/arrays. Response-only fields drop. Same shop/exact ID; check status/messages/continue_url. After uncertainty, read before retry.",
          "inputSchema": {
            "$defs": {
              "d0": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "additionalProperties": true,
                "name": "dev.ucp.shopping.checkout",
                "properties": {
                  "buyer": {
                    "additionalProperties": true,
                    "properties": {
                      "email": {
                        "type": "string"
                      },
                      "first_name": {
                        "type": "string"
                      },
                      "last_name": {
                        "type": "string"
                      },
                      "phone_number": {
                        "description": "Buyer phone in E.164.",
                        "type": "string"
                      }
                    },
                    "title": "Buyer",
                    "type": "object"
                  },
                  "context": {
                    "additionalProperties": true,
                    "allOf": [
                      {
                        "additionalProperties": true,
                        "description": "Coarse locality; not an address.",
                        "properties": {
                          "address_country": {
                            "description": "ISO 3166-1 alpha-2, e.g. US.",
                            "type": "string"
                          },
                          "address_region": {
                            "type": "string"
                          },
                          "postal_code": {
                            "type": "string"
                          }
                        },
                        "title": "Locality",
                        "type": "object"
                      },
                      {
                        "additionalProperties": true,
                        "properties": {
                          "currency": {
                            "description": "ISO 4217 preference/filter currency; verify output.",
                            "type": "string"
                          },
                          "eligibility": {
                            "description": "Nonidentifying reverse-domain benefits; ignore unknowns.",
                            "items": {
                              "$ref": "#/$defs/d10"
                            },
                            "type": "array",
                            "uniqueItems": true
                          },
                          "intent": {
                            "description": "Relevance hint, e.g. 'gift under $50'.",
                            "type": "string"
                          },
                          "language": {
                            "description": "BCP 47 preference, e.g. fr-CA.",
                            "type": "string"
                          },
                          "location": {
                            "description": "Opaque merchant location ID, not locality.",
                            "type": "string"
                          },
                          "payment": {
                            "description": "Advertised handlers, most preferred first; ignore unknowns.",
                            "items": {
                              "properties": {
                                "handler": {
                                  "allOf": [
                                    {
                                      "$ref": "#/$defs/d10"
                                    }
                                  ],
                                  "description": "Merchant ucp.payment_handlers key."
                                },
                                "types": {
                                  "description": "Instrument types, most preferred first; ignore unknowns.",
                                  "items": {
                                    "type": "string"
                                  },
                                  "type": "array"
                                }
                              },
                              "required": [
                                "handler"
                              ],
                              "type": "object"
                            },
                            "type": "array"
                          }
                        },
                        "type": "object"
                      }
                    ],
                    "description": "Soft relevance/localization; checkout wins.",
                    "title": "Context",
                    "type": "object"
                  },
                  "line_items": {
                    "description": "On update send every line; omissions delete, never merge.",
                    "items": {
                      "description": "Uses parent cart/checkout currency.",
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "item": {
                          "properties": {
                            "id": {
                              "description": "Copy exact returned variant ID; never rebuild/truncate.",
                              "type": "string"
                            },
                            "quantity_unit": {
                              "allOf": [
                                {
                                  "allOf": [
                                    {
                                      "if": {
                                        "properties": {
                                          "unit": {
                                            "const": "C62"
                                          }
                                        },
                                        "required": [
                                          "unit"
                                        ]
                                      },
                                      "properties": {
                                        "display_text": {
                                          "description": "Printable label for unrecognized units.",
                                          "type": "string"
                                        },
                                        "scale": {
                                          "default": 0,
                                          "description": "One step = 10^-scale units; omitted=0; C62 needs 0.",
                                          "maximum": 15,
                                          "minimum": 0,
                                          "type": "integer"
                                        },
                                        "unit": {
                                          "description": "UN/CEFACT Rec 20 code, else stable opaque custom ID.",
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "unit",
                                        "display_text"
                                      ],
                                      "then": {
                                        "properties": {
                                          "scale": {
                                            "const": 0
                                          }
                                        }
                                      },
                                      "title": "Unit",
                                      "type": "object"
                                    },
                                    {
                                      "properties": {
                                        "increment": {
                                          "default": 1,
                                          "description": "Step multiple (default 1); merchant may revise/reject, never reinterpret.",
                                          "minimum": 1,
                                          "type": "integer"
                                        }
                                      },
                                      "type": "object"
                                    }
                                  ],
                                  "description": "Sale basis is unit+scale, not display_text/increment.",
                                  "title": "Quantity Unit"
                                }
                              ],
                              "description": "Omit for merchant basis; else assert unit/scale. C62/0 = each."
                            }
                          },
                          "required": [
                            "id"
                          ],
                          "title": "Item",
                          "type": "object"
                        },
                        "parent_id": {
                          "description": "Copy returned parent line ID unchanged.",
                          "type": "string"
                        },
                        "quantity": {
                          "description": "Integer sale-basis steps; missing quantity_unit is not each.",
                          "maximum": 9007199254740991,
                          "minimum": 1,
                          "type": "integer"
                        }
                      },
                      "required": [
                        "item",
                        "quantity"
                      ],
                      "title": "Line Item",
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "payment": {
                    "$schema": "https://json-schema.org/draft/2020-12/schema",
                    "description": "Only after shopper selects an instrument.",
                    "properties": {
                      "instruments": {
                        "items": {
                          "allOf": [
                            {
                              "$schema": "https://json-schema.org/draft/2020-12/schema",
                              "additionalProperties": true,
                              "properties": {
                                "billing_address": {
                                  "properties": {
                                    "address_country": {
                                      "$ref": "#/$defs/d1"
                                    },
                                    "address_locality": {
                                      "$ref": "#/$defs/d2"
                                    },
                                    "address_region": {
                                      "$ref": "#/$defs/d3"
                                    },
                                    "extended_address": {
                                      "$ref": "#/$defs/d4"
                                    },
                                    "first_name": {
                                      "$ref": "#/$defs/d5"
                                    },
                                    "last_name": {
                                      "$ref": "#/$defs/d6"
                                    },
                                    "phone_number": {
                                      "$ref": "#/$defs/d7"
                                    },
                                    "postal_code": {
                                      "$ref": "#/$defs/d8"
                                    },
                                    "street_address": {
                                      "$ref": "#/$defs/d9"
                                    }
                                  },
                                  "title": "Postal Address",
                                  "type": "object"
                                },
                                "credential": {
                                  "additionalProperties": true,
                                  "description": "Shape defined by the handler.",
                                  "properties": {
                                    "type": {
                                      "description": "Type the handler requires.",
                                      "type": "string"
                                    }
                                  },
                                  "required": [
                                    "type"
                                  ],
                                  "title": "Payment Credential",
                                  "type": "object"
                                },
                                "display": {
                                  "type": "object"
                                },
                                "handler_id": {
                                  "description": "Merchant-advertised handler ID.",
                                  "type": "string"
                                },
                                "id": {
                                  "description": "Opaque; never reuse across merchants.",
                                  "type": "string"
                                },
                                "type": {
                                  "description": "Handler category, e.g. card.",
                                  "type": "string"
                                }
                              },
                              "required": [
                                "id",
                                "handler_id",
                                "type"
                              ],
                              "title": "Payment Instrument",
                              "type": "object"
                            },
                            {
                              "properties": {
                                "selected": {
                                  "description": "True only on the one shopper-approved instrument.",
                                  "type": "boolean"
                                }
                              },
                              "type": "object"
                            }
                          ],
                          "title": "Selected Payment Instrument"
                        },
                        "type": "array"
                      }
                    },
                    "title": "Payment",
                    "type": "object"
                  },
                  "signals": {
                    "additionalProperties": true,
                    "description": "Observed/verified platform facts; no buyer claims.",
                    "properties": {
                      "dev.ucp.buyer_ip": {
                        "type": "string"
                      },
                      "dev.ucp.user_agent": {
                        "type": "string"
                      }
                    },
                    "propertyNames": {
                      "allOf": [
                        {
                          "$ref": "#/$defs/d10"
                        }
                      ]
                    },
                    "title": "Signals",
                    "type": "object"
                  }
                },
                "required": [
                  "line_items"
                ],
                "title": "Checkout",
                "type": "object",
                "version": "2026-08-25"
              },
              "d1": {
                "description": "ISO 3166-1 alpha-2, e.g. US.",
                "type": "string"
              },
              "d10": {
                "description": "Reverse domain, 2+ segments.",
                "examples": [
                  "dev.ucp.shopping.checkout",
                  "dev.ucp.common.identity_linking",
                  "com.example.loyalty_gold",
                  "com.example-shop.checkout",
                  "com.2example.cart",
                  "uk.co.example-shop.checkout",
                  "xn--p1ai.example.checkout"
                ],
                "pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$",
                "title": "Reverse Domain Name",
                "type": "string"
              },
              "d2": {
                "type": "string"
              },
              "d3": {
                "type": "string"
              },
              "d4": {
                "type": "string"
              },
              "d5": {
                "type": "string"
              },
              "d6": {
                "type": "string"
              },
              "d7": {
                "type": "string"
              },
              "d8": {
                "type": "string"
              },
              "d9": {
                "type": "string"
              }
            },
            "additionalProperties": false,
            "properties": {
              "checkout": {
                "allOf": [
                  {
                    "allOf": [
                      {
                        "$ref": "#/$defs/d0"
                      },
                      {
                        "properties": {
                          "discounts": {
                            "properties": {
                              "codes": {
                                "description": "Replace case-insensitively; [] clears all.",
                                "items": {
                                  "type": "string"
                                },
                                "type": "array"
                              }
                            },
                            "type": "object"
                          }
                        },
                        "type": "object"
                      }
                    ],
                    "title": "Checkout with Discount"
                  },
                  {
                    "allOf": [
                      {
                        "$ref": "#/$defs/d0"
                      },
                      {
                        "properties": {
                          "fulfillment": {
                            "allOf": [
                              {
                                "properties": {
                                  "methods": {
                                    "description": "Methods covering the checkout's line items.",
                                    "items": {
                                      "allOf": [
                                        {
                                          "if": {
                                            "properties": {
                                              "type": {
                                                "const": "shipping"
                                              }
                                            },
                                            "required": [
                                              "type"
                                            ]
                                          },
                                          "then": {
                                            "properties": {
                                              "destinations": {
                                                "description": "Platform-authored shipping addresses.",
                                                "items": {
                                                  "allOf": [
                                                    {
                                                      "properties": {
                                                        "address_country": {
                                                          "$ref": "#/$defs/d1"
                                                        },
                                                        "address_locality": {
                                                          "$ref": "#/$defs/d2"
                                                        },
                                                        "address_region": {
                                                          "$ref": "#/$defs/d3"
                                                        },
                                                        "extended_address": {
                                                          "$ref": "#/$defs/d4"
                                                        },
                                                        "first_name": {
                                                          "$ref": "#/$defs/d5"
                                                        },
                                                        "last_name": {
                                                          "$ref": "#/$defs/d6"
                                                        },
                                                        "phone_number": {
                                                          "$ref": "#/$defs/d7"
                                                        },
                                                        "postal_code": {
                                                          "$ref": "#/$defs/d8"
                                                        },
                                                        "street_address": {
                                                          "$ref": "#/$defs/d9"
                                                        }
                                                      },
                                                      "title": "Postal Address",
                                                      "type": "object"
                                                    },
                                                    {
                                                      "properties": {
                                                        "id": {
                                                          "description": "Platform-assigned ID for this address.",
                                                          "type": "string"
                                                        },
                                                        "type": {
                                                          "const": "shipping_address",
                                                          "type": "string"
                                                        }
                                                      },
                                                      "required": [],
                                                      "type": "object"
                                                    }
                                                  ],
                                                  "title": "Shipping Destination",
                                                  "type": "object"
                                                },
                                                "type": "array"
                                              }
                                            }
                                          }
                                        },
                                        {
                                          "if": {
                                            "properties": {
                                              "type": {
                                                "const": "pickup"
                                              }
                                            },
                                            "required": [
                                              "type"
                                            ]
                                          },
                                          "then": {
                                            "properties": {}
                                          }
                                        }
                                      ],
                                      "dependentRequired": {
                                        "destinations": [
                                          "type"
                                        ]
                                      },
                                      "properties": {
                                        "groups": {
                                          "description": "Merchant groups; select returned options.",
                                          "items": {
                                            "additionalProperties": true,
                                            "properties": {
                                              "id": {
                                                "description": "On update, merchant-returned group ID.",
                                                "type": "string"
                                              },
                                              "selected_option_id": {
                                                "description": "Option ID returned for this group.",
                                                "type": [
                                                  "string",
                                                  "null"
                                                ]
                                              }
                                            },
                                            "required": [
                                              "id"
                                            ],
                                            "title": "Fulfillment Group",
                                            "type": "object"
                                          },
                                          "type": "array"
                                        },
                                        "id": {
                                          "description": "On update, merchant-returned method ID.",
                                          "type": "string"
                                        },
                                        "line_item_ids": {
                                          "description": "On update, returned line IDs fulfilled by this method.",
                                          "items": {
                                            "type": "string"
                                          },
                                          "type": "array"
                                        },
                                        "selected_destination_id": {
                                          "description": "Merchant-scoped; need not be returned.",
                                          "type": [
                                            "string",
                                            "null"
                                          ]
                                        },
                                        "type": {
                                          "description": "Shipping, pickup, or another supported type.",
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "line_item_ids"
                                      ],
                                      "title": "Fulfillment Method",
                                      "type": "object"
                                    },
                                    "type": "array"
                                  }
                                },
                                "title": "Fulfillment",
                                "type": "object"
                              }
                            ]
                          }
                        },
                        "type": "object"
                      }
                    ],
                    "title": "Checkout with Fulfillment"
                  },
                  {
                    "not": {
                      "required": [
                        "attribution"
                      ]
                    }
                  }
                ],
                "type": "object"
              },
              "id": {
                "type": "string"
              },
              "meta": {
                "additionalProperties": false,
                "properties": {
                  "idempotency-key": {
                    "description": "UUID for one write; reuse for exact retries. complete_checkout derives if omitted.",
                    "format": "uuid",
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "shop": {
                "description": "Exact seller.domain storefront hostname from offer; no scheme/path; one seller per cart/checkout.",
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "id",
              "checkout",
              "shop"
            ],
            "type": "object"
          },
          "annotations": {
            "destructiveHint": true,
            "idempotentHint": false,
            "openWorldHint": true,
            "readOnlyHint": false
          }
        },
        {
          "name": "complete_checkout",
          "description": "Send user-approved payment to the same shop/exact checkout ID with one exact offered instrument selected:true. Only completed + order proves purchase. After uncertainty, read get_checkout; never repeat completion or start a replacement purchase.",
          "inputSchema": {
            "$defs": {
              "d0": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "additionalProperties": true,
                "name": "dev.ucp.shopping.checkout",
                "properties": {
                  "payment": {
                    "$schema": "https://json-schema.org/draft/2020-12/schema",
                    "description": "Only after shopper selects an instrument.",
                    "properties": {
                      "instruments": {
                        "items": {
                          "allOf": [
                            {
                              "$schema": "https://json-schema.org/draft/2020-12/schema",
                              "additionalProperties": true,
                              "properties": {
                                "billing_address": {
                                  "properties": {
                                    "address_country": {
                                      "description": "ISO 3166-1 alpha-2, e.g. US.",
                                      "type": "string"
                                    },
                                    "address_locality": {
                                      "type": "string"
                                    },
                                    "address_region": {
                                      "type": "string"
                                    },
                                    "extended_address": {
                                      "type": "string"
                                    },
                                    "first_name": {
                                      "type": "string"
                                    },
                                    "last_name": {
                                      "type": "string"
                                    },
                                    "phone_number": {
                                      "type": "string"
                                    },
                                    "postal_code": {
                                      "type": "string"
                                    },
                                    "street_address": {
                                      "type": "string"
                                    }
                                  },
                                  "title": "Postal Address",
                                  "type": "object"
                                },
                                "credential": {
                                  "additionalProperties": true,
                                  "description": "Shape defined by the handler.",
                                  "properties": {
                                    "type": {
                                      "description": "Type the handler requires.",
                                      "type": "string"
                                    }
                                  },
                                  "required": [
                                    "type"
                                  ],
                                  "title": "Payment Credential",
                                  "type": "object"
                                },
                                "display": {
                                  "type": "object"
                                },
                                "handler_id": {
                                  "description": "Merchant-advertised handler ID.",
                                  "type": "string"
                                },
                                "id": {
                                  "description": "Opaque; never reuse across merchants.",
                                  "type": "string"
                                },
                                "type": {
                                  "description": "Handler category, e.g. card.",
                                  "type": "string"
                                }
                              },
                              "required": [
                                "id",
                                "handler_id",
                                "type"
                              ],
                              "title": "Payment Instrument",
                              "type": "object"
                            },
                            {
                              "properties": {
                                "selected": {
                                  "description": "True only on the one shopper-approved instrument.",
                                  "type": "boolean"
                                }
                              },
                              "type": "object"
                            }
                          ],
                          "title": "Selected Payment Instrument"
                        },
                        "type": "array"
                      }
                    },
                    "title": "Payment",
                    "type": "object"
                  },
                  "signals": {
                    "additionalProperties": true,
                    "description": "Observed/verified platform facts; no buyer claims.",
                    "properties": {
                      "dev.ucp.buyer_ip": {
                        "type": "string"
                      },
                      "dev.ucp.user_agent": {
                        "type": "string"
                      }
                    },
                    "propertyNames": {
                      "allOf": [
                        {
                          "description": "Reverse domain, 2+ segments.",
                          "examples": [
                            "dev.ucp.shopping.checkout",
                            "dev.ucp.common.identity_linking",
                            "com.example.loyalty_gold",
                            "com.example-shop.checkout",
                            "com.2example.cart",
                            "uk.co.example-shop.checkout",
                            "xn--p1ai.example.checkout"
                          ],
                          "pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$",
                          "title": "Reverse Domain Name",
                          "type": "string"
                        }
                      ]
                    },
                    "title": "Signals",
                    "type": "object"
                  }
                },
                "required": [
                  "payment"
                ],
                "title": "Checkout",
                "type": "object",
                "version": "2026-08-25"
              }
            },
            "additionalProperties": false,
            "properties": {
              "checkout": {
                "allOf": [
                  {
                    "allOf": [
                      {
                        "$ref": "#/$defs/d0"
                      },
                      {
                        "properties": {},
                        "type": "object"
                      }
                    ],
                    "title": "Checkout with Discount"
                  },
                  {
                    "allOf": [
                      {
                        "$ref": "#/$defs/d0"
                      },
                      {
                        "properties": {},
                        "type": "object"
                      }
                    ],
                    "title": "Checkout with Fulfillment"
                  },
                  {
                    "not": {
                      "required": [
                        "attribution"
                      ]
                    }
                  }
                ],
                "type": "object"
              },
              "id": {
                "type": "string"
              },
              "meta": {
                "additionalProperties": false,
                "properties": {
                  "idempotency-key": {
                    "description": "UUID for one write; reuse for exact retries. complete_checkout derives if omitted.",
                    "format": "uuid",
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "shop": {
                "description": "Exact seller.domain storefront hostname from offer; no scheme/path; one seller per cart/checkout.",
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "id",
              "checkout",
              "shop"
            ],
            "type": "object"
          },
          "annotations": {
            "destructiveHint": true,
            "idempotentHint": false,
            "openWorldHint": true,
            "readOnlyHint": false
          }
        },
        {
          "name": "create_cart",
          "description": "Create a cart only when asked to save items; interest is not permission. Use exact returned variant IDs/quantities. Use create_checkout for Review and pay. Does not order.",
          "inputSchema": {
            "$defs": {
              "d0": {
                "description": "Reverse domain, 2+ segments.",
                "examples": [
                  "dev.ucp.shopping.checkout",
                  "dev.ucp.common.identity_linking",
                  "com.example.loyalty_gold",
                  "com.example-shop.checkout",
                  "com.2example.cart",
                  "uk.co.example-shop.checkout",
                  "xn--p1ai.example.checkout"
                ],
                "pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$",
                "title": "Reverse Domain Name",
                "type": "string"
              }
            },
            "additionalProperties": false,
            "properties": {
              "cart": {
                "allOf": [
                  {
                    "allOf": [
                      {
                        "$schema": "https://json-schema.org/draft/2020-12/schema",
                        "additionalProperties": true,
                        "name": "dev.ucp.shopping.cart",
                        "properties": {
                          "buyer": {
                            "additionalProperties": true,
                            "description": "Buyer details for personalized estimates.",
                            "properties": {
                              "email": {
                                "type": "string"
                              },
                              "first_name": {
                                "type": "string"
                              },
                              "last_name": {
                                "type": "string"
                              },
                              "phone_number": {
                                "description": "Buyer phone in E.164.",
                                "type": "string"
                              }
                            },
                            "title": "Buyer",
                            "type": "object"
                          },
                          "context": {
                            "allOf": [
                              {
                                "additionalProperties": true,
                                "allOf": [
                                  {
                                    "additionalProperties": true,
                                    "description": "Coarse locality; not an address.",
                                    "properties": {
                                      "address_country": {
                                        "description": "ISO 3166-1 alpha-2, e.g. US.",
                                        "type": "string"
                                      },
                                      "address_region": {
                                        "type": "string"
                                      },
                                      "postal_code": {
                                        "type": "string"
                                      }
                                    },
                                    "title": "Locality",
                                    "type": "object"
                                  },
                                  {
                                    "additionalProperties": true,
                                    "properties": {
                                      "currency": {
                                        "description": "ISO 4217 preference/filter currency; verify output.",
                                        "type": "string"
                                      },
                                      "eligibility": {
                                        "description": "Nonidentifying reverse-domain benefits; ignore unknowns.",
                                        "items": {
                                          "$ref": "#/$defs/d0"
                                        },
                                        "type": "array",
                                        "uniqueItems": true
                                      },
                                      "intent": {
                                        "description": "Relevance hint, e.g. 'gift under $50'.",
                                        "type": "string"
                                      },
                                      "language": {
                                        "description": "BCP 47 preference, e.g. fr-CA.",
                                        "type": "string"
                                      },
                                      "location": {
                                        "description": "Opaque merchant location ID, not locality.",
                                        "type": "string"
                                      },
                                      "payment": {
                                        "description": "Advertised handlers, most preferred first; ignore unknowns.",
                                        "items": {
                                          "properties": {
                                            "handler": {
                                              "allOf": [
                                                {
                                                  "$ref": "#/$defs/d0"
                                                }
                                              ],
                                              "description": "Merchant ucp.payment_handlers key."
                                            },
                                            "types": {
                                              "description": "Instrument types, most preferred first; ignore unknowns.",
                                              "items": {
                                                "type": "string"
                                              },
                                              "type": "array"
                                            }
                                          },
                                          "required": [
                                            "handler"
                                          ],
                                          "type": "object"
                                        },
                                        "type": "array"
                                      }
                                    },
                                    "type": "object"
                                  }
                                ],
                                "description": "Soft relevance/localization; checkout wins.",
                                "title": "Context",
                                "type": "object"
                              }
                            ],
                            "description": "Soft pricing/availability/currency hints; geo-IP may fallback."
                          },
                          "line_items": {
                            "description": "On update send every line; omissions delete, not merge.",
                            "items": {
                              "description": "Uses parent cart/checkout currency.",
                              "properties": {
                                "item": {
                                  "properties": {
                                    "id": {
                                      "description": "Copy exact returned variant ID; never rebuild/truncate.",
                                      "type": "string"
                                    },
                                    "quantity_unit": {
                                      "allOf": [
                                        {
                                          "allOf": [
                                            {
                                              "if": {
                                                "properties": {
                                                  "unit": {
                                                    "const": "C62"
                                                  }
                                                },
                                                "required": [
                                                  "unit"
                                                ]
                                              },
                                              "properties": {
                                                "display_text": {
                                                  "description": "Printable label for unrecognized units.",
                                                  "type": "string"
                                                },
                                                "scale": {
                                                  "default": 0,
                                                  "description": "One step = 10^-scale units; omitted=0; C62 needs 0.",
                                                  "maximum": 15,
                                                  "minimum": 0,
                                                  "type": "integer"
                                                },
                                                "unit": {
                                                  "description": "UN/CEFACT Rec 20 code, else stable opaque custom ID.",
                                                  "type": "string"
                                                }
                                              },
                                              "required": [
                                                "unit",
                                                "display_text"
                                              ],
                                              "then": {
                                                "properties": {
                                                  "scale": {
                                                    "const": 0
                                                  }
                                                }
                                              },
                                              "title": "Unit",
                                              "type": "object"
                                            },
                                            {
                                              "properties": {
                                                "increment": {
                                                  "default": 1,
                                                  "description": "Step multiple (default 1); merchant may revise/reject, never reinterpret.",
                                                  "minimum": 1,
                                                  "type": "integer"
                                                }
                                              },
                                              "type": "object"
                                            }
                                          ],
                                          "description": "Sale basis is unit+scale, not display_text/increment.",
                                          "title": "Quantity Unit"
                                        }
                                      ],
                                      "description": "Omit for merchant basis; else assert unit/scale. C62/0 = each."
                                    }
                                  },
                                  "required": [
                                    "id"
                                  ],
                                  "title": "Item",
                                  "type": "object"
                                },
                                "quantity": {
                                  "description": "Integer sale-basis steps; missing quantity_unit is not each.",
                                  "maximum": 9007199254740991,
                                  "minimum": 1,
                                  "type": "integer"
                                }
                              },
                              "required": [
                                "item",
                                "quantity"
                              ],
                              "title": "Line Item",
                              "type": "object"
                            },
                            "type": "array"
                          },
                          "signals": {
                            "additionalProperties": true,
                            "description": "Observed/verified platform facts; no buyer claims.",
                            "properties": {
                              "dev.ucp.buyer_ip": {
                                "type": "string"
                              },
                              "dev.ucp.user_agent": {
                                "type": "string"
                              }
                            },
                            "propertyNames": {
                              "allOf": [
                                {
                                  "$ref": "#/$defs/d0"
                                }
                              ]
                            },
                            "title": "Signals",
                            "type": "object"
                          }
                        },
                        "required": [
                          "line_items"
                        ],
                        "title": "Cart",
                        "type": "object",
                        "version": "2026-08-25"
                      },
                      {
                        "properties": {
                          "discounts": {
                            "properties": {
                              "codes": {
                                "description": "Replace case-insensitively; [] clears all.",
                                "items": {
                                  "type": "string"
                                },
                                "type": "array"
                              }
                            },
                            "type": "object"
                          }
                        },
                        "type": "object"
                      }
                    ],
                    "title": "Cart with Discount"
                  },
                  {
                    "not": {
                      "required": [
                        "attribution"
                      ]
                    }
                  }
                ],
                "type": "object"
              },
              "meta": {
                "additionalProperties": false,
                "properties": {
                  "idempotency-key": {
                    "description": "UUID for one write; reuse for exact retries. complete_checkout derives if omitted.",
                    "format": "uuid",
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "shop": {
                "description": "Exact seller.domain storefront hostname from offer; no scheme/path; one seller per cart/checkout.",
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "cart",
              "shop"
            ],
            "type": "object"
          },
          "annotations": {
            "destructiveHint": true,
            "idempotentHint": false,
            "openWorldHint": true,
            "readOnlyHint": false
          }
        },
        {
          "name": "get_cart",
          "description": "Read with the same shop/exact opaque ID before update or after an uncertain cart write.",
          "inputSchema": {
            "additionalProperties": false,
            "properties": {
              "id": {
                "type": "string"
              },
              "shop": {
                "description": "Exact seller.domain storefront hostname from offer; no scheme/path; one seller per cart/checkout.",
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "id",
              "shop"
            ],
            "type": "object"
          },
          "annotations": {
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true,
            "readOnlyHint": true
          }
        },
        {
          "name": "update_cart",
          "description": "Replace full cart, not a patch. Read first; change only authorized fields; retain all other request fields, including empty objects/arrays. Response-only fields drop. Same shop/exact ID; check returned state. After uncertainty, read before retry.",
          "inputSchema": {
            "$defs": {
              "d0": {
                "description": "Reverse domain, 2+ segments.",
                "examples": [
                  "dev.ucp.shopping.checkout",
                  "dev.ucp.common.identity_linking",
                  "com.example.loyalty_gold",
                  "com.example-shop.checkout",
                  "com.2example.cart",
                  "uk.co.example-shop.checkout",
                  "xn--p1ai.example.checkout"
                ],
                "pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$",
                "title": "Reverse Domain Name",
                "type": "string"
              }
            },
            "additionalProperties": false,
            "properties": {
              "cart": {
                "allOf": [
                  {
                    "allOf": [
                      {
                        "$schema": "https://json-schema.org/draft/2020-12/schema",
                        "additionalProperties": true,
                        "name": "dev.ucp.shopping.cart",
                        "properties": {
                          "buyer": {
                            "additionalProperties": true,
                            "description": "Buyer details for personalized estimates.",
                            "properties": {
                              "email": {
                                "type": "string"
                              },
                              "first_name": {
                                "type": "string"
                              },
                              "last_name": {
                                "type": "string"
                              },
                              "phone_number": {
                                "description": "Buyer phone in E.164.",
                                "type": "string"
                              }
                            },
                            "title": "Buyer",
                            "type": "object"
                          },
                          "context": {
                            "allOf": [
                              {
                                "additionalProperties": true,
                                "allOf": [
                                  {
                                    "additionalProperties": true,
                                    "description": "Coarse locality; not an address.",
                                    "properties": {
                                      "address_country": {
                                        "description": "ISO 3166-1 alpha-2, e.g. US.",
                                        "type": "string"
                                      },
                                      "address_region": {
                                        "type": "string"
                                      },
                                      "postal_code": {
                                        "type": "string"
                                      }
                                    },
                                    "title": "Locality",
                                    "type": "object"
                                  },
                                  {
                                    "additionalProperties": true,
                                    "properties": {
                                      "currency": {
                                        "description": "ISO 4217 preference/filter currency; verify output.",
                                        "type": "string"
                                      },
                                      "eligibility": {
                                        "description": "Nonidentifying reverse-domain benefits; ignore unknowns.",
                                        "items": {
                                          "$ref": "#/$defs/d0"
                                        },
                                        "type": "array",
                                        "uniqueItems": true
                                      },
                                      "intent": {
                                        "description": "Relevance hint, e.g. 'gift under $50'.",
                                        "type": "string"
                                      },
                                      "language": {
                                        "description": "BCP 47 preference, e.g. fr-CA.",
                                        "type": "string"
                                      },
                                      "location": {
                                        "description": "Opaque merchant location ID, not locality.",
                                        "type": "string"
                                      },
                                      "payment": {
                                        "description": "Advertised handlers, most preferred first; ignore unknowns.",
                                        "items": {
                                          "properties": {
                                            "handler": {
                                              "allOf": [
                                                {
                                                  "$ref": "#/$defs/d0"
                                                }
                                              ],
                                              "description": "Merchant ucp.payment_handlers key."
                                            },
                                            "types": {
                                              "description": "Instrument types, most preferred first; ignore unknowns.",
                                              "items": {
                                                "type": "string"
                                              },
                                              "type": "array"
                                            }
                                          },
                                          "required": [
                                            "handler"
                                          ],
                                          "type": "object"
                                        },
                                        "type": "array"
                                      }
                                    },
                                    "type": "object"
                                  }
                                ],
                                "description": "Soft relevance/localization; checkout wins.",
                                "title": "Context",
                                "type": "object"
                              }
                            ],
                            "description": "Soft pricing/availability/currency hints; geo-IP may fallback."
                          },
                          "line_items": {
                            "description": "On update send every line; omissions delete, not merge.",
                            "items": {
                              "description": "Uses parent cart/checkout currency.",
                              "properties": {
                                "id": {
                                  "type": "string"
                                },
                                "item": {
                                  "properties": {
                                    "id": {
                                      "description": "Copy exact returned variant ID; never rebuild/truncate.",
                                      "type": "string"
                                    },
                                    "quantity_unit": {
                                      "allOf": [
                                        {
                                          "allOf": [
                                            {
                                              "if": {
                                                "properties": {
                                                  "unit": {
                                                    "const": "C62"
                                                  }
                                                },
                                                "required": [
                                                  "unit"
                                                ]
                                              },
                                              "properties": {
                                                "display_text": {
                                                  "description": "Printable label for unrecognized units.",
                                                  "type": "string"
                                                },
                                                "scale": {
                                                  "default": 0,
                                                  "description": "One step = 10^-scale units; omitted=0; C62 needs 0.",
                                                  "maximum": 15,
                                                  "minimum": 0,
                                                  "type": "integer"
                                                },
                                                "unit": {
                                                  "description": "UN/CEFACT Rec 20 code, else stable opaque custom ID.",
                                                  "type": "string"
                                                }
                                              },
                                              "required": [
                                                "unit",
                                                "display_text"
                                              ],
                                              "then": {
                                                "properties": {
                                                  "scale": {
                                                    "const": 0
                                                  }
                                                }
                                              },
                                              "title": "Unit",
                                              "type": "object"
                                            },
                                            {
                                              "properties": {
                                                "increment": {
                                                  "default": 1,
                                                  "description": "Step multiple (default 1); merchant may revise/reject, never reinterpret.",
                                                  "minimum": 1,
                                                  "type": "integer"
                                                }
                                              },
                                              "type": "object"
                                            }
                                          ],
                                          "description": "Sale basis is unit+scale, not display_text/increment.",
                                          "title": "Quantity Unit"
                                        }
                                      ],
                                      "description": "Omit for merchant basis; else assert unit/scale. C62/0 = each."
                                    }
                                  },
                                  "required": [
                                    "id"
                                  ],
                                  "title": "Item",
                                  "type": "object"
                                },
                                "parent_id": {
                                  "description": "Copy returned parent line ID unchanged.",
                                  "type": "string"
                                },
                                "quantity": {
                                  "description": "Integer sale-basis steps; missing quantity_unit is not each.",
                                  "maximum": 9007199254740991,
                                  "minimum": 1,
                                  "type": "integer"
                                }
                              },
                              "required": [
                                "item",
                                "quantity"
                              ],
                              "title": "Line Item",
                              "type": "object"
                            },
                            "type": "array"
                          },
                          "signals": {
                            "additionalProperties": true,
                            "description": "Observed/verified platform facts; no buyer claims.",
                            "properties": {
                              "dev.ucp.buyer_ip": {
                                "type": "string"
                              },
                              "dev.ucp.user_agent": {
                                "type": "string"
                              }
                            },
                            "propertyNames": {
                              "allOf": [
                                {
                                  "$ref": "#/$defs/d0"
                                }
                              ]
                            },
                            "title": "Signals",
                            "type": "object"
                          }
                        },
                        "required": [
                          "line_items"
                        ],
                        "title": "Cart",
                        "type": "object",
                        "version": "2026-08-25"
                      },
                      {
                        "properties": {
                          "discounts": {
                            "properties": {
                              "codes": {
                                "description": "Replace case-insensitively; [] clears all.",
                                "items": {
                                  "type": "string"
                                },
                                "type": "array"
                              }
                            },
                            "type": "object"
                          }
                        },
                        "type": "object"
                      }
                    ],
                    "title": "Cart with Discount"
                  },
                  {
                    "not": {
                      "required": [
                        "attribution"
                      ]
                    }
                  }
                ],
                "type": "object"
              },
              "id": {
                "type": "string"
              },
              "meta": {
                "additionalProperties": false,
                "properties": {
                  "idempotency-key": {
                    "description": "UUID for one write; reuse for exact retries. complete_checkout derives if omitted.",
                    "format": "uuid",
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "shop": {
                "description": "Exact seller.domain storefront hostname from offer; no scheme/path; one seller per cart/checkout.",
                "minLength": 1,
                "type": "string"
              }
            },
            "required": [
              "id",
              "cart",
              "shop"
            ],
            "type": "object"
          },
          "annotations": {
            "destructiveHint": true,
            "idempotentHint": false,
            "openWorldHint": true,
            "readOnlyHint": false
          }
        },
        {
          "name": "search_catalog",
          "description": "Find by query/like. Anonymous works; sign-in adds saved preferences. Context soft; filters hard. Matches/options do not prove the variant. Check messages; ground options, availability, price/currency, rating, seller, and URL in the exact offer. Use get_product only for unresolved facts/options. Amounts are minor units.",
          "inputSchema": {
            "$defs": {
              "d0": {
                "description": "Reverse domain, 2+ segments.",
                "examples": [
                  "dev.ucp.shopping.checkout",
                  "dev.ucp.common.identity_linking",
                  "com.example.loyalty_gold",
                  "com.example-shop.checkout",
                  "com.2example.cart",
                  "uk.co.example-shop.checkout",
                  "xn--p1ai.example.checkout"
                ],
                "pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$",
                "title": "Reverse Domain Name",
                "type": "string"
              },
              "d1": {
                "additionalProperties": true,
                "properties": {
                  "categories": {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "price": {
                    "description": "Inclusive context.currency minor-unit bounds.",
                    "properties": {
                      "max": {
                        "allOf": [
                          {
                            "$ref": "#/$defs/d2"
                          }
                        ]
                      },
                      "min": {
                        "allOf": [
                          {
                            "$ref": "#/$defs/d2"
                          }
                        ]
                      }
                    },
                    "title": "Price Filter",
                    "type": "object"
                  }
                },
                "title": "Search Filters",
                "type": "object"
              },
              "d2": {
                "description": "ISO 4217 minor units: USD2, JPY0, KWD3.",
                "maximum": 9007199254740991,
                "minimum": 0,
                "title": "Amount",
                "type": "integer"
              }
            },
            "additionalProperties": false,
            "properties": {
              "catalog": {
                "allOf": [
                  {
                    "allOf": [
                      {
                        "properties": {
                          "context": {
                            "additionalProperties": true,
                            "allOf": [
                              {
                                "additionalProperties": true,
                                "description": "Coarse locality; not an address.",
                                "properties": {
                                  "address_country": {
                                    "description": "ISO 3166-1 alpha-2, e.g. US.",
                                    "type": "string"
                                  },
                                  "address_region": {
                                    "type": "string"
                                  },
                                  "postal_code": {
                                    "type": "string"
                                  }
                                },
                                "title": "Locality",
                                "type": "object"
                              },
                              {
                                "additionalProperties": true,
                                "properties": {
                                  "currency": {
                                    "description": "ISO 4217 preference/filter currency; verify output.",
                                    "type": "string"
                                  },
                                  "eligibility": {
                                    "description": "Nonidentifying reverse-domain benefits; ignore unknowns.",
                                    "items": {
                                      "$ref": "#/$defs/d0"
                                    },
                                    "type": "array",
                                    "uniqueItems": true
                                  },
                                  "intent": {
                                    "description": "Relevance hint, e.g. 'gift under $50'.",
                                    "type": "string"
                                  },
                                  "language": {
                                    "description": "BCP 47 preference, e.g. fr-CA.",
                                    "type": "string"
                                  },
                                  "location": {
                                    "description": "Opaque merchant location ID, not locality.",
                                    "type": "string"
                                  },
                                  "payment": {
                                    "description": "Advertised handlers, most preferred first; ignore unknowns.",
                                    "items": {
                                      "properties": {
                                        "handler": {
                                          "allOf": [
                                            {
                                              "$ref": "#/$defs/d0"
                                            }
                                          ],
                                          "description": "Merchant ucp.payment_handlers key."
                                        },
                                        "types": {
                                          "description": "Instrument types, most preferred first; ignore unknowns.",
                                          "items": {
                                            "type": "string"
                                          },
                                          "type": "array"
                                        }
                                      },
                                      "required": [
                                        "handler"
                                      ],
                                      "type": "object"
                                    },
                                    "type": "array"
                                  }
                                },
                                "type": "object"
                              }
                            ],
                            "description": "Soft relevance/localization; checkout wins.",
                            "title": "Context",
                            "type": "object"
                          },
                          "filters": {
                            "$ref": "#/$defs/d1"
                          },
                          "pagination": {
                            "properties": {
                              "cursor": {
                                "type": "string"
                              },
                              "limit": {
                                "minimum": 1,
                                "type": "integer"
                              }
                            },
                            "type": "object"
                          },
                          "query": {
                            "type": "string"
                          },
                          "signals": {
                            "additionalProperties": true,
                            "description": "Observed/verified platform facts; no buyer claims.",
                            "properties": {
                              "dev.ucp.buyer_ip": {
                                "type": "string"
                              },
                              "dev.ucp.user_agent": {
                                "type": "string"
                              }
                            },
                            "propertyNames": {
                              "allOf": [
                                {
                                  "$ref": "#/$defs/d0"
                                }
                              ]
                            },
                            "title": "Signals",
                            "type": "object"
                          }
                        },
                        "type": "object"
                      },
                      {
                        "anyOf": [
                          {
                            "required": [
                              "query"
                            ]
                          },
                          {
                            "required": [
                              "like"
                            ]
                          }
                        ],
                        "properties": {
                          "filters": {
                            "allOf": [
                              {
                                "$ref": "#/$defs/d1"
                              },
                              {
                                "allOf": [
                                  {
                                    "properties": {
                                      "available": {
                                        "default": true,
                                        "type": "boolean"
                                      }
                                    },
                                    "title": "Shopify Filters",
                                    "type": "object"
                                  },
                                  {
                                    "properties": {
                                      "condition": {
                                        "items": {
                                          "type": "string"
                                        },
                                        "type": "array"
                                      },
                                      "ships_from": {
                                        "items": {
                                          "properties": {
                                            "country": {
                                              "pattern": "^[A-Z]{2}$",
                                              "type": "string"
                                            }
                                          },
                                          "required": [
                                            "country"
                                          ],
                                          "type": "object"
                                        },
                                        "type": "array"
                                      },
                                      "ships_to": {
                                        "properties": {
                                          "country": {
                                            "pattern": "^[A-Z]{2}$",
                                            "type": "string"
                                          },
                                          "postal_code": {
                                            "type": "string"
                                          },
                                          "region": {
                                            "type": "string"
                                          }
                                        },
                                        "required": [
                                          "country"
                                        ],
                                        "type": "object"
                                      },
                                      "shops": {
                                        "items": {
                                          "type": "string"
                                        },
                                        "maxItems": 1000,
                                        "type": "array"
                                      }
                                    },
                                    "type": "object"
                                  }
                                ],
                                "title": "Global Filters"
                              },
                              {
                                "properties": {
                                  "attributes": {
                                    "items": {
                                      "properties": {
                                        "name": {
                                          "type": "string"
                                        },
                                        "values": {
                                          "items": {
                                            "type": "string"
                                          },
                                          "maxItems": 50,
                                          "minItems": 1,
                                          "type": "array"
                                        }
                                      },
                                      "required": [
                                        "name",
                                        "values"
                                      ],
                                      "type": "object"
                                    },
                                    "maxItems": 25,
                                    "type": "array"
                                  },
                                  "categories": {
                                    "items": {
                                      "type": "string"
                                    },
                                    "type": "array"
                                  },
                                  "price_tier": {
                                    "items": {
                                      "type": "string"
                                    },
                                    "type": "array"
                                  },
                                  "rating": {
                                    "properties": {
                                      "variant": {
                                        "properties": {
                                          "min": {
                                            "maximum": 5,
                                            "minimum": 0,
                                            "type": "number"
                                          },
                                          "min_count": {
                                            "maximum": 2147483647,
                                            "minimum": 0,
                                            "type": "integer"
                                          }
                                        },
                                        "type": "object"
                                      }
                                    },
                                    "type": "object"
                                  }
                                },
                                "type": "object"
                              }
                            ],
                            "title": "Global Search Filters"
                          }
                        },
                        "type": "object"
                      }
                    ],
                    "title": "Global Search Request",
                    "type": "object"
                  },
                  {
                    "anyOf": [
                      {
                        "required": [
                          "query"
                        ]
                      },
                      {
                        "required": [
                          "like"
                        ]
                      }
                    ],
                    "properties": {
                      "catalog_id": {
                        "description": "Saved catalog ID whose configuration constrains search.",
                        "type": "string"
                      },
                      "context": {
                        "additionalProperties": true,
                        "properties": {
                          "address_country": {
                            "type": "string"
                          },
                          "address_region": {
                            "type": "string"
                          },
                          "currency": {
                            "type": "string"
                          },
                          "intent": {
                            "type": "string"
                          },
                          "language": {
                            "type": "string"
                          },
                          "postal_code": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "filters": {
                        "additionalProperties": true,
                        "description": "Hard requirements; fields AND, stated lists OR. Check messages/every offer.",
                        "properties": {
                          "attributes": {
                            "description": "Attributes AND; each value list OR. Check ignored-name messages.",
                            "items": {
                              "properties": {
                                "name": {
                                  "description": "Supported names: Color, Size, Target gender.",
                                  "type": "string"
                                },
                                "values": {
                                  "description": "OR across taxonomy values.",
                                  "items": {
                                    "type": "string"
                                  },
                                  "maxItems": 50,
                                  "minItems": 1,
                                  "type": "array"
                                }
                              },
                              "required": [
                                "name",
                                "values"
                              ],
                              "type": "object"
                            },
                            "maxItems": 25,
                            "type": "array"
                          },
                          "available": {
                            "default": true,
                            "description": "true/omitted: sale-ready only; false: include unavailable.",
                            "type": "boolean"
                          },
                          "categories": {
                            "description": "OR taxonomy category GIDs.",
                            "items": {
                              "type": "string"
                            },
                            "type": "array"
                          },
                          "condition": {
                            "description": "OR new/secondhand; omit for either.",
                            "items": {
                              "type": "string"
                            },
                            "type": "array"
                          },
                          "price": {
                            "properties": {
                              "max": {
                                "type": "integer"
                              },
                              "min": {
                                "type": "integer"
                              }
                            },
                            "type": "object"
                          },
                          "price_tier": {
                            "description": "OR category-relative tiers, not a budget cap; check ignored-value messages.",
                            "items": {
                              "type": "string"
                            },
                            "type": "array"
                          },
                          "rating": {
                            "properties": {
                              "variant": {
                                "description": "At least one variant must meet these thresholds.",
                                "properties": {
                                  "min": {
                                    "description": "Minimum rating on a 0–5 scale.",
                                    "maximum": 5,
                                    "minimum": 0,
                                    "type": "number"
                                  },
                                  "min_count": {
                                    "description": "Minimum variant review count.",
                                    "maximum": 2147483647,
                                    "minimum": 0,
                                    "type": "integer"
                                  }
                                },
                                "type": "object"
                              }
                            },
                            "type": "object"
                          },
                          "ships_from": {
                            "description": "OR origins; omit for any.",
                            "items": {
                              "properties": {
                                "country": {
                                  "description": "ISO 3166-1 alpha-2.",
                                  "pattern": "^[A-Z]{2}$",
                                  "type": "string"
                                }
                              },
                              "required": [
                                "country"
                              ],
                              "type": "object"
                            },
                            "type": "array"
                          },
                          "ships_to": {
                            "description": "Hard destination; context may supply it if omitted; matching context may refine estimates.",
                            "properties": {
                              "country": {
                                "description": "ISO 3166-1 alpha-2.",
                                "pattern": "^[A-Z]{2}$",
                                "type": "string"
                              },
                              "postal_code": {
                                "type": "string"
                              },
                              "region": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "country"
                            ],
                            "type": "object"
                          },
                          "shops": {
                            "description": "OR seller.id Shop GIDs/domains; check unmatched messages.",
                            "items": {
                              "type": "string"
                            },
                            "maxItems": 1000,
                            "type": "array"
                          }
                        },
                        "type": "object"
                      },
                      "like": {
                        "description": "One product/variant ID or image reference for similarity. Add query to refine an image reference. Put hard requirements in supported filters.",
                        "items": {
                          "oneOf": [
                            {
                              "additionalProperties": false,
                              "properties": {
                                "id": {
                                  "description": "Exact Shopify product or variant GID.",
                                  "pattern": "^gid://shopify/",
                                  "type": "string"
                                }
                              },
                              "required": [
                                "id"
                              ],
                              "title": "Item Reference"
                            },
                            {
                              "additionalProperties": false,
                              "properties": {
                                "image": {
                                  "additionalProperties": false,
                                  "properties": {
                                    "content_type": {
                                      "description": "Image MIME type, e.g. image/jpeg or image/webp.",
                                      "type": "string"
                                    },
                                    "data": {
                                      "contentEncoding": "base64",
                                      "description": "Base64-encoded image bytes.",
                                      "type": "string"
                                    }
                                  },
                                  "required": [
                                    "content_type",
                                    "data"
                                  ],
                                  "type": "object"
                                }
                              },
                              "required": [
                                "image"
                              ],
                              "title": "Image Content"
                            }
                          ],
                          "title": "Like Item",
                          "type": "object"
                        },
                        "maxItems": 2,
                        "minItems": 1,
                        "type": "array"
                      },
                      "pagination": {
                        "properties": {
                          "cursor": {
                            "description": "Pass unchanged with the same query, like, context, and filters.",
                            "type": "string"
                          },
                          "limit": {
                            "default": 10,
                            "description": "Page size. Defaults to 10; maximum 50.",
                            "maximum": 50,
                            "minimum": 1,
                            "type": "integer"
                          }
                        },
                        "type": "object"
                      },
                      "query": {
                        "description": "Preserve intent; clarify only. Add no preferences/popularity. Put hard requirements in supported filters.",
                        "type": "string"
                      },
                      "signals": {
                        "additionalProperties": true,
                        "properties": {
                          "dev.ucp.buyer_ip": {
                            "type": "string"
                          },
                          "dev.ucp.user_agent": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      }
                    },
                    "type": "object"
                  },
                  {
                    "not": {
                      "required": [
                        "attribution"
                      ]
                    }
                  },
                  {
                    "not": {
                      "required": [
                        "view"
                      ]
                    }
                  }
                ],
                "type": "object"
              }
            },
            "required": [
              "catalog"
            ],
            "type": "object"
          },
          "annotations": {
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true,
            "readOnlyHint": true
          }
        },
        {
          "name": "lookup_catalog",
          "description": "Resolve known product/variant IDs, GTINs, UPCs, or URLs. Use search_catalog for discovery; get_product only for unresolved options/details. Preserve IDs/URLs; ground claims in the exact offer. Amounts are minor units.",
          "inputSchema": {
            "$defs": {
              "d0": {
                "description": "Reverse domain, 2+ segments.",
                "examples": [
                  "dev.ucp.shopping.checkout",
                  "dev.ucp.common.identity_linking",
                  "com.example.loyalty_gold",
                  "com.example-shop.checkout",
                  "com.2example.cart",
                  "uk.co.example-shop.checkout",
                  "xn--p1ai.example.checkout"
                ],
                "pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$",
                "title": "Reverse Domain Name",
                "type": "string"
              },
              "d1": {
                "description": "ISO 4217 minor units: USD2, JPY0, KWD3.",
                "maximum": 9007199254740991,
                "minimum": 0,
                "title": "Amount",
                "type": "integer"
              }
            },
            "additionalProperties": false,
            "properties": {
              "catalog": {
                "allOf": [
                  {
                    "allOf": [
                      {
                        "properties": {
                          "context": {
                            "additionalProperties": true,
                            "allOf": [
                              {
                                "additionalProperties": true,
                                "description": "Coarse locality; not an address.",
                                "properties": {
                                  "address_country": {
                                    "description": "ISO 3166-1 alpha-2, e.g. US.",
                                    "type": "string"
                                  },
                                  "address_region": {
                                    "type": "string"
                                  },
                                  "postal_code": {
                                    "type": "string"
                                  }
                                },
                                "title": "Locality",
                                "type": "object"
                              },
                              {
                                "additionalProperties": true,
                                "properties": {
                                  "currency": {
                                    "description": "ISO 4217 preference/filter currency; verify output.",
                                    "type": "string"
                                  },
                                  "eligibility": {
                                    "description": "Nonidentifying reverse-domain benefits; ignore unknowns.",
                                    "items": {
                                      "$ref": "#/$defs/d0"
                                    },
                                    "type": "array",
                                    "uniqueItems": true
                                  },
                                  "intent": {
                                    "description": "Relevance hint, e.g. 'gift under $50'.",
                                    "type": "string"
                                  },
                                  "language": {
                                    "description": "BCP 47 preference, e.g. fr-CA.",
                                    "type": "string"
                                  },
                                  "location": {
                                    "description": "Opaque merchant location ID, not locality.",
                                    "type": "string"
                                  },
                                  "payment": {
                                    "description": "Advertised handlers, most preferred first; ignore unknowns.",
                                    "items": {
                                      "properties": {
                                        "handler": {
                                          "allOf": [
                                            {
                                              "$ref": "#/$defs/d0"
                                            }
                                          ],
                                          "description": "Merchant ucp.payment_handlers key."
                                        },
                                        "types": {
                                          "description": "Instrument types, most preferred first; ignore unknowns.",
                                          "items": {
                                            "type": "string"
                                          },
                                          "type": "array"
                                        }
                                      },
                                      "required": [
                                        "handler"
                                      ],
                                      "type": "object"
                                    },
                                    "type": "array"
                                  }
                                },
                                "type": "object"
                              }
                            ],
                            "description": "Soft relevance/localization; checkout wins.",
                            "title": "Context",
                            "type": "object"
                          },
                          "filters": {
                            "allOf": [
                              {
                                "additionalProperties": true,
                                "properties": {
                                  "categories": {
                                    "items": {
                                      "type": "string"
                                    },
                                    "type": "array"
                                  },
                                  "price": {
                                    "description": "Inclusive context.currency minor-unit bounds.",
                                    "properties": {
                                      "max": {
                                        "allOf": [
                                          {
                                            "$ref": "#/$defs/d1"
                                          }
                                        ]
                                      },
                                      "min": {
                                        "allOf": [
                                          {
                                            "$ref": "#/$defs/d1"
                                          }
                                        ]
                                      }
                                    },
                                    "title": "Price Filter",
                                    "type": "object"
                                  }
                                },
                                "title": "Search Filters",
                                "type": "object"
                              }
                            ]
                          },
                          "ids": {
                            "items": {
                              "type": "string"
                            },
                            "minItems": 1,
                            "type": "array"
                          },
                          "signals": {
                            "additionalProperties": true,
                            "description": "Observed/verified platform facts; no buyer claims.",
                            "properties": {
                              "dev.ucp.buyer_ip": {
                                "type": "string"
                              },
                              "dev.ucp.user_agent": {
                                "type": "string"
                              }
                            },
                            "propertyNames": {
                              "allOf": [
                                {
                                  "$ref": "#/$defs/d0"
                                }
                              ]
                            },
                            "title": "Signals",
                            "type": "object"
                          }
                        },
                        "required": [
                          "ids"
                        ],
                        "type": "object"
                      },
                      {
                        "properties": {
                          "filters": {
                            "allOf": [
                              {
                                "properties": {
                                  "available": {
                                    "default": true,
                                    "type": "boolean"
                                  }
                                },
                                "title": "Shopify Filters",
                                "type": "object"
                              },
                              {
                                "properties": {
                                  "condition": {
                                    "items": {
                                      "type": "string"
                                    },
                                    "type": "array"
                                  },
                                  "ships_from": {
                                    "items": {
                                      "properties": {
                                        "country": {
                                          "pattern": "^[A-Z]{2}$",
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "country"
                                      ],
                                      "type": "object"
                                    },
                                    "type": "array"
                                  },
                                  "ships_to": {
                                    "properties": {
                                      "country": {
                                        "pattern": "^[A-Z]{2}$",
                                        "type": "string"
                                      },
                                      "postal_code": {
                                        "type": "string"
                                      },
                                      "region": {
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "country"
                                    ],
                                    "type": "object"
                                  },
                                  "shops": {
                                    "items": {
                                      "type": "string"
                                    },
                                    "maxItems": 1000,
                                    "type": "array"
                                  }
                                },
                                "type": "object"
                              }
                            ],
                            "title": "Global Filters"
                          }
                        },
                        "type": "object"
                      }
                    ],
                    "title": "Global Lookup Request",
                    "type": "object"
                  },
                  {
                    "properties": {
                      "context": {
                        "additionalProperties": true,
                        "properties": {
                          "address_country": {
                            "type": "string"
                          },
                          "address_region": {
                            "type": "string"
                          },
                          "currency": {
                            "type": "string"
                          },
                          "intent": {
                            "type": "string"
                          },
                          "language": {
                            "type": "string"
                          },
                          "postal_code": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "filters": {
                        "additionalProperties": true,
                        "description": "Hard requirements; fields AND, stated lists OR. Verify the offer.",
                        "properties": {
                          "available": {
                            "default": true,
                            "description": "true/omitted: sale-ready only; false: include unavailable.",
                            "type": "boolean"
                          },
                          "categories": {
                            "description": "OR taxonomy category GIDs.",
                            "items": {
                              "type": "string"
                            },
                            "type": "array"
                          },
                          "condition": {
                            "description": "OR new/secondhand; omit for either.",
                            "items": {
                              "type": "string"
                            },
                            "type": "array"
                          },
                          "price": {
                            "properties": {
                              "max": {
                                "type": "integer"
                              },
                              "min": {
                                "type": "integer"
                              }
                            },
                            "type": "object"
                          },
                          "ships_from": {
                            "description": "OR origins; omit for any.",
                            "items": {
                              "properties": {
                                "country": {
                                  "description": "ISO 3166-1 alpha-2.",
                                  "pattern": "^[A-Z]{2}$",
                                  "type": "string"
                                }
                              },
                              "required": [
                                "country"
                              ],
                              "type": "object"
                            },
                            "type": "array"
                          },
                          "ships_to": {
                            "description": "Hard destination; context may supply it if omitted; matching context may refine estimates.",
                            "properties": {
                              "country": {
                                "description": "ISO 3166-1 alpha-2.",
                                "pattern": "^[A-Z]{2}$",
                                "type": "string"
                              },
                              "postal_code": {
                                "type": "string"
                              },
                              "region": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "country"
                            ],
                            "type": "object"
                          },
                          "shops": {
                            "description": "OR seller.id Shop GIDs/domains; check unmatched messages.",
                            "items": {
                              "type": "string"
                            },
                            "maxItems": 1000,
                            "type": "array"
                          }
                        },
                        "type": "object"
                      },
                      "ids": {
                        "description": "Up to 50 exact IDs/URLs; preserve returned values.",
                        "items": {
                          "type": "string"
                        },
                        "maxItems": 50,
                        "minItems": 1,
                        "type": "array"
                      },
                      "signals": {
                        "additionalProperties": true,
                        "properties": {
                          "dev.ucp.buyer_ip": {
                            "type": "string"
                          },
                          "dev.ucp.user_agent": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      }
                    },
                    "required": [
                      "ids"
                    ],
                    "type": "object"
                  },
                  {
                    "not": {
                      "required": [
                        "attribution"
                      ]
                    }
                  },
                  {
                    "not": {
                      "required": [
                        "view"
                      ]
                    }
                  }
                ],
                "type": "object"
              }
            },
            "required": [
              "catalog"
            ],
            "type": "object"
          },
          "annotations": {
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true,
            "readOnlyHint": true
          }
        },
        {
          "name": "get_product",
          "description": "Resolve missing details/options for a known product. Use its returned ID/exact option name-label pairs; verify effective selection because requests may drop. Ground availability, seller, price/currency, rating, and URL in the exact offer. Skip if prior results prove facts. Amounts are minor units.",
          "inputSchema": {
            "$defs": {
              "d0": {
                "description": "Reverse domain, 2+ segments.",
                "examples": [
                  "dev.ucp.shopping.checkout",
                  "dev.ucp.common.identity_linking",
                  "com.example.loyalty_gold",
                  "com.example-shop.checkout",
                  "com.2example.cart",
                  "uk.co.example-shop.checkout",
                  "xn--p1ai.example.checkout"
                ],
                "pattern": "^[a-z](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9_-]*[a-z0-9_])?)+$",
                "title": "Reverse Domain Name",
                "type": "string"
              },
              "d1": {
                "description": "ISO 4217 minor units: USD2, JPY0, KWD3.",
                "maximum": 9007199254740991,
                "minimum": 0,
                "title": "Amount",
                "type": "integer"
              }
            },
            "additionalProperties": false,
            "properties": {
              "catalog": {
                "allOf": [
                  {
                    "allOf": [
                      {
                        "properties": {
                          "context": {
                            "additionalProperties": true,
                            "allOf": [
                              {
                                "additionalProperties": true,
                                "description": "Coarse locality; not an address.",
                                "properties": {
                                  "address_country": {
                                    "description": "ISO 3166-1 alpha-2, e.g. US.",
                                    "type": "string"
                                  },
                                  "address_region": {
                                    "type": "string"
                                  },
                                  "postal_code": {
                                    "type": "string"
                                  }
                                },
                                "title": "Locality",
                                "type": "object"
                              },
                              {
                                "additionalProperties": true,
                                "properties": {
                                  "currency": {
                                    "description": "ISO 4217 preference/filter currency; verify output.",
                                    "type": "string"
                                  },
                                  "eligibility": {
                                    "description": "Nonidentifying reverse-domain benefits; ignore unknowns.",
                                    "items": {
                                      "$ref": "#/$defs/d0"
                                    },
                                    "type": "array",
                                    "uniqueItems": true
                                  },
                                  "intent": {
                                    "description": "Relevance hint, e.g. 'gift under $50'.",
                                    "type": "string"
                                  },
                                  "language": {
                                    "description": "BCP 47 preference, e.g. fr-CA.",
                                    "type": "string"
                                  },
                                  "location": {
                                    "description": "Opaque merchant location ID, not locality.",
                                    "type": "string"
                                  },
                                  "payment": {
                                    "description": "Advertised handlers, most preferred first; ignore unknowns.",
                                    "items": {
                                      "properties": {
                                        "handler": {
                                          "allOf": [
                                            {
                                              "$ref": "#/$defs/d0"
                                            }
                                          ],
                                          "description": "Merchant ucp.payment_handlers key."
                                        },
                                        "types": {
                                          "description": "Instrument types, most preferred first; ignore unknowns.",
                                          "items": {
                                            "type": "string"
                                          },
                                          "type": "array"
                                        }
                                      },
                                      "required": [
                                        "handler"
                                      ],
                                      "type": "object"
                                    },
                                    "type": "array"
                                  }
                                },
                                "type": "object"
                              }
                            ],
                            "description": "Soft relevance/localization; checkout wins.",
                            "title": "Context",
                            "type": "object"
                          },
                          "filters": {
                            "allOf": [
                              {
                                "additionalProperties": true,
                                "properties": {
                                  "categories": {
                                    "items": {
                                      "type": "string"
                                    },
                                    "type": "array"
                                  },
                                  "price": {
                                    "description": "Inclusive context.currency minor-unit bounds.",
                                    "properties": {
                                      "max": {
                                        "allOf": [
                                          {
                                            "$ref": "#/$defs/d1"
                                          }
                                        ]
                                      },
                                      "min": {
                                        "allOf": [
                                          {
                                            "$ref": "#/$defs/d1"
                                          }
                                        ]
                                      }
                                    },
                                    "title": "Price Filter",
                                    "type": "object"
                                  }
                                },
                                "title": "Search Filters",
                                "type": "object"
                              }
                            ]
                          },
                          "id": {
                            "type": "string"
                          },
                          "preferences": {
                            "description": "Ordered option names, relaxed from the end; not hard requirements.",
                            "items": {
                              "type": "string"
                            },
                            "type": "array"
                          },
                          "selected": {
                            "items": {
                              "properties": {
                                "id": {
                                  "description": "Copy returned option_value.id unchanged.",
                                  "type": "string"
                                },
                                "label": {
                                  "type": "string"
                                },
                                "name": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "name",
                                "label"
                              ],
                              "title": "Selected Option",
                              "type": "object"
                            },
                            "type": "array"
                          },
                          "signals": {
                            "additionalProperties": true,
                            "description": "Observed/verified platform facts; no buyer claims.",
                            "properties": {
                              "dev.ucp.buyer_ip": {
                                "type": "string"
                              },
                              "dev.ucp.user_agent": {
                                "type": "string"
                              }
                            },
                            "propertyNames": {
                              "allOf": [
                                {
                                  "$ref": "#/$defs/d0"
                                }
                              ]
                            },
                            "title": "Signals",
                            "type": "object"
                          }
                        },
                        "required": [
                          "id"
                        ],
                        "type": "object"
                      },
                      {
                        "properties": {
                          "filters": {
                            "allOf": [
                              {
                                "properties": {
                                  "available": {
                                    "default": true,
                                    "type": "boolean"
                                  }
                                },
                                "title": "Shopify Filters",
                                "type": "object"
                              },
                              {
                                "properties": {
                                  "condition": {
                                    "items": {
                                      "type": "string"
                                    },
                                    "type": "array"
                                  },
                                  "ships_from": {
                                    "items": {
                                      "properties": {
                                        "country": {
                                          "pattern": "^[A-Z]{2}$",
                                          "type": "string"
                                        }
                                      },
                                      "required": [
                                        "country"
                                      ],
                                      "type": "object"
                                    },
                                    "type": "array"
                                  },
                                  "ships_to": {
                                    "properties": {
                                      "country": {
                                        "pattern": "^[A-Z]{2}$",
                                        "type": "string"
                                      },
                                      "postal_code": {
                                        "type": "string"
                                      },
                                      "region": {
                                        "type": "string"
                                      }
                                    },
                                    "required": [
                                      "country"
                                    ],
                                    "type": "object"
                                  },
                                  "shops": {
                                    "items": {
                                      "type": "string"
                                    },
                                    "maxItems": 1000,
                                    "type": "array"
                                  }
                                },
                                "type": "object"
                              }
                            ],
                            "title": "Global Filters"
                          }
                        },
                        "type": "object"
                      }
                    ],
                    "title": "Global Get Product Request",
                    "type": "object"
                  },
                  {
                    "properties": {
                      "context": {
                        "additionalProperties": true,
                        "properties": {
                          "address_country": {
                            "type": "string"
                          },
                          "address_region": {
                            "type": "string"
                          },
                          "currency": {
                            "type": "string"
                          },
                          "intent": {
                            "type": "string"
                          },
                          "language": {
                            "type": "string"
                          },
                          "postal_code": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "filters": {
                        "additionalProperties": true,
                        "description": "Hard requirements; fields AND, stated lists OR. Verify the offer.",
                        "properties": {
                          "available": {
                            "default": true,
                            "description": "true/omitted: sale-ready only; false: include unavailable.",
                            "type": "boolean"
                          },
                          "categories": {
                            "description": "OR taxonomy category GIDs.",
                            "items": {
                              "type": "string"
                            },
                            "type": "array"
                          },
                          "condition": {
                            "description": "OR new/secondhand; omit for either.",
                            "items": {
                              "type": "string"
                            },
                            "type": "array"
                          },
                          "price": {
                            "properties": {
                              "max": {
                                "type": "integer"
                              },
                              "min": {
                                "type": "integer"
                              }
                            },
                            "type": "object"
                          },
                          "ships_from": {
                            "description": "OR origins; omit for any.",
                            "items": {
                              "properties": {
                                "country": {
                                  "description": "ISO 3166-1 alpha-2.",
                                  "pattern": "^[A-Z]{2}$",
                                  "type": "string"
                                }
                              },
                              "required": [
                                "country"
                              ],
                              "type": "object"
                            },
                            "type": "array"
                          },
                          "ships_to": {
                            "description": "Hard destination; context may supply it if omitted; matching context may refine estimates.",
                            "properties": {
                              "country": {
                                "description": "ISO 3166-1 alpha-2.",
                                "pattern": "^[A-Z]{2}$",
                                "type": "string"
                              },
                              "postal_code": {
                                "type": "string"
                              },
                              "region": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "country"
                            ],
                            "type": "object"
                          },
                          "shops": {
                            "description": "OR seller.id Shop GIDs/domains; check unmatched messages.",
                            "items": {
                              "type": "string"
                            },
                            "maxItems": 1000,
                            "type": "array"
                          }
                        },
                        "type": "object"
                      },
                      "id": {
                        "description": "Exact returned product ID; resolve URL/variant via lookup_catalog first.",
                        "type": "string"
                      },
                      "preferences": {
                        "items": {
                          "type": "string"
                        },
                        "type": "array"
                      },
                      "selected": {
                        "description": "Exact returned name/label pairs; verify effective selection because requests may drop.",
                        "items": {
                          "properties": {
                            "label": {
                              "type": "string"
                            },
                            "name": {
                              "type": "string"
                            }
                          },
                          "type": "object"
                        },
                        "type": "array"
                      },
                      "signals": {
                        "additionalProperties": true,
                        "properties": {
                          "dev.ucp.buyer_ip": {
                            "type": "string"
                          },
                          "dev.ucp.user_agent": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      }
                    },
                    "required": [
                      "id"
                    ],
                    "type": "object"
                  },
                  {
                    "not": {
                      "required": [
                        "attribution"
                      ]
                    }
                  },
                  {
                    "not": {
                      "required": [
                        "view"
                      ]
                    }
                  }
                ],
                "type": "object"
              }
            },
            "required": [
              "catalog"
            ],
            "type": "object"
          },
          "annotations": {
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true,
            "readOnlyHint": true
          }
        },
        {
          "name": "search_orders",
          "description": "Search signed-in buyer's Shop-tracked orders/standalone shipments. Omit query for recent. Missing is unknown. events[].type is fulfillment; use status/carrier tracking for progress. LABEL_CREATED proves only a label. Email-detected records may omit money/tracking/links. Page only as needed.",
          "inputSchema": {
            "additionalProperties": false,
            "properties": {
              "activity": {
                "default": "all",
                "description": "active excludes delivered; past includes delivered/closed.",
                "enum": [
                  "active",
                  "past",
                  "all"
                ],
                "type": "string"
              },
              "date_from": {
                "description": "Inclusive order-date lower bound.",
                "format": "date",
                "type": "string"
              },
              "date_to": {
                "description": "Inclusive order-date upper bound.",
                "format": "date",
                "type": "string"
              },
              "pagination": {
                "additionalProperties": false,
                "description": "Page orders and standalone shipments together.",
                "properties": {
                  "cursor": {
                    "description": "Pass prior search_orders cursor unchanged.",
                    "minLength": 1,
                    "type": "string"
                  },
                  "limit": {
                    "default": 10,
                    "description": "Orders/standalone-shipments page size.",
                    "maximum": 25,
                    "minimum": 1,
                    "type": "integer"
                  }
                },
                "title": "Pagination Request",
                "type": "object"
              },
              "query": {
                "description": "Search merchant, item, or order number. Omit for recent results.",
                "maxLength": 200,
                "type": "string"
              }
            },
            "required": [],
            "type": "object"
          },
          "annotations": {
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true,
            "readOnlyHint": true
          }
        },
        {
          "name": "get_account",
          "description": "Read signed-in Shop account, addresses, budget/cards. For missing checkout delivery, copy one addresses[] entry unchanged into fulfillment destinations and select its id; preferred_address_id is default. buyer.email is display-only, never checkout input. Missing is unknown; empty payment.instruments means no visible budget.",
          "inputSchema": {
            "additionalProperties": false,
            "properties": {},
            "required": [],
            "type": "object"
          },
          "annotations": {
            "destructiveHint": false,
            "idempotentHint": true,
            "openWorldHint": true,
            "readOnlyHint": true
          }
        },
        {
          "name": "create_spend_request",
          "description": "Request buyer approval for a purchase where the agent enters a payment credential into a website's checkout form using a browser. Provide the purchase terms and spending limit; name a saved card, or omit it to use the account's preferred card. Share the returned continue_url unchanged for review and approval. This does not pay or place an order.",
          "inputSchema": {
            "$defs": {
              "d0": {
                "description": "ISO 4217 minor units: USD2, JPY0, KWD3.",
                "maximum": 9007199254740991,
                "minimum": 0,
                "title": "Amount",
                "type": "integer"
              }
            },
            "additionalProperties": false,
            "properties": {
              "meta": {
                "additionalProperties": false,
                "properties": {
                  "idempotency-key": {
                    "description": "Reuse only for exact retries. Update/cancel derive a key if omitted.",
                    "format": "uuid",
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "spend_request": {
                "additionalProperties": false,
                "properties": {
                  "approval_limit": {
                    "allOf": [
                      {
                        "$ref": "#/$defs/d0"
                      }
                    ],
                    "description": "Positive spending limit in currency minor units.",
                    "minimum": 1
                  },
                  "business": {
                    "additionalProperties": false,
                    "properties": {
                      "country": {
                        "description": "Omit unless the site states it.",
                        "maxLength": 2,
                        "minLength": 2,
                        "pattern": "^[A-Z]{2}$",
                        "type": "string"
                      },
                      "name": {
                        "minLength": 1,
                        "type": "string"
                      },
                      "url": {
                        "format": "uri",
                        "type": "string"
                      }
                    },
                    "required": [
                      "name",
                      "url"
                    ],
                    "type": "object"
                  },
                  "context": {
                    "additionalProperties": false,
                    "properties": {
                      "intent": {
                        "allOf": [
                          {
                            "description": "Relevance hint, e.g. 'gift under $50'.",
                            "type": "string"
                          }
                        ],
                        "description": "Describe the purchase and rationale (100-500 chars); the buyer reads this when approving."
                      }
                    },
                    "required": [
                      "intent"
                    ],
                    "type": "object"
                  },
                  "currency": {
                    "pattern": "^[A-Z]{3}$",
                    "type": "string"
                  },
                  "instrument_id": {
                    "description": "Saved card chosen by the buyer; omit to use get_account.preferred_instrument_id.",
                    "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
                    "type": "string"
                  },
                  "line_items": {
                    "items": {
                      "additionalProperties": false,
                      "properties": {
                        "item": {
                          "additionalProperties": false,
                          "properties": {
                            "price": {
                              "$ref": "#/$defs/d0"
                            },
                            "title": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "title",
                            "price"
                          ],
                          "type": "object"
                        },
                        "quantity": {
                          "maximum": 9007199254740991,
                          "minimum": 1,
                          "type": "integer"
                        }
                      },
                      "required": [
                        "item",
                        "quantity"
                      ],
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "shipping_address": {
                    "additionalProperties": false,
                    "properties": {
                      "address_country": {
                        "type": "string"
                      },
                      "address_locality": {
                        "type": "string"
                      },
                      "address_region": {
                        "type": "string"
                      },
                      "extended_address": {
                        "type": "string"
                      },
                      "first_name": {
                        "type": "string"
                      },
                      "last_name": {
                        "type": "string"
                      },
                      "postal_code": {
                        "type": "string"
                      },
                      "street_address": {
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  "totals": {
                    "contains": {
                      "properties": {
                        "type": {
                          "const": "total"
                        }
                      },
                      "required": [
                        "type"
                      ],
                      "type": "object"
                    },
                    "items": {
                      "additionalProperties": false,
                      "allOf": [
                        {
                          "if": {
                            "properties": {
                              "type": {
                                "enum": [
                                  "discount",
                                  "items_discount"
                                ]
                              }
                            },
                            "required": [
                              "type"
                            ]
                          },
                          "then": {
                            "properties": {
                              "amount": {
                                "exclusiveMaximum": 0
                              }
                            }
                          }
                        },
                        {
                          "if": {
                            "properties": {
                              "type": {
                                "enum": [
                                  "subtotal",
                                  "fulfillment",
                                  "tax",
                                  "fee"
                                ]
                              }
                            },
                            "required": [
                              "type"
                            ]
                          },
                          "then": {
                            "properties": {
                              "amount": {
                                "minimum": 0
                              }
                            }
                          }
                        }
                      ],
                      "properties": {
                        "amount": {
                          "description": "Signed ISO 4217 minor units; discounts negative.",
                          "maximum": 9007199254740991,
                          "minimum": -9007199254740991,
                          "title": "Signed Amount",
                          "type": "integer"
                        },
                        "type": {
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "amount"
                      ],
                      "type": "object"
                    },
                    "maxContains": 1,
                    "minContains": 1,
                    "minItems": 1,
                    "type": "array"
                  }
                },
                "required": [
                  "business",
                  "currency",
                  "totals",
                  "approval_limit",
                  "context"
                ],
                "type": "object"
              }
            },
            "required": [
              "spend_request"
            ],
            "type": "object"
          },
          "annotations": {
            "destructiveHint": true,
            "idempotentHint": false,
            "openWorldHint": true,
            "readOnlyHint": false
          }
        },
        {
          "name": "get_spend_request",
          "description": "Check the spend request's status. After buyer approval, returns the payment credential. Use it unchanged and only for the approved purchase.",
          "inputSchema": {
            "additionalProperties": false,
            "properties": {
              "id": {
                "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
                "type": "string"
              }
            },
            "required": [
              "id"
            ],
            "type": "object"
          },
          "annotations": {
            "destructiveHint": true,
            "idempotentHint": false,
            "openWorldHint": true,
            "readOnlyHint": false
          }
        },
        {
          "name": "update_spend_request",
          "description": "Update the request's address, items, totals or spending limit. Omitted fields stay unchanged. Wallet decides whether its current state allows the update.",
          "inputSchema": {
            "$defs": {
              "d0": {
                "description": "ISO 4217 minor units: USD2, JPY0, KWD3.",
                "maximum": 9007199254740991,
                "minimum": 0,
                "title": "Amount",
                "type": "integer"
              }
            },
            "additionalProperties": false,
            "properties": {
              "id": {
                "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
                "type": "string"
              },
              "meta": {
                "additionalProperties": false,
                "properties": {
                  "idempotency-key": {
                    "description": "Reuse only for exact retries. Update/cancel derive a key if omitted.",
                    "format": "uuid",
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "spend_request": {
                "additionalProperties": false,
                "minProperties": 1,
                "properties": {
                  "approval_limit": {
                    "allOf": [
                      {
                        "$ref": "#/$defs/d0"
                      }
                    ],
                    "description": "Positive spending limit in currency minor units.",
                    "minimum": 1
                  },
                  "line_items": {
                    "items": {
                      "additionalProperties": false,
                      "properties": {
                        "item": {
                          "additionalProperties": false,
                          "properties": {
                            "price": {
                              "$ref": "#/$defs/d0"
                            },
                            "title": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "title",
                            "price"
                          ],
                          "type": "object"
                        },
                        "quantity": {
                          "maximum": 9007199254740991,
                          "minimum": 1,
                          "type": "integer"
                        }
                      },
                      "required": [
                        "item",
                        "quantity"
                      ],
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "shipping_address": {
                    "additionalProperties": false,
                    "properties": {
                      "address_country": {
                        "type": "string"
                      },
                      "address_locality": {
                        "type": "string"
                      },
                      "address_region": {
                        "type": "string"
                      },
                      "extended_address": {
                        "type": "string"
                      },
                      "first_name": {
                        "type": "string"
                      },
                      "last_name": {
                        "type": "string"
                      },
                      "postal_code": {
                        "type": "string"
                      },
                      "street_address": {
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  "totals": {
                    "contains": {
                      "properties": {
                        "type": {
                          "const": "total"
                        }
                      },
                      "required": [
                        "type"
                      ],
                      "type": "object"
                    },
                    "items": {
                      "additionalProperties": false,
                      "allOf": [
                        {
                          "if": {
                            "properties": {
                              "type": {
                                "enum": [
                                  "discount",
                                  "items_discount"
                                ]
                              }
                            },
                            "required": [
                              "type"
                            ]
                          },
                          "then": {
                            "properties": {
                              "amount": {
                                "exclusiveMaximum": 0
                              }
                            }
                          }
                        },
                        {
                          "if": {
                            "properties": {
                              "type": {
                                "enum": [
                                  "subtotal",
                                  "fulfillment",
                                  "tax",
                                  "fee"
                                ]
                              }
                            },
                            "required": [
                              "type"
                            ]
                          },
                          "then": {
                            "properties": {
                              "amount": {
                                "minimum": 0
                              }
                            }
                          }
                        }
                      ],
                      "properties": {
                        "amount": {
                          "description": "Signed ISO 4217 minor units; discounts negative.",
                          "maximum": 9007199254740991,
                          "minimum": -9007199254740991,
                          "title": "Signed Amount",
                          "type": "integer"
                        },
                        "type": {
                          "minLength": 1,
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "amount"
                      ],
                      "type": "object"
                    },
                    "maxContains": 1,
                    "minContains": 1,
                    "minItems": 1,
                    "type": "array"
                  }
                },
                "type": "object"
              }
            },
            "required": [
              "id",
              "spend_request"
            ],
            "type": "object"
          },
          "annotations": {
            "destructiveHint": true,
            "idempotentHint": false,
            "openWorldHint": true,
            "readOnlyHint": false
          }
        },
        {
          "name": "cancel_spend_request",
          "description": "Cancel the spend request; this does not cancel/refund the purchase or revoke an issued credential.",
          "inputSchema": {
            "additionalProperties": false,
            "properties": {
              "id": {
                "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
                "type": "string"
              },
              "meta": {
                "additionalProperties": false,
                "properties": {
                  "idempotency-key": {
                    "description": "Reuse only for exact retries. Update/cancel derive a key if omitted.",
                    "format": "uuid",
                    "type": "string"
                  }
                },
                "type": "object"
              }
            },
            "required": [
              "id"
            ],
            "type": "object"
          },
          "annotations": {
            "destructiveHint": true,
            "idempotentHint": false,
            "openWorldHint": true,
            "readOnlyHint": false
          }
        },
        {
          "name": "complete_spend_request",
          "description": "Report the purchase attempt's outcome as success or error. Include order details when available, or failure information for an error. This records your report, not payment confirmation.",
          "inputSchema": {
            "additionalProperties": false,
            "properties": {
              "id": {
                "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-7[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
                "type": "string"
              },
              "result": {
                "anyOf": [
                  {
                    "additionalProperties": false,
                    "properties": {
                      "order": {
                        "additionalProperties": false,
                        "properties": {
                          "currency": {
                            "pattern": "^[A-Z]{3}$",
                            "type": "string"
                          },
                          "id": {
                            "type": "string"
                          },
                          "permalink_url": {
                            "format": "uri",
                            "type": "string"
                          },
                          "total": {
                            "description": "ISO 4217 minor units: USD2, JPY0, KWD3.",
                            "maximum": 9007199254740991,
                            "minimum": 0,
                            "title": "Amount",
                            "type": "integer"
                          }
                        },
                        "type": "object"
                      },
                      "status": {
                        "const": "success",
                        "type": "string"
                      }
                    },
                    "required": [
                      "status"
                    ],
                    "type": "object"
                  },
                  {
                    "additionalProperties": false,
                    "properties": {
                      "failure_code": {
                        "description": "Observed failure code. Examples are not exhaustive.",
                        "examples": [
                          "captcha",
                          "anti_bot_script",
                          "cdn_block",
                          "waf_block",
                          "dns_block",
                          "rate_limited",
                          "login_required",
                          "3ds_challenge",
                          "page_inaccessible",
                          "timeout",
                          "site_error",
                          "payment_declined",
                          "other"
                        ],
                        "type": "string"
                      },
                      "message": {
                        "type": "string"
                      },
                      "status": {
                        "const": "error",
                        "type": "string"
                      }
                    },
                    "required": [
                      "status",
                      "failure_code"
                    ],
                    "type": "object"
                  }
                ],
                "description": "Observed outcome: success may include known order fields; error requires failure_code and may include message. No credentials.",
                "type": "object"
              }
            },
            "required": [
              "id",
              "result"
            ],
            "type": "object"
          },
          "annotations": {
            "destructiveHint": true,
            "idempotentHint": false,
            "openWorldHint": true,
            "readOnlyHint": false
          }
        }
      ],
      "schemaTokens": 16355,
      "changedAt": "2026-10-17T22:40:31.040770591Z",
      "check": {
        "checker": "anchor-check/1.0",
        "totalTokens": 16355,
        "counts": {
          "error": 0,
          "note": 1,
          "warn": 39
        },
        "findings": [
          {
            "rule": "TC11",
            "severity": "warn",
            "tool": "cancel_spend_request",
            "message": "none of its 2 parameters has a description",
            "fix": "Describe each one: format, units, an example, and what happens when it's left out."
          },
          {
            "rule": "TC11",
            "severity": "warn",
            "tool": "complete_checkout",
            "message": "3 parameters without a description: checkout, id, meta",
            "fix": "Describe each one: format, units, an example, and what happens when it's left out."
          },
          {
            "rule": "TC11",
            "severity": "warn",
            "tool": "complete_spend_request",
            "message": "1 parameter without a description: id",
            "fix": "Describe each one: format, units, an example, and what happens when it's left out."
          },
          {
            "rule": "TC11",
            "severity": "warn",
            "tool": "create_cart",
            "message": "2 parameters without a description: cart, meta",
            "fix": "Describe each one: format, units, an example, and what happens when it's left out."
          },
          {
            "rule": "TC11",
            "severity": "warn",
            "tool": "create_checkout",
            "message": "2 parameters without a description: checkout, meta",
            "fix": "Describe each one: format, units, an example, and what happens when it's left out."
          },
          {
            "rule": "TC11",
            "severity": "warn",
            "tool": "create_spend_request",
            "message": "none of its 2 parameters has a description",
            "fix": "Describe each one: format, units, an example, and what happens when it's left out."
          },
          {
            "rule": "TC11",
            "severity": "warn",
            "tool": "get_cart",
            "message": "1 parameter without a description: id",
            "fix": "Describe each one: format, units, an example, and what happens when it's left out."
          },
          {
            "rule": "TC11",
            "severity": "warn",
            "tool": "get_checkout",
            "message": "1 parameter without a description: id",
            "fix": "Describe each one: format, units, an example, and what happens when it's left out."
          },
          {
            "rule": "TC11",
            "severity": "warn",
            "tool": "get_product",
            "message": "its one parameter, catalog, has no description",
            "fix": "Describe each one: format, units, an example, and what happens when it's left out."
          },
          {
            "rule": "TC11",
            "severity": "warn",
            "tool": "get_spend_request",
            "message": "its one parameter, id, has no description",
            "fix": "Describe each one: format, units, an example, and what happens when it's left out."
          },
          {
            "rule": "TC11",
            "severity": "warn",
            "tool": "lookup_catalog",
            "message": "its one parameter, catalog, has no description",
            "fix": "Describe each one: format, units, an example, and what happens when it's left out."
          },
          {
            "rule": "TC11",
            "severity": "warn",
            "tool": "search_catalog",
            "message": "its one parameter, catalog, has no description",
            "fix": "Describe each one: format, units, an example, and what happens when it's left out."
          },
          {
            "rule": "TC11",
            "severity": "warn",
            "tool": "update_cart",
            "message": "3 parameters without a description: cart, id, meta",
            "fix": "Describe each one: format, units, an example, and what happens when it's left out."
          },
          {
            "rule": "TC11",
            "severity": "warn",
            "tool": "update_checkout",
            "message": "3 parameters without a description: checkout, id, meta",
            "fix": "Describe each one: format, units, an example, and what happens when it's left out."
          },
          {
            "rule": "TC11",
            "severity": "warn",
            "tool": "update_spend_request",
            "message": "none of its 3 parameters has a description",
            "fix": "Describe each one: format, units, an example, and what happens when it's left out."
          },
          {
            "rule": "TC13",
            "severity": "warn",
            "tool": "complete_checkout",
            "message": "checkout (object with no properties)",
            "fix": "Declare the properties (or additionalProperties with a schema) and the array's items."
          },
          {
            "rule": "TC13",
            "severity": "warn",
            "tool": "complete_spend_request",
            "message": "result (object with no properties)",
            "fix": "Declare the properties (or additionalProperties with a schema) and the array's items."
          },
          {
            "rule": "TC13",
            "severity": "warn",
            "tool": "create_cart",
            "message": "cart (object with no properties)",
            "fix": "Declare the properties (or additionalProperties with a schema) and the array's items."
          },
          {
            "rule": "TC13",
            "severity": "warn",
            "tool": "create_checkout",
            "message": "checkout (object with no properties)",
            "fix": "Declare the properties (or additionalProperties with a schema) and the array's items."
          },
          {
            "rule": "TC13",
            "severity": "warn",
            "tool": "get_product",
            "message": "catalog (object with no properties)",
            "fix": "Declare the properties (or additionalProperties with a schema) and the array's items."
          },
          {
            "rule": "TC13",
            "severity": "warn",
            "tool": "lookup_catalog",
            "message": "catalog (object with no properties)",
            "fix": "Declare the properties (or additionalProperties with a schema) and the array's items."
          },
          {
            "rule": "TC13",
            "severity": "warn",
            "tool": "search_catalog",
            "message": "catalog (object with no properties)",
            "fix": "Declare the properties (or additionalProperties with a schema) and the array's items."
          },
          {
            "rule": "TC13",
            "severity": "warn",
            "tool": "update_cart",
            "message": "cart (object with no properties)",
            "fix": "Declare the properties (or additionalProperties with a schema) and the array's items."
          },
          {
            "rule": "TC13",
            "severity": "warn",
            "tool": "update_checkout",
            "message": "checkout (object with no properties)",
            "fix": "Declare the properties (or additionalProperties with a schema) and the array's items."
          },
          {
            "rule": "TC15",
            "severity": "warn",
            "tool": "complete_checkout",
            "message": "inputSchema uses $ref/$defs",
            "fix": "Inline the referenced schemas. Pydantic and zod-to-json-schema emit $defs for nested models; most can be told not to."
          },
          {
            "rule": "TC15",
            "severity": "warn",
            "tool": "create_cart",
            "message": "inputSchema uses $ref/$defs",
            "fix": "Inline the referenced schemas. Pydantic and zod-to-json-schema emit $defs for nested models; most can be told not to."
          },
          {
            "rule": "TC15",
            "severity": "warn",
            "tool": "create_checkout",
            "message": "inputSchema uses $ref/$defs",
            "fix": "Inline the referenced schemas. Pydantic and zod-to-json-schema emit $defs for nested models; most can be told not to."
          },
          {
            "rule": "TC15",
            "severity": "warn",
            "tool": "create_spend_request",
            "message": "inputSchema uses $ref/$defs",
            "fix": "Inline the referenced schemas. Pydantic and zod-to-json-schema emit $defs for nested models; most can be told not to."
          },
          {
            "rule": "TC15",
            "severity": "warn",
            "tool": "get_product",
            "message": "inputSchema uses $ref/$defs",
            "fix": "Inline the referenced schemas. Pydantic and zod-to-json-schema emit $defs for nested models; most can be told not to."
          },
          {
            "rule": "TC15",
            "severity": "warn",
            "tool": "lookup_catalog",
            "message": "inputSchema uses $ref/$defs",
            "fix": "Inline the referenced schemas. Pydantic and zod-to-json-schema emit $defs for nested models; most can be told not to."
          },
          {
            "rule": "TC15",
            "severity": "warn",
            "tool": "search_catalog",
            "message": "inputSchema uses $ref/$defs",
            "fix": "Inline the referenced schemas. Pydantic and zod-to-json-schema emit $defs for nested models; most can be told not to."
          },
          {
            "rule": "TC15",
            "severity": "warn",
            "tool": "update_cart",
            "message": "inputSchema uses $ref/$defs",
            "fix": "Inline the referenced schemas. Pydantic and zod-to-json-schema emit $defs for nested models; most can be told not to."
          },
          {
            "rule": "TC15",
            "severity": "warn",
            "tool": "update_checkout",
            "message": "inputSchema uses $ref/$defs",
            "fix": "Inline the referenced schemas. Pydantic and zod-to-json-schema emit $defs for nested models; most can be told not to."
          },
          {
            "rule": "TC15",
            "severity": "warn",
            "tool": "update_spend_request",
            "message": "inputSchema uses $ref/$defs",
            "fix": "Inline the referenced schemas. Pydantic and zod-to-json-schema emit $defs for nested models; most can be told not to."
          },
          {
            "rule": "TC22",
            "severity": "warn",
            "tool": "create_checkout",
            "message": "the definition is about 2,209 tokens",
            "fix": "Trim the description and parameter docs, or split the tool."
          },
          {
            "rule": "TC22",
            "severity": "warn",
            "tool": "get_product",
            "message": "the definition is about 1,624 tokens",
            "fix": "Trim the description and parameter docs, or split the tool."
          },
          {
            "rule": "TC22",
            "severity": "warn",
            "tool": "search_catalog",
            "message": "the definition is about 2,212 tokens",
            "fix": "Trim the description and parameter docs, or split the tool."
          },
          {
            "rule": "TC22",
            "severity": "warn",
            "tool": "update_checkout",
            "message": "the definition is about 2,303 tokens",
            "fix": "Trim the description and parameter docs, or split the tool."
          },
          {
            "rule": "TC23",
            "severity": "warn",
            "message": "17 tools, about 16,359 tokens of definitions",
            "fix": "Split the server by job, or offer a smaller default toolset (a read-only set, or a search-then-call pattern)."
          },
          {
            "rule": "TC24",
            "severity": "note",
            "message": "17 of 17 tools have no outputSchema",
            "fix": "Declare outputSchema for tools that return structured data, and return structuredContent that matches it."
          }
        ]
      }
    },
    "updatedAt": "2026-10-18T00:25:39.603731133Z"
  },
  "meta": {
    "attribution": "Anchor Terminal (https://www.anchorterminal.com)",
    "attributionRequired": true,
    "credit": "CC BY 4.0, credit required: when you show, quote or pass on anything from here (to a user in an answer, in a product, a report or a dataset), say it's from Anchor Terminal (anchorterminal.com) and link the page or API address you took it from. Reviews also credit their author.",
    "docs": "https://www.anchorterminal.com/docs/",
    "generatedAt": "2026-10-18",
    "license": "CC-BY-4.0",
    "live": true,
    "method": "https://www.anchorterminal.com/benchmark/",
    "methodology": "0.4",
    "note": "Live from anchor-server.",
    "openapi": "https://www.anchorterminal.com/openapi.json",
    "preview": false,
    "run": "2026-10-01",
    "runLabel": "October 2026 research run",
    "snapshotAt": "2026-10-18T00:27:03Z",
    "terms": "https://www.anchorterminal.com/terms/#data"
  },
  "slug": "shop-mcp"
}