Skip to main content
Glama

Recent eBay sold comps

get_sold_comps
Read-onlyIdempotent

The most recent real eBay sales (sold comps) for a search query (brand, model or pattern, a few specific words), with the count, median and quartiles. Use when the user wants to see what actually sold and for how much. It searches the signed-in user's own eBay marketplace (eBay UK in GBP for a UK seller), eBay US in USD when nobody is signed in, or the site given in marketplace; the result names the site (marketplace) and the currency (currency). One search runs: the query as typed (a retail price with "$" in it is left out), with model or part_number appended only when the query does not already name it; with no query, brand plus model, or brand plus part_number. Sales whose title shows a different item are left out of the count, median and quartiles: comps.matched is how many were kept, comps.dropped how many were left out, and comps.relevanceChecked is false when that check could not run (every sale is then kept). comps.countIsLowerBound true means eBay returned a full page, so the count is that many or more. include words must all appear in a sale's title (and are added to the search when missing); a title with any exclude word is left out; both match whole words in any case and are named in the answer. prefer words leave nothing out: sales whose title has every one are listed first (preferred true) and summarized in comps.preferred, while count and summary still cover every matching sale. Each listed sale has condition, saleType, bids, shipping and location, each null when not known (a sale stored before 22 October 2026 gives condition only as new or used). exclude_items leaves out sales by eBay item number (each listed sale's itemId), before every other filter; comps.removedByItems counts them. limit sets how many recent sales are listed (default 8, up to 50).

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "get_sold_comps"
  }
}

Input Schema

NameRequiredDescriptionDefault
brandNoThe brand or maker exactly as printed on the item, its tag or its label (for example "Simrad", "Pyrex", "Levi's"). Fill it from what you read on the item or the user's photo; leave it empty rather than guess.
limitNoHow many recent sales to list in comps.recent, 1 to 50. Leave it empty for 8. The count and summary always cover every matching sale, not just the ones listed.
modelNoThe model or product-line name as printed on the item or its box (for example "iPhone 12", "QuietComfort 35", "Odyssey G5", "501"). It is passed to the identification as a hint and added to the search when no word of it is already there; it never replaces the search. Put a manufacturer part number in part_number. Leave it empty rather than guess.
queryNo3 to 6 specific words, brand and model first, like an eBay search.
preferNoUp to 5 soft words (each up to 40 characters), for example ["rattan"]. No sale is left out and the search is not changed: sales whose title contains every one as a whole word, any case, are listed first in comps.recent (marked preferred) and summarized apart in comps.preferred. Use prefer when sellers may word the same item differently; use include to keep only titles with the word.
excludeNoUp to 5 words (each up to 40 characters); a sale whose title contains any of them as a whole word, any case, is left out, for example ["jade", "cabinet"].
includeNoUp to 5 words (each up to 40 characters) every sale title must contain as a whole word, any case, for example ["oak", "carved"]. They are also added to the search when the query does not already hold them.
marketplaceNoThe eBay site to search: EBAY_US (eBay US, prices in USD) or EBAY_GB (eBay UK, prices in GBP). Leave it empty to use the signed-in user's own marketplace, or eBay US when nobody is signed in. Set it only when the user asks about a market other than their own. A photo scan always uses the account's own marketplace.
part_numberNoThe manufacturer part number printed on the label or rating plate (for example "000-16294-001", "DCD771C2", "CUH-ZCT2U"), copied character for character. Not a size, voltage, year, SKU, ASIN, LPN or barcode. In price_item it is a hint to the identification only and is not added to the search (a part number required in every listing title leaves too few sales); in get_sold_comps it is appended to the query when the query lacks it. Leave it empty rather than guess.
exclude_itemsNoUp to 20 eBay item numbers (9 to 15 digits) to leave out of the count, summary and list, for example the user's own earlier sale of the same item, which is not independent evidence. Each listed sale's itemId is its eBay item number.

Output Schema

NameRequiredDescriptionDefault
nextNo
noteNo
textNo
compsNo
queryNoThe query as sent.
preferNo
sourceNoAttribution to show the user.
accountNo
excludeNo
includeNo
currencyNoISO code of every price in comps.
marketplaceNoThe eBay site searched, by name.
excludeItemsNo
unstructuredNoTrue: read `text`.
marketplaceIdNo
searchedQueryNoThe search actually run, when it differs.
marketplaceNoteNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "https://json-schema.org/draft/2020-12/schema",
      +  "additionalProperties": {},
      +  "properties": {
      +    "account": {
      +      "additionalProperties": {},
      +      "properties": {
      +        "usage": {
      +          "additionalProperties": {},
      +          "description": "A note on this account's connector use, when one is due.",
      +          "properties": {},
      +          "type": "object"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "comps": {
      +      "additionalProperties": {},
      +      "properties": {
      +        "count": {
      +          "type": "number"
      +        },
      +        "countIsLowerBound": {
      +          "description": "True when eBay returned a full page: say the count as that number or more.",
      +          "type": "boolean"
      +        },
      +        "dropped": {
      +          "description": "Sales left out as a different item.",
      +          "type": "number"
      +        },
      +        "matched": {
      +          "description": "Sales kept.",
      +          "type": "number"
      +        },
      +        "preferred": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "count": {
      +              "type": "number"
      +            },
      +            "summary": {
      +              "additionalProperties": {},
      +              "description": "Sale prices summarised, in the answer's currency.",
      +              "properties": {
      +                "max": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "median": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "min": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "n": {
      +                  "description": "How many sale prices the summary covers.",
      +                  "type": "number"
      +                },
      +                "p25": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                },
      +                "p75": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "words": {
      +              "items": {
      +                "type": "string"
      +              },
      +              "type": "array"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "recent": {
      +          "items": {
      +            "additionalProperties": {},
      +            "properties": {
      +              "askingPrice": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "bids": {
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "condition": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "itemId": {
      +                "description": "The eBay item number, for exclude_items.",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "location": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "platform": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "preferred": {
      +                "type": "boolean"
      +              },
      +              "price": {
      +                "description": "What it sold for, in the answer's currency.",
      +                "type": "number"
      +              },
      +              "saleType": {
      +                "description": "auction, buy_it_now or best_offer.",
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "shipping": {
      +                "description": "Postage the buyer paid; 0 is free.",
      +                "type": [
      +                  "number",
      +                  "null"
      +                ]
      +              },
      +              "soldDate": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "title": {
      +                "type": "string"
      +              },
      +              "url": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "relevanceChecked": {
      +          "description": "False when the check for unrelated sales did not run.",
      +          "type": "boolean"
      +        },
      +        "removedByItems": {
      +          "type": "number"
      +        },
      +        "removedByWords": {
      +          "type": "number"
      +        },
      +        "summary": {
      +          "additionalProperties": {},
      +          "description": "Sale prices summarised, in the answer's currency.",
      +          "properties": {
      +            "max": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "median": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "min": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "n": {
      +              "description": "How many sale prices the summary covers.",
      +              "type": "number"
      +            },
      +            "p25": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "p75": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            }
      +          },
      +          "type": "object"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "currency": {
      +      "description": "ISO code of every price in comps.",
      +      "type": "string"
      +    },
      +    "exclude": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "excludeItems": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "include": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "marketplace": {
      +      "description": "The eBay site searched, by name.",
      +      "type": "string"
      +    },
      +    "marketplaceId": {
      +      "type": "string"
      +    },
      +    "marketplaceNote": {
      +      "type": "string"
      +    },
      +    "next": {
      +      "additionalProperties": {},
      +      "properties": {
      +        "scanWithPhoto": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "note": {
      +      "type": "string"
      +    },
      +    "prefer": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    "query": {
      +      "description": "The query as sent.",
      +      "type": "string"
      +    },
      +    "searchedQuery": {
      +      "description": "The search actually run, when it differs.",
      +      "type": "string"
      +    },
      +    "source": {
      +      "additionalProperties": {},
      +      "description": "Attribution to show the user.",
      +      "properties": {
      +        "cite": {
      +          "description": "A sentence to show the user, naming where the price came from.",
      +          "type": "string"
      +        },
      +        "name": {
      +          "type": "string"
      +        },
      +        "url": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "text": {
      +      "type": "string"
      +    },
      +    "unstructured": {
      +      "description": "True: read `text`.",
      +      "type": "boolean"
      +    }
      +  },
      +  "type": "object"
      +}
  2. Changed2 schema fields changed
    • addedInput schema / properties / exclude_items
      Added value: +{
      +  "description": "Up to 20 eBay item numbers (9 to 15 digits) to leave out of the count, summary and list, for example the user's own earlier sale of the same item, which is not independent evidence. Each listed sale's itemId is its eBay item number.",
      +  "items": {
      +    "pattern": "^\\d{9,15}$",
      +    "type": "string"
      +  },
      +  "maxItems": 40,
      +  "type": "array"
      +}
    • addedInput schema / properties / prefer
      Added value: +{
      +  "description": "Up to 5 soft words (each up to 40 characters), for example [\"rattan\"]. No sale is left out and the search is not changed: sales whose title contains every one as a whole word, any case, are listed first in comps.recent (marked preferred) and summarized apart in comps.preferred. Use prefer when sellers may word the same item differently; use include to keep only titles with the word.",
      +  "items": {
      +    "maxLength": 40,
      +    "minLength": 1,
      +    "type": "string"
      +  },
      +  "maxItems": 5,
      +  "type": "array"
      +}
  3. Changed3 schema fields changed
    • addedInput schema / properties / exclude
      Added value: +{
      +  "description": "Up to 5 words (each up to 40 characters); a sale whose title contains any of them as a whole word, any case, is left out, for example [\"jade\", \"cabinet\"].",
      +  "items": {
      +    "maxLength": 40,
      +    "minLength": 1,
      +    "type": "string"
      +  },
      +  "maxItems": 5,
      +  "type": "array"
      +}
    • addedInput schema / properties / include
      Added value: +{
      +  "description": "Up to 5 words (each up to 40 characters) every sale title must contain as a whole word, any case, for example [\"oak\", \"carved\"]. They are also added to the search when the query does not already hold them.",
      +  "items": {
      +    "maxLength": 40,
      +    "minLength": 1,
      +    "type": "string"
      +  },
      +  "maxItems": 5,
      +  "type": "array"
      +}
    • addedInput schema / properties / limit
      Added value: +{
      +  "description": "How many recent sales to list in comps.recent, 1 to 50. Leave it empty for 8. The count and summary always cover every matching sale, not just the ones listed.",
      +  "maximum": 50,
      +  "minimum": 1,
      +  "type": "integer"
      +}
  4. Changed1 schema field changed
    • addedInput schema / properties / marketplace
      Added value: +{
      +  "description": "The eBay site to search: EBAY_US (eBay US, prices in USD) or EBAY_GB (eBay UK, prices in GBP). Leave it empty to use the signed-in user's own marketplace, or eBay US when nobody is signed in. Set it only when the user asks about a market other than their own. A photo scan always uses the account's own marketplace.",
      +  "enum": [
      +    "EBAY_US",
      +    "EBAY_GB"
      +  ],
      +  "type": "string"
      +}
  5. Changed4 schema fields changed
    • addedInput schema / properties / brand
      Added value: +{
      +  "description": "The brand or maker exactly as printed on the item, its tag or its label (for example \"Simrad\", \"Pyrex\", \"Levi's\"). Fill it from what you read on the item or the user's photo; leave it empty rather than guess.",
      +  "maxLength": 80,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / model
      Added value: +{
      +  "description": "The model or product-line name as printed on the item or its box (for example \"iPhone 12\", \"QuietComfort 35\", \"Odyssey G5\", \"501\"). It is passed to the identification as a hint and added to the search when no word of it is already there; it never replaces the search. Put a manufacturer part number in part_number. Leave it empty rather than guess.",
      +  "maxLength": 80,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / part_number
      Added value: +{
      +  "description": "The manufacturer part number printed on the label or rating plate (for example \"000-16294-001\", \"DCD771C2\", \"CUH-ZCT2U\"), copied character for character. Not a size, voltage, year, SKU, ASIN, LPN or barcode. In price_item it is a hint to the identification only and is not added to the search (a part number required in every listing title leaves too few sales); in get_sold_comps it is appended to the query when the query lacks it. Leave it empty rather than guess.",
      +  "maxLength": 40,
      +  "minLength": 3,
      +  "type": "string"
      +}
    • removedInput schema / required
      Removed value: -[
      -  "query"
      -]
  6. First observed

TDQS

A4.2/5.0
Behavior5/5

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

Annotations only declare it read-only, idempotent, open-world and non-destructive; the description goes well beyond them with query construction rules, relevance filtering (matched/dropped/relevanceChecked), lower-bound count semantics, include/exclude/prefer filtering order, exclude_items precedence, null-field behavior and the legacy condition caveat. This is exactly the behavioral context an agent needs to interpret results correctly.

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

Conciseness3/5

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

The opening sentence is front-loaded and purposeful, but the body degenerates into a dense semicolon chain that is hard to parse, e.g. the sentence about appending model or part_number. Several clauses duplicate schema facts, so the length is not entirely earned even though most content is substantive.

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?

For a 10-parameter, open-world search tool with an output schema, the description covers marketplace/currency resolution, filtering semantics, partial-failure cases and defaults, leaving no material gap for correct invocation. Return-value structure is appropriately left to the output schema.

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 already 100%, yet the description still adds cross-parameter meaning: include words are appended to the search, prefer never filters but reorders and summarizes separately, exclude_items is applied before every other filter, and limit affects only listing while count/summary cover everything. Some clauses merely restate schema defaults (limit 8–50, item numbers), so it is not fully additive.

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 verb and resource: fetch recent real eBay sold sales for a query, returning count, median and quartiles. It is far more specific than the name alone and implicitly separates itself from pricing tools by insisting on actual sold data, but it never names a sibling or contrasts its role with price_item or worth_it.

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?

"Use when the user wants to see what actually sold and for how much" gives a clear triggering condition, and the marketplace paragraph explains which site is used by default and when to set the marketplace parameter. It stops short of explicit exclusions, e.g. when to prefer because-you-want-a-valuation tools instead.

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