basketeer_basket_get
Get the current basket: line items, quantities, and guide price.
LABSCO SUMMARY
A grocery shop an agent can actually run, with nutrition as a first-class query field.
Ranking a live search by protein or sugar is the thing nothing else here does, and it works without signing in. The boundary is drawn where it should be: the basket, the slot and the amend window are all reachable, but checkout returns a URL and a person completes the payment.
What it is
An MCP server over your own Tesco account, talking to Tesco's GraphQL gateway rather than scraping the page. Its distinguishing feature is nutrition: where a product lists on-pack values, they come back as typed macros and named micronutrients you can filter and rank a search by. Checkout stops at the payment URL — a person finishes it in a browser.
What you get
- basketeer_search and basketeer_product — search the catalogue for SKU, title, price, offers and quantity rules, or fetch one product by SKU with its pack size, promotions and nutrition
- basketeer_nutrition and basketeer_search_by_nutrition — normalized macros and micronutrients per 100g or ml for a product, and a search filtered and ranked by them
- basketeer_favourites — the signed-in customer's usuals with prices, offers and quantity rules
- basketeer_basket_get, basketeer_basket_set and basketeer_basket_remove — read the basket with its guide price, set a line to an exact quantity (zero removes it), or drop a SKU entirely
- basketeer_slots_list — delivery slots over a date window, defaulting to the next week
- basketeer_orders_list, basketeer_last_order and basketeer_orders_cancel — upcoming orders with their items and amend window, the last delivered order for reordering, and cancellation in two steps with a confirmation token
- basketeer_checkout — the current basket and the URL where a person completes payment; the server never places or pays for an order
Requirements
A Tesco account and a saved session for anything account-scoped — favourites, basket, slots and orders. Nutrition and catalogue reads work anonymously with no login at all. Clients run the basketeer-mcp binary from the npm package over stdio; Node.js 18 or newer. Read-only and destructive tools carry MCP annotations, and 3-D Secure payment is deliberately left to a human in a browser.
Setup effort
One command — npm install basketeer
USE CASES
01
Finding food that fits a target
Search with nutrition constraints and rank the results by the macro you care about.
02
Building this week's shop
Start from your usuals, set each line to the quantity you want, and read the basket back with its guide price.
03
Reordering the usual shop
Read the last delivered order and add its items back to the basket.
04
Getting it delivered
List the slots for the week, then produce the checkout URL for a person to pay.
05
Cancelling before the cutoff
Check the upcoming order's amend window, then cancel in two steps with the confirmation token.
13 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
basketeer_basket_remove
Remove a SKU from the basket entirely. Returns a compact receipt; call basketeer_basket_get for full basket contents.
basketeer_basket_set
Set a SKU's basket line to an exact quantity (set-not-increment). quantity 0 removes the line. Returns a compact receipt; call basketeer_basket_get for full basket contents.
basketeer_checkout
Prepare checkout: returns the current basket and the URL where a HUMAN completes payment in a browser. This server never places or pays for an order — Tesco's 3-D Secure payment step is browser-bound by design. Two-step: call once with no args to preview the basket and get a confirmToken; call again with confirm set to that token to get the payment URL for the human to complete.
basketeer_favourites
List the signed-in customer's favourites ('my usuals') including price, offers, and quantityRules. Requires a saved session.
basketeer_last_order
Return the last delivered (fulfilled) order and its items, e.g. for 'reorder my usual shop'. Returns null if there is none. This is a read — to reorder, add its items via basketeer_basket_set.
basketeer_nutrition
Normalized nutrition (typed macros + micros) for a product by SKU.
basketeer_orders_cancel
Cancel an upcoming order outright (only before its amend/cancel cutoff). Two-step: call once with just orderNo to get a confirmToken and a preview; call again with confirm set to that token to actually cancel. Cancelling is irreversible.
basketeer_orders_list
List upcoming (pending) orders with their items, slot, and amend window.
basketeer_product
Fetch one product by SKU (tpnc), including price, pack size, promotions, quantityRules (weight/bulk buy/catch weight options), and nutrition.
basketeer_search
Search the Tesco grocery catalogue. Returns matching products with SKU, title, price, offers, and quantityRules (weight/bulk buy limits).
basketeer_search_by_nutrition
Search products by keyword, then filter/rank by nutrition (per 100g/ml). Hydrates each candidate with a throttled product fetch; bounded by hydrate.
basketeer_slots_list
List delivery slots over a date window (defaults to today..+6 days). Dates are YYYY-MM-DD.
BEFORE YOU INSTALL
What to know first
Tools you get
13 tools when we connected. Slot booking and order amendment exist in the SDK but have no tool: an agent can list slots but not book one.
Where it runs
The documented client runs the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 13 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npm install basketeerMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"basketeer": {
"command": "npx",
"args": [
"-y",
"-p",
"basketeer",
"basketeer-mcp"
]
}
}
}
