NotRobophobic shop

Search the shop catalogue. Returns matching products with their slugs, price and stock availability. Use get-product for full details and variants.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Search terms. Omit or leave empty to list the latest products.",
      "type": "string"
    }
  }
}

Get a product's full details by slug: description, options, and every variant with its SKU, price and stock. Variant IDs are what you add to a basket.

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "The product slug, e.g. \"enamel-mug\".",
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}

Create a new basket. Returns a basket_token — keep it and pass it to every basket and checkout tool. Treat it as a secret.

{
  "type": "object",
  "properties": {}
}

Add a product variant to a basket. Get variant IDs from get-product. Returns the updated basket.

{
  "type": "object",
  "properties": {
    "basket_token": {
      "description": "The basket token from create-basket.",
      "type": "string"
    },
    "variant_id": {
      "description": "The product variant ID to add.",
      "type": "integer"
    },
    "quantity": {
      "description": "Quantity to add (default 1).",
      "type": "integer"
    }
  },
  "required": [
    "basket_token",
    "variant_id"
  ]
}

View a basket: its lines, quantities and subtotal.

{
  "type": "object",
  "properties": {
    "basket_token": {
      "description": "The basket token from create-basket.",
      "type": "string"
    }
  },
  "required": [
    "basket_token"
  ]
}

Change the quantity of a basket line. A quantity of 0 removes it. Returns the updated basket.

{
  "type": "object",
  "properties": {
    "basket_token": {
      "description": "The basket token from create-basket.",
      "type": "string"
    },
    "item_id": {
      "description": "The basket line ID (from view-basket).",
      "type": "integer"
    },
    "quantity": {
      "description": "New quantity; 0 removes the line.",
      "type": "integer"
    }
  },
  "required": [
    "basket_token",
    "item_id",
    "quantity"
  ]
}

Remove a line from a basket. Returns the updated basket.

{
  "type": "object",
  "properties": {
    "basket_token": {
      "description": "The basket token from create-basket.",
      "type": "string"
    },
    "item_id": {
      "description": "The basket line ID (from view-basket).",
      "type": "integer"
    }
  },
  "required": [
    "basket_token",
    "item_id"
  ]
}

Apply a discount code to a basket. Returns the updated basket with the discount reflected in the totals.

{
  "type": "object",
  "properties": {
    "basket_token": {
      "description": "The basket token from create-basket.",
      "type": "string"
    },
    "code": {
      "description": "The discount code to apply.",
      "type": "string"
    }
  },
  "required": [
    "basket_token",
    "code"
  ]
}

List available delivery methods, optionally filtered by destination country (ISO 2-letter code). Use the method ID in start-checkout.

{
  "type": "object",
  "properties": {
    "country": {
      "description": "Optional ISO 3166-1 alpha-2 destination country, e.g. \"GB\".",
      "type": "string"
    }
  }
}

Turn a basket into an order and get payment links. Two ways to pay: a human pay_url (pay-by-bank, the customer authorises in their banking app) and, when offered, an x402_payment_url for autonomous USDC settlement with no human needed. Never claim to have paid — confirm with get-order-status. For digital-only baskets, only name and country are required in shipping_address.

{
  "type": "object",
  "properties": {
    "basket_token": {
      "description": "The basket token from create-basket.",
      "type": "string"
    },
    "email": {
      "description": "Customer email for order confirmation.",
      "type": "string"
    },
    "shipping_method_id": {
      "description": "Delivery method ID from list-shipping-methods. Omit for baskets containing only digital products.",
      "type": "integer"
    },
    "shipping_address": {
      "description": "Customer address. For digital-only baskets only name and country are needed; physical orders also need line1, city and postcode.",
      "properties": {
        "name": {
          "type": "string"
        },
        "line1": {
          "description": "Street address. Required for physical delivery; omit for digital-only baskets.",
          "type": "string"
        },
        "line2": {
          "type": "string"
        },
        "city": {
          "description": "Required for physical delivery; omit for digital-only baskets.",
          "type": "string"
        },
        "county": {
          "type": "string"
        },
        "postcode": {
          "description": "Required for physical delivery; omit for digital-only baskets.",
          "type": "string"
        },
        "country": {
          "description": "ISO 2-letter country code, e.g. GB.",
          "type": "string"
        },
        "phone": {
          "type": "string"
        }
      },
      "type": "object",
      "required": [
        "name",
        "country"
      ]
    }
  },
  "required": [
    "basket_token",
    "email",
    "shipping_address"
  ]
}

Check an order's status. Requires the order number AND the email it was placed with.

{
  "type": "object",
  "properties": {
    "order_number": {
      "description": "The order number, e.g. ORD-260612-AB3D.",
      "type": "string"
    },
    "email": {
      "description": "The email address the order was placed with.",
      "type": "string"
    }
  },
  "required": [
    "order_number",
    "email"
  ]
}