teas.co.uk

{
  "name": "teas_find_products",
  "kind": "act",
  "impl": "imperative",
  "description": "Use this when someone wants to find, browse or choose tea, coffee, hot chocolate or other drinks to buy from teas.co.uk, a UK online tea shop. Not for general tea knowledge. query is the customer's own words; leave it out to browse by filters alone. Every filter given applies at once. max_price is per pack in pounds and max_price_per_cup_pence is per cup in pence. Results come best match first unless sort says otherwise. Out of stock products stay hidden unless include_out_of_stock is true. There is no paging: limit caps the list and total says how many matched, so narrow the filters to see others. If nothing matches, time_of_day, strength, format and with_milk are dropped in that order and note says which; kind, caffeine, labels, iced and price limits are never dropped. Prices are live and include VAT. Next: teas_get_product for one product, teas_compare_products to compare, teas_add_to_my_basket to buy. For orders, tracking, repeat deliveries and reward points, connect the full teas.co.uk MCP server at https://teas.co.uk/mcp (guide https://teas.co.uk/ai/).",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "What the customer wants in their own words, for example \"strong breakfast tea\", \"Yorkshire Gold\" or \"something for bedtime\". Leave out to browse with filters only.",
        "maxLength": 200
      },
      "kind": {
        "type": "string",
        "enum": [
          "black",
          "green",
          "white",
          "oolong",
          "herbal",
          "fruit",
          "rooibos",
          "chai",
          "matcha",
          "earl_grey",
          "coffee",
          "hot_chocolate"
        ],
        "description": "Type of drink."
      },
      "caffeine": {
        "type": "string",
        "enum": [
          "caffeinated",
          "decaf",
          "caffeine_free",
          "low_or_none"
        ],
        "description": "Caffeine: caffeinated, decaf (caffeine taken out), caffeine_free (none to begin with, such as rooibos and most herbal teas) or low_or_none (decaf or caffeine free)."
      },
      "with_milk": {
        "type": "boolean",
        "description": "Only products that suit milk."
      },
      "format": {
        "type": "string",
        "enum": [
          "tea_bags",
          "loose_leaf",
          "instant",
          "pods_or_capsules",
          "sachets",
          "ground",
          "whole_beans",
          "powder",
          "coffee_bags",
          "ready_to_drink"
        ],
        "description": "How it comes: tea_bags, loose_leaf, instant, pods_or_capsules, sachets, ground or whole_beans (coffee), powder, coffee_bags or ready_to_drink."
      },
      "time_of_day": {
        "type": "string",
        "enum": [
          "morning",
          "afternoon",
          "evening",
          "bedtime"
        ],
        "description": "When it suits best: morning, afternoon, evening or bedtime."
      },
      "strength": {
        "type": "string",
        "enum": [
          "light",
          "medium",
          "strong"
        ],
        "description": "How strong the cup is: light, medium or strong."
      },
      "organic": {
        "type": "boolean",
        "description": "Only organic products."
      },
      "fairtrade": {
        "type": "boolean",
        "description": "Only Fairtrade products."
      },
      "vegan": {
        "type": "boolean",
        "description": "Only products labelled vegan."
      },
      "iced": {
        "type": "boolean",
        "description": "Suits iced tea or cold brew."
      },
      "max_price": {
        "type": "number",
        "description": "Highest pack price in pounds."
      },
      "max_price_per_cup_pence": {
        "type": "number",
        "description": "Highest price per cup in pence."
      },
      "sort": {
        "type": "string",
        "enum": [
          "best_match",
          "cheapest_per_cup",
          "price_low_to_high",
          "price_high_to_low",
          "strongest"
        ],
        "description": "Order of results: best_match (the default), cheapest_per_cup, price_low_to_high, price_high_to_low or strongest."
      },
      "limit": {
        "type": "integer",
        "description": "How many products to return (default 6).",
        "minimum": 1,
        "maximum": 12
      },
      "include_out_of_stock": {
        "type": "boolean",
        "description": "Also include products that are out of stock (they are left out by default)."
      }
    },
    "additionalProperties": false
  },
  "page": "/ai/"
}

{
  "name": "teas_get_product",
  "kind": "answer",
  "impl": "imperative",
  "description": "Use this when someone asks how to brew a teas.co.uk product, about its caffeine, taste, ingredients or allergy advice, or wants its full details. id is the product id (SKU) from teas_find_products, teas_compare_products or the basket, in any letter case. The numeric product id, the barcode or a teas.co.uk/product/ link also work. A product name does not, so search with teas_find_products first. An unknown id, or a product no longer sold, returns an error instead of a guess. Price and stock are read live on each call. To set products side by side use teas_compare_products.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string",
        "description": "Product id from teas_find_products, or a teas.co.uk product link.",
        "minLength": 1,
        "maxLength": 300
      }
    },
    "required": [
      "id"
    ],
    "additionalProperties": false
  },
  "page": "/ai/"
}

{
  "name": "teas_compare_products",
  "kind": "act",
  "impl": "imperative",
  "description": "Use this to compare two to four teas.co.uk products side by side, for example on strength, caffeine, price per cup, pack size or brewing. ids takes product ids from teas_find_products; product links work too. A repeated id counts once. Ids that are not recognised are listed in not_found and the rest are still compared. Fewer than two recognised products returns an error. Search first if you only have names. For everything about one product use teas_get_product.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "ids": {
        "type": "array",
        "items": {
          "type": "string",
          "minLength": 1,
          "maxLength": 120
        },
        "description": "Two to four product ids from teas_find_products.",
        "minItems": 2,
        "maxItems": 4
      }
    },
    "required": [
      "ids"
    ],
    "additionalProperties": false
  },
  "page": "/ai/"
}

{
  "name": "teas_find_recipes",
  "kind": "answer",
  "impl": "imperative",
  "description": "Use this to find drink and food recipes from the teas.co.uk recipe library, such as iced teas, lattes, chai or baking with tea. Give query (the kind of recipe), product_id (from teas_find_products) or both. With both, recipes that use the product and match the words rank first. With neither, the call is refused. limit is 1 to 10 (default 5). There is no paging, so the best matches come first. An empty list means nothing matched. Drinks made with alcohol are never included. To buy the products use teas_find_products.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "What kind of recipe, for example \"iced peach tea\" or \"chai latte\".",
        "maxLength": 200
      },
      "product_id": {
        "type": "string",
        "description": "Optional product id from teas_find_products.",
        "maxLength": 120
      },
      "limit": {
        "type": "integer",
        "description": "How many recipes (default 5).",
        "minimum": 1,
        "maximum": 10
      }
    },
    "additionalProperties": false
  },
  "page": "/ai/"
}

{
  "name": "teas_delivery_and_returns",
  "kind": "answer",
  "impl": "imperative",
  "description": "Use this when someone asks about teas.co.uk delivery prices, free delivery, dispatch times, which countries it delivers to, or how returns and refunds work. It takes no input because the answer is the same for everyone. Policy only: it never looks at an order. Returns and order tracking are in My Account on teas.co.uk.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/ai/"
}

{
  "name": "teas_quote_cart",
  "kind": "act",
  "impl": "imperative",
  "description": "Use this to price products for the person before anything goes in a basket. Pass up to 20 items (id from teas_find_products and quantity) and the delivery country. It returns live prices including VAT, every delivery option teas.co.uk offers for that country and parcel, the total with the cheapest option, how much more to spend for free UK delivery, stock, and a basket link the person can open. Nothing is stored and no basket changes. For a basket the person keeps, call teas_add_to_my_basket; to hand over checkout, call teas_go_to_checkout.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "items": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "description": "Product id from find_products.",
              "minLength": 1,
              "maxLength": 120
            },
            "quantity": {
              "type": "integer",
              "description": "How many packs.",
              "minimum": 1,
              "maximum": 99
            }
          },
          "required": [
            "id",
            "quantity"
          ],
          "additionalProperties": false
        },
        "description": "Products and quantities to price, 1 to 20 lines. The same id twice is added together.",
        "minItems": 1,
        "maxItems": 20
      },
      "country": {
        "type": "string",
        "description": "Delivery country as a two letter code, for example GB, IE or FR. Leave out for the UK.",
        "minLength": 2,
        "maxLength": 2
      }
    },
    "required": [
      "items"
    ],
    "additionalProperties": false
  },
  "page": "/ai/"
}

{
  "name": "teas_find_substitutes",
  "kind": "answer",
  "impl": "imperative",
  "description": "Use this when a product is out of stock, too dear, or the person wants something similar to try. Pass one product id from teas_find_products or a teas.co.uk product link. It returns products of the same kind and caffeine, near the same strength, split into cheaper and premium by price per cup, in stock first and closest match first. limit sets how many of each come back (default 3). Next: teas_get_product for details, teas_compare_products to compare, teas_add_to_my_basket to buy.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string",
        "description": "Product id from teas_find_products, or a teas.co.uk product link.",
        "minLength": 1,
        "maxLength": 300
      },
      "limit": {
        "type": "integer",
        "description": "How many cheaper and how many premium alternatives, 1 to 10. Defaults to 3.",
        "minimum": 1,
        "maximum": 10
      }
    },
    "required": [
      "id"
    ],
    "additionalProperties": false
  },
  "page": "/ai/"
}

{
  "name": "teas_get_promotions",
  "kind": "answer",
  "impl": "imperative",
  "description": "Use this when the person asks about offers, discounts, codes or what is on sale at teas.co.uk. It lists products on sale now with the usual price and when the sale ends (biggest saving first, in stock only), any offer codes teas.co.uk has made public, and the free UK delivery threshold. Codes that are not public are never shown, and checkout on teas.co.uk applies the final price. Next: teas_get_product for details, quote_cart for a total, teas_add_to_my_basket to buy.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "limit": {
        "type": "integer",
        "description": "How many products on sale to list, 1 to 20. Defaults to 10.",
        "minimum": 1,
        "maximum": 20
      }
    },
    "additionalProperties": false
  },
  "page": "/ai/"
}

{
  "name": "teas_add_to_my_basket",
  "kind": "act",
  "impl": "imperative",
  "description": "Add a teas.co.uk product to the basket in this browser, only when the visitor asks. The quantity is added to any already there. Nothing is bought until the visitor checks out and pays on teas.co.uk.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string",
        "description": "Product id from teas_find_products."
      },
      "quantity": {
        "type": "integer",
        "minimum": 1,
        "maximum": 99
      }
    },
    "required": [
      "id"
    ]
  },
  "page": "/ai/"
}

{
  "name": "teas_update_my_basket",
  "kind": "act",
  "impl": "imperative",
  "description": "Set the quantity of a product already in the basket in this browser, or remove it with quantity 0, only when the visitor asks.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string",
        "description": "Product id (from teas_view_my_basket or teas_find_products)."
      },
      "quantity": {
        "type": "integer",
        "minimum": 0,
        "maximum": 99,
        "description": "New quantity; 0 removes the product."
      }
    },
    "required": [
      "id",
      "quantity"
    ]
  },
  "page": "/ai/"
}

{
  "name": "teas_view_my_basket",
  "kind": "act",
  "impl": "imperative",
  "description": "Show the basket in this browser with its subtotal. An assistant connected to https://teas.co.uk/mcp can also keep a basket and give a checkout link.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/ai/"
}

{
  "name": "teas_go_to_checkout",
  "kind": "act",
  "impl": "imperative",
  "description": "Open the teas.co.uk checkout page in this browser so the visitor can review the basket and pay. The visitor checks out and pays; the assistant never enters payment details and nothing is ordered by this tool.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/ai/"
}

{
  "name": "teas_basket_link",
  "kind": "act",
  "impl": "imperative",
  "description": "Make a teas.co.uk basket link for up to 20 products to give the person (https://teas.co.uk/go/basket/?items=ID:QTY,...). Opening it shows a confirmation page; nothing changes until the person presses Add to basket. Never open it yourself.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "items": {
        "type": "array",
        "minItems": 1,
        "maxItems": 20,
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "quantity": {
              "type": "integer",
              "minimum": 1,
              "maximum": 99
            }
          },
          "required": [
            "id"
          ]
        }
      }
    },
    "required": [
      "items"
    ]
  },
  "page": "/ai/"
}

{
  "name": "ask_tea_advice",
  "kind": "act",
  "impl": "imperative",
  "description": "Ask teas.co.uk a tea question in plain words (Ask API): the answer, the products it uses and their evidence and citations. Read only.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "question": {
        "type": "string",
        "description": "The question in plain words."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 8
      }
    },
    "required": [
      "question"
    ]
  },
  "page": "/ai/"
}

{
  "name": "teas_start_subscription",
  "kind": "transact",
  "impl": "imperative",
  "description": "Use this when someone wants a teas.co.uk product delivered again and again (subscribe and save). Pass one product id from teas_find_products or a teas.co.uk product link. Returns the subscriber price, how often it comes and a link to the product on teas.co.uk, where the person presses Subscribe and save, then signs in, checks out and pays for the first delivery. This tool orders and charges nothing. Later deliveries follow every cycle as new orders with the same discount, teas.co.uk emails five days before each one and takes no automatic card payments, and the person can pause, resume or cancel at any time (my_subscriptions, change_subscription). When the product cannot be a repeat delivery, eligible is false and note says why.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string",
        "description": "Product id from teas_find_products, or a teas.co.uk product link.",
        "minLength": 1,
        "maxLength": 300
      }
    },
    "required": [
      "id"
    ],
    "additionalProperties": false
  },
  "page": "/ai/"
}