{"name":"teas.co.uk WebMCP tools","surface":"document.modelContext","tools":[{"name":"teas_find_products","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/).","read_only":true},{"name":"teas_get_product","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.","read_only":true},{"name":"teas_compare_products","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.","read_only":true},{"name":"teas_find_recipes","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.","read_only":true},{"name":"teas_delivery_and_returns","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.","read_only":true},{"name":"teas_quote_cart","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.","read_only":true},{"name":"teas_find_substitutes","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.","read_only":true},{"name":"teas_get_promotions","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.","read_only":true},{"name":"teas_start_subscription","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.","read_only":true},{"name":"teas_add_to_my_basket","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.","read_only":false},{"name":"teas_update_my_basket","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.","read_only":false},{"name":"teas_view_my_basket","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.","read_only":true},{"name":"teas_go_to_checkout","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.","read_only":true},{"name":"teas_basket_link","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.","read_only":true},{"name":"ask_tea_advice","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.","read_only":true}],"mcp":"https://teas.co.uk/mcp","agent_checkout":"Agent checkout is supported as a hand off. Assistants can now shop teas.co.uk for the person: with their go ahead, an assistant can find and compare products, fill the basket and hand over a secure checkout (through the MCP server, a basket link, the UCP buy link or WebMCP). The person checks the basket and pays on teas.co.uk. Assistants never see card details and never pay or place the order themselves.","ai_routes":{"mcp_server":{"url":"https://teas.co.uk/mcp","transport":"Streamable HTTP","server_card":"https://teas.co.uk/.well-known/mcp/server-card.json","setup_guides":"https://teas.co.uk/ai/","registry":"listed in the official MCP Registry as teas.co.uk","registry_url":"https://registry.modelcontextprotocol.io/v0.1/servers/uk.co.teas%2Fshop/versions/latest","account":"OAuth 2.1, only for the account tools"},"basket_link":{"format":"https://teas.co.uk/go/basket/?items=ID:QTY,ID:QTY","rules":"Up to 20 products, 1 to 99 each; the same id twice is added together. The person opens it, sees a confirmation page and presses Add to basket; nothing changes before that."},"ai_pages":{"start":"https://teas.co.uk/ai/start/","find":"https://teas.co.uk/ai/find/","compare":"https://teas.co.uk/ai/compare/{id}/{id}/","recipes":"https://teas.co.uk/ai/recipes/","delivery":"https://teas.co.uk/ai/delivery/","formats":"HTML, markdown (?format=md) and JSON (?format=json)"},"ucp":{"profile":"https://teas.co.uk/.well-known/ucp","rest":"https://teas.co.uk/ucp/v1","mcp":"https://teas.co.uk/ucp/mcp","buy_link":"https://teas.co.uk/ucp/buy/{id}:{qty}","capabilities":"catalog search, catalog lookup and the buy link; the person checks out on teas.co.uk"},"nlweb":{"ask":"https://teas.co.uk/ask"},"webmcp":{"where":"every teas.co.uk page (document.modelContext, with navigator.modelContext as the older fallback)","tools":"find, compare, alternatives, quotes with delivery, offers and sales, recipes, delivery, basket and checkout hand off"},"agent_skills":"https://teas.co.uk/.well-known/agent-skills/index.json","changes":"https://teas.co.uk/catalogue-changes.json","a2a":{"endpoint":"https://teas.co.uk/a2a","agent_card":"https://teas.co.uk/.well-known/agent-card.json"},"http_apis":{"ask":"https://teas.co.uk/wp-json/teas/v1/ask","product_truth":"https://teas.co.uk/wp-json/teas/v1/product-truth","openapi":"https://teas.co.uk/openapi.json","catalog":"https://teas.co.uk/.well-known/api-catalog","read_only":true},"discovery":{"ai_entry":"https://teas.co.uk/ai-entry.json","llms_txt":"https://teas.co.uk/llms.txt","llms_json":"https://teas.co.uk/llms.json","agents_md":"https://teas.co.uk/agents.md","agents_json":"https://teas.co.uk/agents.json","skills_md":"https://teas.co.uk/SKILLS.md"},"feeds":{"products_jsonl":"https://teas.co.uk/products.jsonl","products_feed":"https://teas.co.uk/products-feed.json","llms_txt":"https://teas.co.uk/llms.txt","llm_full":"https://teas.co.uk/llm-full.txt"},"well_known":"https://teas.co.uk/well-known/","account":{"orders":"https://teas.co.uk/my-account/orders/","tracking":"https://teas.co.uk/my-account/track-order/","repeat_deliveries":"https://teas.co.uk/my-account/subscriptions/","rewards":"https://teas.co.uk/my-account/rewards/","returns":"https://teas.co.uk/my-account/returns/"},"anchors":"https://teas.co.uk/anchor-sitemap.json"}}