Sample Shop MCP server

Search the shop catalogue by phrase and optional category. Returns one page of up to `limit` products and a `nextCursor`; when nextCursor is not null, more results exist and you must say so rather than claiming the list is complete. Use get_product for full details of one item. This tool does not place orders.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Words to match against product names and descriptions.",
      "type": "string",
      "maxLength": 100
    },
    "category": {
      "description": "Restrict results to one category.",
      "type": "string",
      "enum": [
        "lighting",
        "furniture",
        "kitchen"
      ]
    },
    "limit": {
      "default": 5,
      "description": "Page size.",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    },
    "cursor": {
      "description": "Opaque token from a previous page's nextCursor. Never invent one.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Return the full details of one product by its id (for example p-1001). Use search_products first if you only know a name.

{
  "type": "object",
  "properties": {
    "productId": {
      "type": "string",
      "description": "The product id from search_products."
    }
  },
  "required": [
    "productId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Place an order for one product. Generate one random idempotencyKey per user request and reuse the same key if you retry after an error or timeout; the shop returns the original order instead of creating a duplicate. Confirm product and quantity with the user before calling. Returns the order with its id, status and total.

{
  "type": "object",
  "properties": {
    "productId": {
      "type": "string",
      "description": "Product id from search_products or get_product."
    },
    "quantity": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "Units to order, 1 to 10."
    },
    "idempotencyKey": {
      "type": "string",
      "minLength": 8,
      "maxLength": 128,
      "description": "A unique key you generate for this order attempt and reuse on retry."
    }
  },
  "required": [
    "productId",
    "quantity",
    "idempotencyKey"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Cancel an order that has not shipped. This cannot be undone. Call it first with confirm=false to get the order details, show them to the user, and only after the user explicitly agrees call again with confirm=true.

{
  "type": "object",
  "properties": {
    "orderId": {
      "type": "string",
      "description": "The order id, for example o-5001."
    },
    "confirm": {
      "default": false,
      "description": "Set true only after the user has explicitly confirmed the cancellation.",
      "type": "boolean"
    }
  },
  "required": [
    "orderId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}