TraydStar

Edit a listing

update_listing

Destructive

Use this when the user wants to change one of their own active listings. Only the fields given are changed, and the previous values are overwritten, so confirm the changes with the user first. A listing that is part of a trade in progress can't be changed. Photos can't be changed here.

Input Schema

Name	Required	Description
`type`	No	GOOD, SERVICE, or BOTH
`title`	No	New title
`details`	No	Only for Trading Cards and Sneakers listings: the facts collectors trade on. Use the card fields for Trading Cards and the sneaker fields for Sneakers.
`category`	No	New category
`condition`	No	Condition, for physical goods
`want_tags`	No	Replaces the tags for what the user wants in exchange
`listing_id`	Yes	The user's listing to change
`description`	No	New description
`subcategory`	No	A subcategory of the listing's category. Cameras & Photo: Camera Bodies, Lenses, Film Cameras, Lighting & Flash, Tripods & Support, Bags & Accessories, Video & Drones. Trading Cards: Pokémon, Magic: The Gathering, Yu-Gi-Oh!, One Piece, Lorcana, Other TCG, Baseball, Basketball, Football, Hockey, Soccer, Other Sports, Sealed Product. Sneakers: Jordan, Nike, Adidas, New Balance, Asics, Other Brands. Collectibles: Coins & Currency, Comics, Toys & Figures, LEGO, Vinyl, Sports Memorabilia, Other Collectibles.
`stated_value_usd`	No	The user's own estimate of its value in US dollars
`want_description`	No	What the user would like in exchange

Output Schema

Name	Required	Description	Default
`success`	No
`listing_id`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed3 schema fields changedOct 30, 2026

changedInput schema / properties / category / enum

Previous value: -[
-  "Cameras & Photo",
-  "Electronics",
-  "Collectibles",
-  "Sports & Outdoors",
-  "Home & Garden",
-  "Clothing & Accessories",
-  "Books & Media",
-  "Vehicles & Parts",
-  "Art & Crafts",
-  "Other Goods",
-  "Design Services",
-  "Tech Services",
-  "Creative Services",
-  "Professional Services",
-  "Home Services",
-  "Other Services"
-]New value: +[
+  "Cameras & Photo",
+  "Trading Cards",
+  "Sneakers",
+  "Electronics",
+  "Collectibles",
+  "Sports & Outdoors",
+  "Home & Garden",
+  "Clothing & Accessories",
+  "Books & Media",
+  "Vehicles & Parts",
+  "Art & Crafts",
+  "Other Goods",
+  "Design Services",
+  "Tech Services",
+  "Creative Services",
+  "Professional Services",
+  "Home Services",
+  "Other Services"
+]

addedInput schema / properties / details

Added value: +{
+  "additionalProperties": false,
+  "description": "Only for Trading Cards and Sneakers listings: the facts collectors trade on. Use the card fields for Trading Cards and the sneaker fields for Sneakers.",
+  "properties": {
+    "box": {
+      "description": "Sneakers: comes with the original box",
+      "type": "boolean"
+    },
+    "card_condition": {
+      "description": "Trading Cards: condition of a raw card",
+      "enum": [
+        "Near Mint",
+        "Lightly Played",
+        "Moderately Played",
+        "Heavily Played",
+        "Damaged"
+      ],
+      "type": "string"
+    },
+    "card_number": {
+      "description": "Trading Cards: number on the card, e.g. 4/102",
+      "maxLength": 20,
+      "type": "string"
+    },
+    "cert_number": {
+      "description": "Trading Cards: certification number on the slab label, so the other side can look it up",
+      "maxLength": 24,
+      "type": "string"
+    },
+    "colorway": {
+      "description": "Sneakers: colorway name",
+      "maxLength": 80,
+      "type": "string"
+    },
+    "grade": {
+      "description": "Trading Cards: grade on the slab, e.g. 10 or 9.5",
+      "maxLength": 12,
+      "type": "string"
+    },
+    "graded": {
+      "description": "Trading Cards: true for a slabbed card (then give grader and grade), false or omitted for raw",
+      "type": "boolean"
+    },
+    "grader": {
+      "description": "Trading Cards: grading company of a graded card",
+      "enum": [
+        "PSA",
+        "BGS",
+        "CGC",
+        "SGC",
+        "Other"
+      ],
+      "type": "string"
+    },
+    "model": {
+      "description": "Sneakers: model, e.g. Air Jordan 1 High OG",
+      "maxLength": 80,
+      "type": "string"
+    },
+    "receipt": {
+      "description": "Sneakers: comes with proof of purchase",
+      "type": "boolean"
+    },
+    "set": {
+      "description": "Trading Cards: set or series, e.g. Base Set, 2023 Topps Chrome",
+      "maxLength": 80,
+      "type": "string"
+    },
+    "size": {
+      "description": "Sneakers: US size, half sizes allowed (needs size_group)",
+      "maximum": 20,
+      "minimum": 1,
+      "type": "number"
+    },
+    "size_group": {
+      "description": "Sneakers: which US size run",
+      "enum": [
+        "Men's",
+        "Women's",
+        "Youth"
+      ],
+      "type": "string"
+    },
+    "sneaker_condition": {
+      "description": "Sneakers: condition",
+      "enum": [
+        "New with box",
+        "New without box",
+        "Worn once",
+        "Used"
+      ],
+      "type": "string"
+    },
+    "style_code": {
+      "description": "Sneakers: style code from the box or tag",
+      "maxLength": 20,
+      "type": "string"
+    },
+    "subject": {
+      "description": "Trading Cards: player or character",
+      "maxLength": 80,
+      "type": "string"
+    },
+    "variant": {
+      "description": "Trading Cards: holo, 1st edition, parallel, refractor and so on",
+      "maxLength": 80,
+      "type": "string"
+    },
+    "year": {
+      "description": "Trading Cards: year printed",
+      "maximum": 2100,
+      "minimum": 1860,
+      "type": "integer"
+    }
+  },
+  "type": "object"
+}

changedInput schema / properties / subcategory / description

Previous value: -"A subcategory of the listing's category"New value: +"A subcategory of the listing's category. Cameras & Photo: Camera Bodies, Lenses, Film Cameras, Lighting & Flash, Tripods & Support, Bags & Accessories, Video & Drones. Trading Cards: Pokémon, Magic: The Gathering, Yu-Gi-Oh!, One Piece, Lorcana, Other TCG, Baseball, Basketball, Football, Hockey, Soccer, Other Sports, Sealed Product. Sneakers: Jordan, Nike, Adidas, New Balance, Asics, Other Brands. Collectibles: Coins & Currency, Comics, Toys & Figures, LEGO, Vinyl, Sports Memorabilia, Other Collectibles."

First observedOct 16, 2026

TDQS

A4.4/5.0

Behavior5/5

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

Annotations only declare destructiveHint/openWorldHint; the description adds the substantive behavior: it is a partial update (only supplied fields change), prior values are lost, user confirmation should precede the call, and edits are blocked mid-trade. That is exactly the pre-call context the annotations cannot supply.

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

Conciseness5/5

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

Four short sentences, front-loaded with the selection criterion, then mutation semantics, then the confirmation warning, then the two constraints. Nothing is redundant and nothing is buried.

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 an 11-parameter destructive mutation it covers the essential risks: partial update semantics, data loss, confirmation, and blocked states. An output schema exists so return values need not be explained; the only mild gap is no note on cross-field consistency, e.g. changing category/type while details stay for the old category.

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 description coverage is 100%, with enum values and nested details fields fully documented, so the schema carries the parameter burden and baseline 3 applies. The description adds only the negative case that photos cannot be changed here, with no field-level guidance beyond that.

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?

States a specific verb and resource (change/edit an existing listing) and scopes it to 'one of their own active listings', which cleanly separates it from create_listing, remove_listing and set_listing_status. An agent can identify the operation 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?

Gives clear use conditions ('when the user wants to change one of their own active listings') plus two explicit exclusions: listings in a trade in progress and photos. It does not name a sibling tool for the photo case, so the routing guidance is strong but not fully closed.

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

All TraydStar tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.