{
  "openapi": "3.1.0",
  "jsonSchemaDialect": "https://spec.openapis.org/oas/3.1/dialect/base",
  "info": {
    "title": "ECO SHADES Storefront API",
    "version": "2026-11-17",
    "summary": "Public, read-only product catalog and agentic-commerce endpoints of the ECO SHADES online store (eco-shades.com).",
    "description": "ECO SHADES is a Danish sunglasses brand. This document describes the public endpoints of the ECO SHADES online store, which runs on Shopify. No API key is needed for any operation listed here.\n\n**What you can do**\n- Read the product catalog, collections and product details as JSON (listProducts, getProduct, getProductPrices, listCollections, listCollectionProducts).\n- Search products, collections, articles and pages (searchStore).\n- Query the Storefront GraphQL API without a token (queryStorefrontGraphql).\n- Discover and call the store's Model Context Protocol servers for catalog search, carts and buyer-authorized checkout (getUcpProfile, callCommerceMcp, callStoreMcp).\n\n**Carts and checkout**: use the UCP/MCP endpoint (`/api/ucp/mcp`). Agents must not script the browser cart or checkout forms. Orders may only be placed with the buyer's explicit authorization; follow the review and handoff steps the MCP tools return.\n\n**Agent identification and rate limits**: identify agent-initiated traffic (see https://www.eco-shades.com/agents.md). On HTTP 429, back off and respect `Retry-After` when present. Storefront GraphQL responses report query cost in `extensions.cost`.\n\n**Prices** in the REST `.json` endpoints are decimal strings in the store's default currency (DKK); `getProductPrices` returns integers in minor units. MCP tools return integers in ISO 4217 minor units with a currency code. Always use the price returned by the API, never a cached value.",
    "contact": {
      "name": "ECO SHADES",
      "url": "https://www.eco-shades.com/pages/contact-us"
    },
    "termsOfService": "https://www.eco-shades.com/policies/terms-of-service",
    "x-agent-instructions": "https://www.eco-shades.com/agents.md"
  },
  "externalDocs": {
    "description": "ECO SHADES API documentation",
    "url": "https://www.eco-shades.com/pages/api"
  },
  "servers": [
    {
      "url": "https://www.eco-shades.com",
      "description": "ECO SHADES online store (production)"
    }
  ],
  "security": [
    {}
  ],
  "tags": [
    {
      "name": "Catalog",
      "description": "Read-only product and collection data."
    },
    {
      "name": "Search",
      "description": "Predictive search across products, collections, articles and pages."
    },
    {
      "name": "GraphQL",
      "description": "Shopify Storefront GraphQL API, tokenless access."
    },
    {
      "name": "Agentic commerce",
      "description": "Universal Commerce Protocol (UCP) discovery and Model Context Protocol (MCP) servers for catalog search, carts and checkout."
    }
  ],
  "paths": {
    "/products.json": {
      "get": {
        "operationId": "listProducts",
        "tags": [
          "Catalog"
        ],
        "summary": "List published products",
        "description": "Returns published products with variants, images and options, newest first. Paginate with `page` until an empty `products` array is returned. Use this for a full catalog sync; use searchStore to find products by keyword.",
        "parameters": [
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/page"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of products.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductList"
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "5XX": {
            "$ref": "#/components/responses/ServerError"
          }
        }
      }
    },
    "/products/{handle}.json": {
      "get": {
        "operationId": "getProduct",
        "tags": [
          "Catalog"
        ],
        "summary": "Get one product by handle",
        "description": "Returns one published product, including all variants (with SKU, availability-independent price, weight) and images. Returns 404 if the handle does not exist or the product is not published.",
        "parameters": [
          {
            "name": "handle",
            "in": "path",
            "required": true,
            "description": "Product handle (URL slug), e.g. `grosso-black-red`. Find handles via listProducts or searchStore.",
            "schema": {
              "type": "string",
              "pattern": "^[a-z0-9][a-z0-9-]*$"
            },
            "example": "grosso-black-red"
          }
        ],
        "responses": {
          "200": {
            "description": "The product.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "product"
                  ],
                  "properties": {
                    "product": {
                      "$ref": "#/components/schemas/Product"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "5XX": {
            "$ref": "#/components/responses/ServerError"
          }
        }
      }
    },
    "/products/{handle}.js": {
      "get": {
        "operationId": "getProductPrices",
        "tags": [
          "Catalog"
        ],
        "summary": "Get a product with live availability and minor-unit prices",
        "description": "Returns one product as served to the storefront: prices as integers in minor units of the storefront currency (e.g. 19900 = 199.00), live `available` flags per variant, and product URL. Use this to check whether a variant can be bought right now.",
        "parameters": [
          {
            "name": "handle",
            "in": "path",
            "required": true,
            "description": "Product handle (URL slug), e.g. `grosso-black-red`. Find handles via listProducts or searchStore.",
            "schema": {
              "type": "string",
              "pattern": "^[a-z0-9][a-z0-9-]*$"
            },
            "example": "grosso-black-red"
          }
        ],
        "responses": {
          "200": {
            "description": "The product (JSON body; served with a JavaScript content type).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StorefrontProduct"
                }
              },
              "text/javascript": {
                "schema": {
                  "$ref": "#/components/schemas/StorefrontProduct"
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "5XX": {
            "$ref": "#/components/responses/ServerError"
          }
        }
      }
    },
    "/collections.json": {
      "get": {
        "operationId": "listCollections",
        "tags": [
          "Catalog"
        ],
        "summary": "List published collections",
        "description": "Returns the store's published collections (e.g. colour or frame-material groupings) with handle, title, description and product count.",
        "parameters": [
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/page"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of collections.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "collections"
                  ],
                  "properties": {
                    "collections": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Collection"
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "5XX": {
            "$ref": "#/components/responses/ServerError"
          }
        }
      }
    },
    "/collections/{handle}/products.json": {
      "get": {
        "operationId": "listCollectionProducts",
        "tags": [
          "Catalog"
        ],
        "summary": "List products in a collection",
        "description": "Returns published products in one collection, same shape as listProducts. An unknown collection handle returns an empty `products` array.",
        "parameters": [
          {
            "name": "handle",
            "in": "path",
            "required": true,
            "description": "Collection handle (URL slug). Use `all` for every published product. Find handles via listCollections.",
            "schema": {
              "type": "string",
              "pattern": "^[a-z0-9][a-z0-9-]*$"
            },
            "example": "all"
          },
          {
            "$ref": "#/components/parameters/limit"
          },
          {
            "$ref": "#/components/parameters/page"
          }
        ],
        "responses": {
          "200": {
            "description": "A page of products in the collection.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductList"
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "5XX": {
            "$ref": "#/components/responses/ServerError"
          }
        }
      }
    },
    "/search/suggest.json": {
      "get": {
        "operationId": "searchStore",
        "tags": [
          "Search"
        ],
        "summary": "Search products, collections, articles and pages",
        "description": "Predictive keyword search. Returns matching products (with price and availability), collections, blog articles and pages. Use short keyword queries such as a style name or colour.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Search terms, e.g. `black round`.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            },
            "example": "black"
          },
          {
            "name": "resources[type]",
            "in": "query",
            "required": false,
            "description": "Comma-separated resource types to return.",
            "schema": {
              "type": "string",
              "default": "product,collection,article,page",
              "pattern": "^(product|collection|article|page|query)(,(product|collection|article|page|query))*$"
            },
            "example": "product"
          },
          {
            "name": "resources[limit]",
            "in": "query",
            "required": false,
            "description": "Maximum results per resource type.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 10,
              "default": 10
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Search results grouped by resource type.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchSuggestResponse"
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "5XX": {
            "$ref": "#/components/responses/ServerError"
          }
        }
      }
    },
    "/.well-known/ucp": {
      "get": {
        "operationId": "getUcpProfile",
        "tags": [
          "Agentic commerce"
        ],
        "summary": "Get the store's Universal Commerce Protocol profile",
        "description": "Returns the UCP discovery profile: supported UCP versions, service endpoints (the MCP endpoint for shopping), capabilities (catalog search and lookup, cart, checkout, order, fulfillment) and payment handlers. Call this first when integrating checkout.",
        "responses": {
          "200": {
            "description": "UCP profile.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UcpProfile"
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "5XX": {
            "$ref": "#/components/responses/ServerError"
          }
        }
      }
    },
    "/api/ucp/mcp": {
      "post": {
        "operationId": "callCommerceMcp",
        "tags": [
          "Agentic commerce"
        ],
        "summary": "Call the commerce MCP server (catalog, cart, checkout, orders)",
        "description": "Model Context Protocol server (Streamable HTTP, JSON-RPC 2.0) implementing the Universal Commerce Protocol. Send `initialize`, then `tools/list` to get the live tool schemas, then `tools/call`. Tools include search_catalog, lookup_catalog, get_product, create_cart, get_cart, update_cart, cancel_cart, create_checkout, get_checkout, update_checkout, complete_checkout, cancel_checkout, get_order and ask_business. No authentication is required to connect. complete_checkout must only be called with the buyer's explicit authorization.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/JsonRpcRequest"
              },
              "examples": {
                "listTools": {
                  "summary": "List tools",
                  "value": {
                    "jsonrpc": "2.0",
                    "id": 1,
                    "method": "tools/list",
                    "params": {}
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "JSON-RPC response (result or error).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonRpcResponse"
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "5XX": {
            "$ref": "#/components/responses/ServerError"
          }
        }
      }
    },
    "/api/mcp": {
      "post": {
        "operationId": "callStoreMcp",
        "tags": [
          "Agentic commerce"
        ],
        "summary": "Call the store-information MCP server (policies and FAQs)",
        "description": "Model Context Protocol server (Streamable HTTP, JSON-RPC 2.0) that answers questions about store policies, shipping, returns and FAQs via the `search_shop_policies_and_faqs` tool. Send `initialize`, `tools/list`, then `tools/call`. No authentication required.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/JsonRpcRequest"
              },
              "examples": {
                "askPolicy": {
                  "summary": "Ask about returns",
                  "value": {
                    "jsonrpc": "2.0",
                    "id": 2,
                    "method": "tools/call",
                    "params": {
                      "name": "search_shop_policies_and_faqs",
                      "arguments": {
                        "query": "What is your return policy?"
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "JSON-RPC response (result or error).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JsonRpcResponse"
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "5XX": {
            "$ref": "#/components/responses/ServerError"
          }
        }
      }
    },
    "/api/2026-10/graphql.json": {
      "post": {
        "operationId": "queryStorefrontGraphql",
        "tags": [
          "GraphQL"
        ],
        "summary": "Query the Storefront GraphQL API (no token)",
        "description": "Shopify Storefront GraphQL API, version 2026-10, with tokenless access for public catalog data (products, collections, variants, prices, availability). Every response includes `extensions.cost.requestedQueryCost`; keep queries small and paginate with Relay cursors (`first`, `after`, `pageInfo`). Schema reference: https://shopify.dev/docs/api/storefront/2026-10.",
        "externalDocs": {
          "url": "https://shopify.dev/docs/api/storefront/2026-10"
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GraphqlRequest"
              },
              "examples": {
                "products": {
                  "summary": "First 5 products",
                  "value": {
                    "query": "{ products(first: 5) { nodes { handle title availableForSale priceRange { minVariantPrice { amount currencyCode } } } pageInfo { hasNextPage endCursor } } }"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "GraphQL response. Query errors are returned in `errors` with HTTP 200.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GraphqlResponse"
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "5XX": {
            "$ref": "#/components/responses/ServerError"
          }
        }
      }
    }
  },
  "components": {
    "parameters": {
      "limit": {
        "name": "limit",
        "in": "query",
        "required": false,
        "description": "Items per page (max 250).",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "maximum": 250,
          "default": 30
        }
      },
      "page": {
        "name": "page",
        "in": "query",
        "required": false,
        "description": "1-based page number. Stop when the returned array is empty.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "default": 1
        }
      }
    },
    "responses": {
      "NotFound": {
        "description": "The resource does not exist or is not published. Body may be empty.",
        "content": {
          "text/html": {
            "schema": {
              "type": "string"
            }
          }
        }
      },
      "TooManyRequests": {
        "description": "Rate limited. Wait for `Retry-After` seconds (if present) before retrying, with exponential backoff.",
        "headers": {
          "Retry-After": {
            "description": "Seconds to wait before retrying.",
            "schema": {
              "type": "integer"
            }
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          },
          "text/html": {
            "schema": {
              "type": "string"
            }
          }
        }
      },
      "ServerError": {
        "description": "Temporary server error. Retry with exponential backoff.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          },
          "text/html": {
            "schema": {
              "type": "string"
            }
          }
        }
      }
    },
    "schemas": {
      "Error": {
        "type": "object",
        "description": "Error body. Shape may vary; `errors` holds a message or list of messages.",
        "properties": {
          "errors": {
            "description": "Error message(s).",
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "message"
                  ]
                }
              }
            ]
          }
        }
      },
      "ProductList": {
        "type": "object",
        "required": [
          "products"
        ],
        "properties": {
          "products": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Product"
            },
            "description": "Products on this page. Empty when past the last page."
          }
        }
      },
      "Product": {
        "type": "object",
        "description": "A published product (one frame style in one colourway).",
        "required": [
          "id",
          "title",
          "handle",
          "variants"
        ],
        "properties": {
          "id": {
            "type": "integer",
            "description": "Product ID."
          },
          "title": {
            "type": "string",
            "description": "Product name, e.g. `Grosso Black Red`."
          },
          "handle": {
            "type": "string",
            "description": "URL slug; product page is /products/{handle}."
          },
          "body_html": {
            "type": [
              "string",
              "null"
            ],
            "description": "Product description as HTML."
          },
          "vendor": {
            "type": "string"
          },
          "product_type": {
            "type": "string"
          },
          "tags": {
            "description": "Tags (array in list responses, comma-separated string in getProduct).",
            "oneOf": [
              {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              {
                "type": "string"
              }
            ]
          },
          "published_at": {
            "type": "string",
            "format": "date-time"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "variants": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Variant"
            }
          },
          "images": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Image"
            }
          },
          "options": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProductOption"
            }
          }
        }
      },
      "Variant": {
        "type": "object",
        "required": [
          "id",
          "price"
        ],
        "properties": {
          "id": {
            "type": "integer",
            "description": "Variant ID (use as merchandise ID in carts: gid://shopify/ProductVariant/{id})."
          },
          "title": {
            "type": "string"
          },
          "sku": {
            "type": [
              "string",
              "null"
            ],
            "description": "Item number."
          },
          "price": {
            "type": "string",
            "pattern": "^[0-9]+\\.[0-9]{2}$",
            "description": "Price as a decimal string in the store's default currency."
          },
          "compare_at_price": {
            "type": [
              "string",
              "null"
            ]
          },
          "available": {
            "type": "boolean",
            "description": "Whether the variant can currently be purchased (present in list responses)."
          },
          "grams": {
            "type": "integer",
            "description": "Shipping weight in grams."
          },
          "requires_shipping": {
            "type": "boolean"
          },
          "option1": {
            "type": [
              "string",
              "null"
            ]
          },
          "option2": {
            "type": [
              "string",
              "null"
            ]
          },
          "option3": {
            "type": [
              "string",
              "null"
            ]
          },
          "product_id": {
            "type": "integer"
          },
          "position": {
            "type": "integer"
          }
        }
      },
      "Image": {
        "type": "object",
        "required": [
          "src"
        ],
        "properties": {
          "id": {
            "type": "integer"
          },
          "src": {
            "type": "string",
            "format": "uri"
          },
          "width": {
            "type": "integer"
          },
          "height": {
            "type": "integer"
          },
          "position": {
            "type": "integer"
          },
          "variant_ids": {
            "type": "array",
            "items": {
              "type": "integer"
            }
          }
        }
      },
      "ProductOption": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "position": {
            "type": "integer"
          },
          "values": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "StorefrontProduct": {
        "type": "object",
        "required": [
          "id",
          "handle",
          "title",
          "available",
          "price",
          "variants"
        ],
        "properties": {
          "id": {
            "type": "integer"
          },
          "handle": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "description": {
            "type": "string",
            "description": "Description HTML."
          },
          "url": {
            "type": "string",
            "description": "Relative product URL."
          },
          "available": {
            "type": "boolean",
            "description": "True if any variant can be purchased now."
          },
          "price": {
            "type": "integer",
            "description": "Lowest variant price in minor units (e.g. 19900 = 199.00)."
          },
          "price_min": {
            "type": "integer"
          },
          "price_max": {
            "type": "integer"
          },
          "featured_image": {
            "type": [
              "string",
              "null"
            ]
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "variants": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "id",
                "available",
                "price"
              ],
              "properties": {
                "id": {
                  "type": "integer"
                },
                "title": {
                  "type": "string"
                },
                "sku": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "barcode": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "available": {
                  "type": "boolean"
                },
                "price": {
                  "type": "integer",
                  "description": "Minor units."
                },
                "weight": {
                  "type": "integer",
                  "description": "Grams."
                }
              }
            }
          }
        }
      },
      "Collection": {
        "type": "object",
        "required": [
          "id",
          "handle",
          "title"
        ],
        "properties": {
          "id": {
            "type": "integer"
          },
          "handle": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "HTML description."
          },
          "products_count": {
            "type": "integer"
          },
          "published_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "image": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "src": {
                "type": "string",
                "format": "uri"
              },
              "alt": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "width": {
                "type": "integer"
              },
              "height": {
                "type": "integer"
              }
            }
          }
        }
      },
      "SearchSuggestResponse": {
        "type": "object",
        "required": [
          "resources"
        ],
        "properties": {
          "resources": {
            "type": "object",
            "properties": {
              "results": {
                "type": "object",
                "properties": {
                  "products": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "integer"
                        },
                        "title": {
                          "type": "string"
                        },
                        "handle": {
                          "type": "string"
                        },
                        "url": {
                          "type": "string"
                        },
                        "available": {
                          "type": "boolean"
                        },
                        "price": {
                          "type": "string"
                        },
                        "price_min": {
                          "type": "string"
                        },
                        "price_max": {
                          "type": "string"
                        },
                        "image": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "type": {
                          "type": "string"
                        },
                        "vendor": {
                          "type": "string"
                        },
                        "tags": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  },
                  "collections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "integer"
                        },
                        "title": {
                          "type": "string"
                        },
                        "handle": {
                          "type": "string"
                        },
                        "url": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "articles": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "integer"
                        },
                        "title": {
                          "type": "string"
                        },
                        "handle": {
                          "type": "string"
                        },
                        "url": {
                          "type": "string"
                        },
                        "summary_html": {
                          "type": "string"
                        },
                        "published_at": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "pages": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "integer"
                        },
                        "title": {
                          "type": "string"
                        },
                        "handle": {
                          "type": "string"
                        },
                        "url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "UcpProfile": {
        "type": "object",
        "required": [
          "ucp"
        ],
        "properties": {
          "ucp": {
            "type": "object",
            "properties": {
              "version": {
                "type": "string",
                "description": "Current UCP version, e.g. 2026-08-25."
              },
              "supported_versions": {
                "type": "object",
                "additionalProperties": {
                  "type": "string",
                  "format": "uri"
                }
              },
              "services": {
                "type": "object",
                "description": "Service name to list of transports and endpoints.",
                "additionalProperties": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "version": {
                        "type": "string"
                      },
                      "transport": {
                        "type": "string",
                        "enum": [
                          "mcp",
                          "embedded",
                          "rest",
                          "a2a"
                        ]
                      },
                      "endpoint": {
                        "type": "string",
                        "format": "uri"
                      },
                      "spec": {
                        "type": "string",
                        "format": "uri"
                      },
                      "schema": {
                        "type": "string",
                        "format": "uri"
                      }
                    }
                  }
                }
              },
              "capabilities": {
                "type": "object",
                "description": "Capability name to list of versions/specs.",
                "additionalProperties": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "version": {
                        "type": "string"
                      },
                      "spec": {
                        "type": "string",
                        "format": "uri"
                      },
                      "schema": {
                        "type": "string",
                        "format": "uri"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      },
      "JsonRpcRequest": {
        "type": "object",
        "required": [
          "jsonrpc",
          "method"
        ],
        "properties": {
          "jsonrpc": {
            "type": "string",
            "const": "2.0"
          },
          "id": {
            "description": "Request ID; omit for notifications.",
            "oneOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              }
            ]
          },
          "method": {
            "type": "string",
            "description": "MCP method.",
            "enum": [
              "initialize",
              "notifications/initialized",
              "tools/list",
              "tools/call",
              "ping"
            ]
          },
          "params": {
            "type": "object",
            "description": "Method parameters. For tools/call: `{name, arguments}`.",
            "properties": {
              "name": {
                "type": "string"
              },
              "arguments": {
                "type": "object"
              },
              "protocolVersion": {
                "type": "string"
              },
              "capabilities": {
                "type": "object"
              },
              "clientInfo": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "version": {
                    "type": "string"
                  }
                }
              }
            }
          }
        }
      },
      "JsonRpcResponse": {
        "type": "object",
        "required": [
          "jsonrpc"
        ],
        "properties": {
          "jsonrpc": {
            "type": "string",
            "const": "2.0"
          },
          "id": {
            "oneOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "result": {
            "type": "object",
            "description": "Method result, e.g. `{tools: [...]}` for tools/list or `{content: [...]}` for tools/call."
          },
          "error": {
            "type": "object",
            "required": [
              "code",
              "message"
            ],
            "properties": {
              "code": {
                "type": "integer",
                "description": "JSON-RPC error code, e.g. -32601 method not found, -32602 invalid params."
              },
              "message": {
                "type": "string"
              },
              "data": {}
            }
          }
        }
      },
      "GraphqlRequest": {
        "type": "object",
        "required": [
          "query"
        ],
        "properties": {
          "query": {
            "type": "string",
            "description": "GraphQL query document."
          },
          "variables": {
            "type": "object",
            "description": "Query variables."
          },
          "operationName": {
            "type": "string"
          }
        }
      },
      "GraphqlResponse": {
        "type": "object",
        "properties": {
          "data": {
            "type": [
              "object",
              "null"
            ]
          },
          "errors": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "message"
              ],
              "properties": {
                "message": {
                  "type": "string"
                },
                "path": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "extensions": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "extensions": {
            "type": "object",
            "properties": {
              "cost": {
                "type": "object",
                "properties": {
                  "requestedQueryCost": {
                    "type": "integer"
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}