Skip to main content
Glama

Products one shop stopped listing

removed_products
Read-onlyIdempotent

Products that have disappeared from a supermarket's catalogue: delistings and range cuts, each with last_seen, the last day it was listed, and last_price. A product counts as removed once it has been off the shop's site for 8 days (3 at Lidl, whose whole range is read every night), so the window runs from days_back days ago to that many days ago and never covers the last days. A product missing online may still be sold in store: it is no longer listed online, which is not the same as discontinued. more is true when the page is full, so there may be more. Each product returned costs one credit.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "store": "<store>"
    },
    "name": "removed_products"
  }
}

Input Schema

NameRequiredDescriptionDefault
limitNoHow many products to return (default 25, at most 200).
storeYesThe shop: aldi, tesco, supervalu, dunnes or lidl.
days_backNoHow many days back to look (default 21, from 4 to 90). A product counts as removed once it has been off the shop's site for 8 days (3 at Lidl, whose whole range is read every night), so the newest day covered is that many days ago, and a shorter look-back is widened to reach it.

Output Schema

NameRequiredDescriptionDefault
hintNoWhy nothing was found and what to try, when nothing was
moreNoTrue when the page is full, so there may be more than limit allowed
as_ofNoThe day these prices were recorded, YYYY-MM-DD: the latest, where the shops differ
queryNo
storeNoThe shop asked for; missing for all five
totalNoHow many products match in all. products holds only the first of them
errorsNoA shop that could not be read, and why
offsetNoHow many rows this page skipped
creditsNoWhat this answer cost the person's BasketWatch account and what is left. Missing on a free answer
productsNo
next_offsetNoThe offset of the next page; missing on the last
total_by_storeNototal at each shop

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed49 schema fields changed
    • changedInput schema / properties / days_back / default
      Previous value: -7New value: +21
    • addedInput schema / properties / days_back / description
      Added value: +"How many days back to look (default 21, from 4 to 90). A product counts as removed once it has been off the shop's site for 8 days (3 at Lidl, whose whole range is read every night), so the newest day covered is that many days ago, and a shorter look-back is widened to reach it."
    • addedInput schema / properties / days_back / maximum
      Added value: +90
    • addedInput schema / properties / days_back / minimum
      Added value: +4
    • removedInput schema / properties / days_back / title
      Removed value: -"Days Back"
    • addedInput schema / properties / limit / description
      Added value: +"How many products to return (default 25, at most 200)."
    • addedInput schema / properties / limit / maximum
      Added value: +200
    • addedInput schema / properties / limit / minimum
      Added value: +1
    • removedInput schema / properties / limit / title
      Removed value: -"Limit"
    • addedInput schema / properties / store / description
      Added value: +"The shop: aldi, tesco, supervalu, dunnes or lidl."
    • addedInput schema / properties / store / enum
      Added value: +[
      +  "aldi",
      +  "tesco",
      +  "supervalu",
      +  "dunnes",
      +  "lidl"
      +]
    • removedInput schema / properties / store / title
      Removed value: -"Store"
    • removedInput schema / title
      Removed value: -"removed_productsArguments"
    • addedOutput schema / $defs / Credits
      Added value: +{
      +  "additionalProperties": true,
      +  "properties": {
      +    "left": {
      +      "anyOf": [
      +        {
      +          "type": "integer"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "default": null,
      +      "description": "Credits left on the account after it",
      +      "title": "Left"
      +    },
      +    "note": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "default": null,
      +      "description": "Said when the balance is low, or when it cut this answer short",
      +      "title": "Note"
      +    },
      +    "used": {
      +      "description": "Credits this answer cost: one for each record it returned",
      +      "title": "Used",
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "used"
      +  ],
      +  "title": "Credits",
      +  "type": "object"
      +}
    • addedOutput schema / $defs / Product / properties / available
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "0 when the shop shows it as out of stock; left out when it is in stock",
      +  "title": "Available"
      +}
    • addedOutput schema / $defs / Product / properties / clubcard_price
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Member price where one applies: Tesco Clubcard, SuperValu Real Rewards or Lidl Plus",
      +  "title": "Clubcard Price"
      +}
    • addedOutput schema / $defs / Product / properties / first_seen
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "The first day the shop listed it: given for a newly listed product",
      +  "title": "First Seen"
      +}
    • changedOutput schema / $defs / Product / properties / id / description
      Previous value: -"Stable per-retailer product id, e.g. tesco:12345"New value: +"The shop's own product id, e.g. tesco:12345 (an Aldi id has no shop in front): the form a product_ids parameter takes"
    • addedOutput schema / $defs / Product / properties / last_price
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Its price on that last day",
      +  "title": "Last Price"
      +}
    • addedOutput schema / $defs / Product / properties / last_seen
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "The last day the shop listed it: given for a product that has left its range",
      +  "title": "Last Seen"
      +}
    • changedOutput schema / $defs / Product / properties / name / description
      Previous value: -"Product name as the retailer lists it"New value: +"Product name as the shop lists it"
    • addedOutput schema / $defs / Product / properties / offer_text
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "The offer as the shop words it",
      +  "title": "Offer Text"
      +}
    • addedOutput schema / $defs / Product / properties / pack_size
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Pack Size"
      +}
    • changedOutput schema / $defs / Product / properties / price / description
      Previous value: -"Shelf price in euro"New value: +"Shelf price in euro: what anyone pays"
    • addedOutput schema / $defs / Product / properties / price_per_kg
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "unit_price worked out per kilo, where the shop prices the product by weight: the figure to compare packs of different sizes on (per kilo drained, where unit_basis says drained weight)",
      +  "title": "Price Per Kg"
      +}
    • addedOutput schema / $defs / Product / properties / price_per_litre
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "unit_price worked out per litre, where the shop prices the product by volume",
      +  "title": "Price Per Litre"
      +}
    • addedOutput schema / $defs / Product / properties / removed
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "1 when it has left the shop's online range; left out when it is on sale",
      +  "title": "Removed"
      +}
    • changedOutput schema / $defs / Product / properties / scrape_date / description
      Previous value: -"Snapshot date, YYYY-MM-DD"New value: +"The day this row's price was recorded, YYYY-MM-DD: given when it is not the answer's as_of"
    • addedOutput schema / $defs / Product / properties / store
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "aldi, tesco, supervalu, dunnes or lidl",
      +  "title": "Store"
      +}
    • changedOutput schema / $defs / Product / properties / unit_basis / description
      Previous value: -"The unit unit_price is measured in"New value: +"The measure unit_price is in, as the shop states it: '1 KG', '100g', '75cl', 'each'"
    • changedOutput schema / $defs / Product / properties / unit_price / description
      Previous value: -"Price per kg or per litre"New value: +"The shop's own unit price, in the measure unit_basis names: per kg at one shop, per 100g or per 75cl at another, so as it stands it does not compare across rows"
    • addedOutput schema / $defs / Product / properties / url
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Url"
      +}
    • addedOutput schema / $defs / Product / properties / was_price
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "The price the shop says it was before the offer",
      +  "title": "Was Price"
      +}
    • addedOutput schema / additionalProperties
      Added value: +true
    • addedOutput schema / properties / as_of
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "The day these prices were recorded, YYYY-MM-DD: the latest, where the shops differ",
      +  "title": "As Of"
      +}
    • addedOutput schema / properties / credits
      Added value: +{
      +  "anyOf": [
      +    {
      +      "$ref": "#/$defs/Credits"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "What this answer cost the person's BasketWatch account and what is left. Missing on a free answer"
      +}
    • addedOutput schema / properties / errors
      Added value: +{
      +  "additionalProperties": {
      +    "type": "string"
      +  },
      +  "description": "A shop that could not be read, and why",
      +  "title": "Errors",
      +  "type": "object"
      +}
    • addedOutput schema / properties / hint
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Why nothing was found and what to try, when nothing was",
      +  "title": "Hint"
      +}
    • addedOutput schema / properties / more
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "boolean"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "True when the page is full, so there may be more than limit allowed",
      +  "title": "More"
      +}
    • addedOutput schema / properties / next_offset
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "The offset of the next page; missing on the last",
      +  "title": "Next Offset"
      +}
    • addedOutput schema / properties / offset
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "How many rows this page skipped",
      +  "title": "Offset"
      +}
    • addedOutput schema / properties / products
      Added value: +{
      +  "items": {
      +    "$ref": "#/$defs/Product"
      +  },
      +  "title": "Products",
      +  "type": "array"
      +}
    • addedOutput schema / properties / query
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Query"
      +}
    • removedOutput schema / properties / result
      Removed value: -{
      -  "items": {
      -    "$ref": "#/$defs/Product"
      -  },
      -  "title": "Result",
      -  "type": "array"
      -}
    • addedOutput schema / properties / store
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "The shop asked for; missing for all five",
      +  "title": "Store"
      +}
    • addedOutput schema / properties / total
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "How many products match in all. products holds only the first of them",
      +  "title": "Total"
      +}
    • addedOutput schema / properties / total_by_store
      Added value: +{
      +  "additionalProperties": {
      +    "type": "integer"
      +  },
      +  "description": "total at each shop",
      +  "title": "Total By Store",
      +  "type": "object"
      +}
    • removedOutput schema / required
      Removed value: -[
      -  "result"
      -]
    • changedOutput schema / title
      Previous value: -"removed_productsOutput"New value: +"ProductList"
  2. Changed1 schema field changed
    • addedOutput schema / $defs / Product / properties / shelf_path
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Where the retailer shelves it, every level, e.g. 'Fresh Food > Yoghurts > Kefir > Kefir Drinks'",
      +  "title": "Shelf Path"
      +}
  3. First observed

TDQS

A4.1/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the annotations (readOnly, openWorld, idempotent, non-destructive), the description adds the credit cost per returned product, pagination behaviour ('more is true when the page is full'), and the crucial semantic warning that removed-from-site is not the same as discontinued. These are the exact operational facts an agent needs and none are derivable from the annotation block.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the core definition, then the removal threshold, then the interpretation caveat, then pagination and cost. Dense but readable in a single pass. The restatement of the 8-day/3-day window already present in the schema is the one mildly redundant stretch.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Return fields are covered by the output schema, and the description still notes last_seen and last_price; cost, pagination, and the semantics of 'removed' are all addressed. For a three-parameter read tool with full annotation coverage, nothing an agent needs in order to call it correctly or interpret results is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description genuinely adds meaning: it explains why the look-back window excludes the most recent days, why the 8-day (3 at Lidl) threshold exists, and that a full page signals more results. The day-window rule largely duplicates the days_back schema text, which keeps this below a 5.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific resource and qualifier: products that have disappeared from a supermarket's catalogue, i.e. delistings and range cuts, with last_seen and last_price. That is far more specific than a restated title. It never names a sibling (e.g. newly_added_products, find_products) as a routing alternative, so the contrast with the rest of the catalogue is implied rather than stated.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The definition makes the use case clear implicitly ('disappeared', 'delistings and range cuts'), and the caveat that delisted-online is not discontinued helps an agent judge relevance. There is no explicit when-to-use or when-not-to-use statement and no named alternative for the adjacent need (e.g. products still listed), leaving that inference to the agent.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources