Skip to main content
Glama

Price an item

price_item

What a secondhand item sells for on eBay: a calibrated estimate with a range, the recent real eBay sales behind it (sold comps, linked where the source gives a link), three list prices (fast, market, patient) with the 14-day sell chance, what the seller keeps after eBay fees, and a worth-it verdict when you pass what the user would pay. A description price 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; price.currency names the currency. A photo price (photo, a file the user uploaded in the chat, or image_url, a public https link) needs the user signed in through the connector: it runs a real scan on their account, priced in their own eBay marketplace and currency (price.currency). Without sign-in, describe the item; a description works but reads less than a photo.

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": "price_item"
  }
}

Input Schema

NameRequiredDescriptionDefault
costNoWhat the user paid or would pay for it, for a worth-it verdict, in the currency the price comes back in (price.currency): the seller's own currency when signed in, USD otherwise, or the currency of the marketplace you pass.
sizeNoSize as printed on the tag or measured (for example "M", "10.5", "36 x 36 in", "2.5 quart"). Fill it from the item or label when you can read it.
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.
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.
photoNoA photo the user uploaded in this conversation (ChatGPT passes it as a file). Preferred over a description.
conditionNoCondition as the user states it or as you see it on the item. Open box counts as Like New. "For parts or not working" is for an item that does not work, is broken, or is sold for repair or parts; it is priced against parts sales. When the description says for parts or not working, that wins over this field. Leave empty when unknown.
image_urlNoPublic https URL of a photo of the item. Preferred over description alone.
descriptionNoWhat the item is: brand, model or pattern, size, any marks, completeness.
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.

Output Schema

NameRequiredDescriptionDefault
askNo
tipNo
itemNo
nextNo
textNo
compsNoThe recent sales the price rests on.
priceNo
pricedNoFalse when the description was too thin to price; then `ask` says what to ask the user.
sourceNoAttribution to show the user.
accountNo
worthItNoPresent when a cost was given.
listPricesNoThree list prices and the share of sales at each that sold within 14 days.
marketplaceNo
unstructuredNoTrue: read `text`.
netAfterEbayFeesNo

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": {
      +      "anyOf": [
      +        {
      +          "additionalProperties": {},
      +          "properties": {
      +            "billing": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "compsPending": {
      +              "description": "True when recent sales are still loading; call get_scan_result in about 20 seconds.",
      +              "type": "boolean"
      +            },
      +            "creditsLeft": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "savedToHistory": {
      +              "type": "boolean"
      +            },
      +            "scanId": {
      +              "description": "Pass to get_scan_result or list_on_ebay.",
      +              "type": "string"
      +            },
      +            "subscriptionStatus": {
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "textPrice": {
      +              "type": "boolean"
      +            },
      +            "usage": {
      +              "additionalProperties": {},
      +              "description": "A note on this account's connector use, when one is due.",
      +              "properties": {},
      +              "type": "object"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ]
      +    },
      +    "ask": {
      +      "type": "string"
      +    },
      +    "comps": {
      +      "additionalProperties": {},
      +      "description": "The recent sales the price rests on.",
      +      "properties": {
      +        "count": {
      +          "type": "number"
      +        },
      +        "recent": {
      +          "items": {
      +            "additionalProperties": {},
      +            "properties": {
      +              "price": {
      +                "type": "number"
      +              },
      +              "soldDate": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              },
      +              "title": {
      +                "type": "string"
      +              },
      +              "url": {
      +                "type": [
      +                  "string",
      +                  "null"
      +                ]
      +              }
      +            },
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "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"
      +        },
      +        "unrelatedHidden": {
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "item": {
      +      "additionalProperties": {},
      +      "properties": {
      +        "brand": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "category": {
      +          "type": "string"
      +        },
      +        "condition": {
      +          "type": "string"
      +        },
      +        "confidence": {
      +          "description": "0 to 1.",
      +          "type": "number"
      +        },
      +        "identifiedFrom": {
      +          "description": "photo or description.",
      +          "type": "string"
      +        },
      +        "name": {
      +          "type": "string"
      +        },
      +        "notes": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "listPrices": {
      +      "anyOf": [
      +        {
      +          "additionalProperties": {},
      +          "properties": {
      +            "fast": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "price": {
      +                  "type": "number"
      +                },
      +                "sold14Pct": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "market": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "price": {
      +                  "type": "number"
      +                },
      +                "sold14Pct": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "patient": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "price": {
      +                  "type": "number"
      +                },
      +                "sold14Pct": {
      +                  "type": [
      +                    "number",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "description": "Three list prices and the share of sales at each that sold within 14 days."
      +    },
      +    "marketplace": {
      +      "additionalProperties": {},
      +      "properties": {
      +        "id": {
      +          "type": "string"
      +        },
      +        "name": {
      +          "type": "string"
      +        },
      +        "note": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "netAfterEbayFees": {
      +      "type": "number"
      +    },
      +    "next": {
      +      "additionalProperties": {},
      +      "properties": {
      +        "listThisItem": {
      +          "description": "Opens the eBay listing flow on the saved scan.",
      +          "type": "string"
      +        },
      +        "note": {
      +          "type": "string"
      +        },
      +        "savedScan": {
      +          "type": "string"
      +        },
      +        "say": {
      +          "description": "A sentence to show the user, with the link in it.",
      +          "type": "string"
      +        },
      +        "scanWithPhoto": {
      +          "type": "string"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "price": {
      +      "additionalProperties": {},
      +      "properties": {
      +        "basis": {
      +          "description": "What the estimate rests on.",
      +          "type": "string"
      +        },
      +        "currency": {
      +          "description": "ISO code of every amount in this answer.",
      +          "type": "string"
      +        },
      +        "display": {
      +          "description": "The price as the app words it, when it differs from the number.",
      +          "type": "string"
      +        },
      +        "estimate": {
      +          "type": "number"
      +        },
      +        "high": {
      +          "type": "number"
      +        },
      +        "low": {
      +          "type": "number"
      +        }
      +      },
      +      "type": "object"
      +    },
      +    "priced": {
      +      "description": "False when the description was too thin to price; then `ask` says what to ask the user.",
      +      "type": "boolean"
      +    },
      +    "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"
      +    },
      +    "tip": {
      +      "type": "string"
      +    },
      +    "unstructured": {
      +      "description": "True: read `text`.",
      +      "type": "boolean"
      +    },
      +    "worthIt": {
      +      "anyOf": [
      +        {
      +          "additionalProperties": {},
      +          "properties": {
      +            "cost": {
      +              "type": "number"
      +            },
      +            "label": {
      +              "description": "The verdict in words.",
      +              "type": "string"
      +            },
      +            "netAfterEbayFees": {
      +              "description": "What the seller keeps after eBay fees.",
      +              "type": "number"
      +            },
      +            "profit": {
      +              "type": "number"
      +            },
      +            "verdict": {
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "description": "Present when a cost was given."
      +    }
      +  },
      +  "type": "object"
      +}
  2. Changed1 schema field changed
    • addedInput schema / properties / photo
      Added value: +{
      +  "anyOf": [
      +    {
      +      "properties": {
      +        "download_url": {
      +          "format": "uri",
      +          "maxLength": 4000,
      +          "type": "string"
      +        },
      +        "file_id": {
      +          "maxLength": 200,
      +          "type": "string"
      +        },
      +        "file_name": {
      +          "anyOf": [
      +            {
      +              "maxLength": 300,
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "mime_type": {
      +          "anyOf": [
      +            {
      +              "maxLength": 100,
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        }
      +      },
      +      "required": [
      +        "download_url",
      +        "file_id"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "A photo the user uploaded in this conversation (ChatGPT passes it as a file). Preferred over a description."
      +}
  3. Changed2 schema fields changed
    • changedInput schema / properties / cost / description
      Previous value: -"What the user paid or would pay for it, for a worth-it verdict: in USD, or in the seller's own currency for a photo scan on a signed-in account."New value: +"What the user paid or would pay for it, for a worth-it verdict, in the currency the price comes back in (price.currency): the seller's own currency when signed in, USD otherwise, or the currency of the marketplace you pass."
    • 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"
      +}
  4. Changed6 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"
      +}
    • changedInput schema / properties / condition / description
      Previous value: -"Condition as the user states it."New value: +"Condition as the user states it or as you see it on the item. Open box counts as Like New. \"For parts or not working\" is for an item that does not work, is broken, or is sold for repair or parts; it is priced against parts sales. When the description says for parts or not working, that wins over this field. Leave empty when unknown."
    • changedInput schema / properties / condition / enum
      Previous value: -[
      -  "New",
      -  "Like New",
      -  "Good",
      -  "Fair",
      -  "Poor"
      -]New value: +[
      +  "New",
      +  "Like New",
      +  "Good",
      +  "Fair",
      +  "Poor",
      +  "For parts or not working"
      +]
    • 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"
      +}
    • addedInput schema / properties / size
      Added value: +{
      +  "description": "Size as printed on the tag or measured (for example \"M\", \"10.5\", \"36 x 36 in\", \"2.5 quart\"). Fill it from the item or label when you can read it.",
      +  "maxLength": 60,
      +  "minLength": 1,
      +  "type": "string"
      +}
  5. Changed1 schema field changed
    • changedInput schema / properties / cost / description
      Previous value: -"What the user paid or would pay for it, in USD, for a worth-it verdict."New value: +"What the user paid or would pay for it, for a worth-it verdict: in USD, or in the seller's own currency for a photo scan on a signed-in account."
  6. First observed

TDQS

A4/5.0
Behavior4/5

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

Beyond the annotations (readOnlyHint=false, openWorldHint=true, idempotentHint=false, destructiveHint=false), the description discloses an important non-obvious trait: a photo price 'runs a real scan on their account' and requires the user to be signed in through the connector. It also explains the marketplace/currency resolution rules (seller's marketplace when signed in, EBAY_US/USD otherwise), which annotations alone cannot convey. It stops short of stating rate limits, cost, or latency for that account-level scan.

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 lead sentence is well front-loaded around the outputs, but the whole thing is a single dense wall of text where the critical constraint (photo requires sign-in) is buried mid-paragraph. The repeated 'price.currency names the currency' phrasing references a field that is not in the schema, so it is not just verbose but actively misleading. Trimmed and split into input-mode and output sections it would be materially easier to act on.

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

Completeness4/5

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

For a 10-parameter, zero-required, open-world tool with an output schema, the definition covers the hard parts: which input mode to use, auth requirements, and marketplace/currency defaults. It does not say what happens when no inputs are supplied at all despite every parameter being optional, and the phantom price.currency reference leaves the currency contract slightly unclear. Outputs are spelled out even though an output schema exists, which is redundant but harmless.

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% and the parameters are richly self-documented, so the baseline is 3; the description only adds the preference ordering ('a description works but reads less than a photo'). It also references 'price.currency' repeatedly even though no such parameter exists in the schema, which adds confusion rather than meaning. No additional per-parameter semantics beyond what the schema already states.

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 opening sentence names the specific resource and scope ('what a secondhand item sells for on eBay') and enumerates the concrete deliverables: a calibrated range, sold comps, three list prices with 14-day sell chance, fees, and a worth-it verdict. An agent can tell exactly what this returns without opening the output schema, and it is clearly distinct from narrower siblings like get_sold_comps 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?

It gives explicit routing for the main decision points: description vs photo input, signed-in vs anonymous behavior, and when to pass marketplace ('set it only when the user asks about a market other than their own'). It explicitly states the fallback when sign-in is unavailable ('Without sign-in, describe the item'). What it lacks is any guidance relative to siblings such as worth_it or find_underpriced, so an agent must infer when this broad tool is preferable to those.

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