Skip to main content
Glama

WEM Price Compare

Look up several products by barcode

lookup_products
Read-only

Looks up to 20 product identifiers in one call: barcodes (EAN/UPC/GTIN), Amazon ASINs, WEM IDs, catalogue slugs or wem3.ai/pl URLs. Each row has a status: found (WEM's catalogue holds it; the row gives its number of retailer offers, the lowest current price at a named retailer in the shopper's currency, a marketplace low where there is one, a WEM tracked link to the shop for each price it quotes, and a link to WEM's product page), not_found (WEM does not hold it yet, which says nothing about whether it exists or has a price), unrecognised (not an identifier, such as a product name) or not_checked (not reached in this call, so not a miss). Identifiers beyond 20 are counted in overLimit.

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": {
      "identifiers": "<identifiers>"
    },
    "name": "lookup_products"
  }
}

Input Schema

NameRequiredDescriptionDefault
currencyNoISO 4217 code for the shopper's market. Default GBP. Lowest prices are quoted in this currency only, never converted; a product WEM holds only in another currency comes back found with lowPrice null and heldInCurrencies set.
identifiersYes1-20 barcodes (EAN-13, UPC-A, EAN-8, GTIN-14), Amazon ASINs, WEM IDs, catalogue slugs or wem3.ai/pl URLs. Mixed kinds are fine; a comma-separated string is also accepted. Duplicates are looked up once. Each entry must be the identifier alone: not a product name, and not a name with a barcode in it.

Output Schema

NameRequiredDescriptionDefault
nextNoThe WEM tool that answers the follow-up question, and what to pass it.
linksYesLines to give the user, pre-formatted. First the prices the rows quote, each with the retailer page it was read on (the rows’ `lowPriceLink`, cheapest first, then any `marketplaceLowLink`, a seller’s price and not a retail floor). Then one line per found product to WEM’s product page, which lists every retailer WEM holds and carries no price. Give the price’s own line when you name a price; a retailer URL found elsewhere may be a different listing or price.
countsYes
resultsYes
currencyYes
disclosureYesWEM’s affiliate disclosure for this answer, written to be quoted as it is. Its wording changes with the rows: it states whether every outbound link is affiliate-tracked, only some are, or none are. A version from an earlier answer may not fit this one: a row marked `affiliate: false` earns WEM nothing.
unavailableNoPresent and true when WEM could not reach its catalogue. Rows it could not check are not_checked, not not_found — do not report them as products WEM lacks.
overLimitNoteNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed13 schema fields changed
    • changedOutput schema / description
      Previous value: -"One row per distinct identifier, in the order sent. A row is a catalogue fact, not an offer: it says whether WEM holds the product and what the lowest price is, and links to WEM’s product page. Call compare_offers with product.slug for the retailer offers and their links."New value: +"One row per distinct identifier, in the order sent. A row is a catalogue fact, not the full offer list: it says whether WEM holds the product and what the lowest price is, links to WEM’s product page, and gives the shop’s link for each price it quotes (`lowPriceLink`, `marketplaceLowLink`). compare_offers with product.slug lists every retailer offer and its link."
    • changedOutput schema / properties / links / description
      Previous value: -"The WEM product-page links for found rows, pre-formatted to quote. Give these to the user when you name a found product."New value: +"Lines to give the user, pre-formatted. First the prices the rows quote, each with the retailer page it was read on (the rows’ `lowPriceLink`, cheapest first, then any `marketplaceLowLink`, a seller’s price and not a retail floor). Then one line per found product to WEM’s product page, which lists every retailer WEM holds and carries no price. Give the price’s own line when you name a price; a retailer URL found elsewhere may be a different listing or price."
    • addedOutput schema / properties / links / items / properties / affiliate
      Added value: +{
      +  "description": "False when this link earns WEM nothing: the shop has no affiliate programme with WEM, or this link does not carry one. It is still a real offer, and its link is not affiliate-tracked. Absent (or true) means the link is affiliate-tracked. `disclosure` states whether all, some or none of the links are tracked.",
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / links / items / properties / currency
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / links / items / properties / input / description
      Added value: +"The identifier of the row this line belongs to."
    • addedOutput schema / properties / links / items / properties / markdown / description
      Added value: +"The same link as `[Title at Retailer — £0.00](url)`, or `[Title on WEM](url)` for a product page."
    • addedOutput schema / properties / links / items / properties / price
      Added value: +{
      +  "description": "Present on a price’s line. A WEM product-page line has none.",
      +  "type": "number"
      +}
    • addedOutput schema / properties / links / items / properties / provider
      Added value: +{
      +  "description": "Present on a price’s line: the shop’s key, as WEM’s other tools give it.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / links / items / properties / retailer
      Added value: +{
      +  "description": "Present on a price’s line: the retailer quoting it.",
      +  "type": "string"
      +}
    • addedOutput schema / properties / links / items / properties / url / description
      Added value: +"A price’s line: WEM tracked link to the page that price was read on. A product-page line: WEM’s page for the product. The full URL; a shortened or rewritten form is a different link."
    • addedOutput schema / properties / results / items / properties / lowPriceLink
      Added value: +{
      +  "description": "The retailer page for lowPrice: that offer’s retailer, price and WEM tracked link. Present beside a lowPrice WEM holds a link for; absent when lowPrice is null. A retailer URL found elsewhere may be a different listing or price.",
      +  "properties": {
      +    "affiliate": {
      +      "description": "False when this link earns WEM nothing: the shop has no affiliate programme with WEM, or this link does not carry one. It is still a real offer, and its link is not affiliate-tracked. Absent (or true) means the link is affiliate-tracked. `disclosure` states whether all, some or none of the links are tracked.",
      +      "type": "boolean"
      +    },
      +    "currency": {
      +      "type": "string"
      +    },
      +    "markdown": {
      +      "description": "The same link as `[Retailer — £0.00](url)`, for hosts rendering markdown.",
      +      "type": "string"
      +    },
      +    "price": {
      +      "type": "number"
      +    },
      +    "provider": {
      +      "description": "The shop’s key, as WEM’s other tools give it.",
      +      "type": "string"
      +    },
      +    "retailer": {
      +      "type": "string"
      +    },
      +    "url": {
      +      "description": "WEM tracked link to the page this price was read on. The full URL; a shortened or rewritten form is a different link.",
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedOutput schema / properties / results / items / properties / lowPriceRetailer / description
      Added value: +"The named retailer quoting lowPrice. Its link is lowPriceLink."
    • addedOutput schema / properties / results / items / properties / marketplaceLowLink
      Added value: +{
      +  "description": "The listing for marketplaceLowPrice: its seller’s marketplace, price and WEM tracked link. A seller’s price, not a retail floor, like marketplaceLowPrice.",
      +  "properties": {
      +    "affiliate": {
      +      "description": "False when this link earns WEM nothing: the shop has no affiliate programme with WEM, or this link does not carry one. It is still a real offer, and its link is not affiliate-tracked. Absent (or true) means the link is affiliate-tracked. `disclosure` states whether all, some or none of the links are tracked.",
      +      "type": "boolean"
      +    },
      +    "currency": {
      +      "type": "string"
      +    },
      +    "markdown": {
      +      "description": "The same link as `[Retailer — £0.00](url)`, for hosts rendering markdown.",
      +      "type": "string"
      +    },
      +    "price": {
      +      "type": "number"
      +    },
      +    "provider": {
      +      "description": "The shop’s key, as WEM’s other tools give it.",
      +      "type": "string"
      +    },
      +    "retailer": {
      +      "type": "string"
      +    },
      +    "url": {
      +      "description": "WEM tracked link to the page this price was read on. The full URL; a shortened or rewritten form is a different link.",
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
  2. Changed2 schema fields changed
    • changedOutput schema / properties / results / items / properties / lowPrice / description
      Previous value: -"Lowest current indicative price (read within 14 days) at a named retailer in `currency`. Null when WEM holds the product only in another currency (see heldInCurrencies) — never convert one yourself — only as marketplace listings, or with no current price (see note)."New value: +"Lowest current indicative price (read within 14 days) at a named retailer in `currency`, from a shop not out of stock when last checked. Null when WEM holds the product only in another currency (see heldInCurrencies) — never convert one yourself — only as marketplace listings, or with no such price (see note)."
    • changedOutput schema / properties / results / items / properties / note / description
      Previous value: -"Why a row is not found, unrecognised or not checked. Quote it rather than paraphrase."New value: +"Why a row is not found, unrecognised or not checked, or why a found row has no lowPrice. Quote it rather than paraphrase."
  3. Changed1 schema field changed
    • changedOutput schema / properties / results / items / properties / marketplaceLowPrice / description
      Previous value: -"Cheapest marketplace listing (AliExpress…), present only when it undercuts lowPrice or no named retailer holds the product. A seller’s price, not a retail floor: never quote it as the product’s price or the cheapest."New value: +"Cheapest marketplace listing (AliExpress, Temu…), present only when it undercuts lowPrice or no named retailer holds the product. A seller’s price, not a retail floor: never quote it as the product’s price or the cheapest."
  4. Changed1 schema field changed
    • changedOutput schema / properties / results / items / properties / marketplaceLowPrice / description
      Previous value: -"Cheapest marketplace listing (eBay, AliExpress…), present only when it undercuts lowPrice or no named retailer holds the product. A seller’s price, not a retail floor: never quote it as the product’s price or the cheapest."New value: +"Cheapest marketplace listing (AliExpress…), present only when it undercuts lowPrice or no named retailer holds the product. A seller’s price, not a retail floor: never quote it as the product’s price or the cheapest."
  5. Changed3 schema fields changed
    • changedOutput schema / properties / disclosure / description
      Previous value: -"Disclosure to relay once per answer, verbatim. Its wording changes with the rows: it states whether every outbound link is affiliate-tracked, only some are, or none are. Never substitute the version you saw last time — a row marked `affiliate: false` earns WEM nothing, and saying otherwise misdescribes it to the shopper."New value: +"WEM’s affiliate disclosure for this answer, written to be quoted as it is. Its wording changes with the rows: it states whether every outbound link is affiliate-tracked, only some are, or none are. A version from an earlier answer may not fit this one: a row marked `affiliate: false` earns WEM nothing."
    • changedOutput schema / properties / results / items / properties / product / properties / url / description
      Previous value: -"WEM product page listing every retailer WEM holds. Relay it exactly."New value: +"WEM product page listing every retailer WEM holds. The full URL; a shortened form is a different link."
    • changedOutput schema / properties / results / items / properties / status / description
      Previous value: -"not_found: WEM does not hold it yet — never say the product does not exist or has no price; look it up with compare_offers or search_products first. not_checked: not reached in this call, and not a miss. unrecognised: not an identifier this tool reads (product names go to compare_offers)."New value: +"not_found: WEM does not hold it yet — that is not a finding that the product does not exist or has no price. compare_offers and search_products are the lookups for it. not_checked: not reached in this call, and not a miss. unrecognised: not an identifier this tool reads (product names go to compare_offers)."
  6. Changed1 schema field changed
    • changedOutput schema / properties / results / items / properties / lowPrice / description
      Previous value: -"Lowest indicative price at a named retailer in `currency`. Null when WEM holds the product only in another currency (see heldInCurrencies) — never convert one yourself — or only as marketplace listings."New value: +"Lowest current indicative price (read within 14 days) at a named retailer in `currency`. Null when WEM holds the product only in another currency (see heldInCurrencies) — never convert one yourself — only as marketplace listings, or with no current price (see note)."
  7. Added

TDQS

A4.4/5.0
Behavior5/5

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

Beyond the readOnly/non-destructive annotations, it discloses the 20-item cap and that overflow is counted in `overLimit`, defines all four status values, and warns that not_found says nothing about whether the product exists and that not_checked is not a miss. That interpretation guidance materially changes how an agent reads results and is not derivable from the annotations.

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?

The core capability is front-loaded in the first sentence, and every later clause carries real information about the status values. The status enumeration is dense and heavily nested with parentheticals, which slows parsing but does not waste words.

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?

With an output schema, full annotation coverage, and 100% schema description coverage, this description supplies more than enough context to call the tool correctly and to interpret its results. Nothing an agent needs is missing.

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

Parameters3/5

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

Schema coverage is 100%, so both parameters are already documented, including the currency non-conversion rule and the heldInCurrencies fallback. The description mostly restates that, adding only the overLimit overflow behaviour for identifiers past 20, so the baseline of 3 applies.

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

Purpose5/5

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

The first clause states a specific verb, resource, and scope: 'Looks up to 20 product identifiers in one call', followed by the exact identifier kinds accepted. Combined with the explicit exclusion of product names, an agent can tell this apart from name-based siblings like search_products or semantic_search without opening the schema.

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

Usage Guidelines4/5

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

The description establishes the batch context and makes clear that non-identifier input such as a product name comes back 'unrecognised', which implicitly routes name searches elsewhere. It never names an alternative tool or states an explicit 'use X instead when...' rule, so the guidance is clear but not complete.

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