eBay product
run_ebay_productGet eBay catalog product details by ePID: brand, model, rating, price range, and specs. Flat 5 points per successful run.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| product | Yes | ePID or URL. e.g. 1234567890 |
run_ebay_productGet eBay catalog product details by ePID: brand, model, rating, price range, and specs. Flat 5 points per successful run.
| Name | Required | Description | Default |
|---|---|---|---|
| product | Yes | ePID or URL. e.g. 1234567890 |
Changes observed during successful MCP inspections.
Input schema / properties / product / descriptionPrevious value: -"eBay catalog product ID (ePID) or product URL."New value: +"ePID or URL. e.g. 1234567890"Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It usefully discloses the response payload (brand, model, rating, price range, specs) and the cost model ('Flat 5 points per successful run'), but says nothing about permissions, rate limits, failure behavior, or what happens with an invalid ePID.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two tight sentences with the lookup key and payload front-loaded and the cost note appended. Nothing is wasted, though it is minimal rather than exemplary.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
There is no output schema, so the description correctly compensates by listing the returned fields, and it adds the point-cost disclosure. It is nearly sufficient for a one-parameter lookup, with only error/auth behavior left unstated.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% and the single parameter is already documented as 'ePID or URL. e.g. 1234567890'. The description reinforces that the lookup is by ePID but adds no format or validation detail beyond the schema, so baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource ('Get eBay catalog product details by ePID') and even enumerates the returned fields. It implicitly separates catalog products from listing-level siblings like run_ebay_item, but never names or contrasts with any sibling, so differentiation is left to inference.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No when-to-use or when-not-to-use guidance and no mention of alternatives such as run_ebay_item, run_ebay_item_search, or run_ebay_product_reviews. An agent with ~130 sibling tools gets no routing help from the description.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.