ebay-mcp

ebay_update_offer

Update an existing eBay offer by sending full details; enforce auction rules like reserve price above starting bid.

Instructions

Update an existing offer. Send the full offer details; the format itself cannot change. Auction fields (auctionStartPrice, auctionReservePrice, day-count listingDuration) follow the same rules as ebay_create_offer, and a reserve price must stay above the starting bid.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`body`	Yes
`offerId`	Yes	The offer ID

Schema Changelog

Changes observed during successful MCP inspections.

Changed4 schema fields changedv1.16.0Sep 22, 2026

addedInput schema / properties / body / additionalProperties
```
Added value: +true
```

removedInput schema / properties / body / description

Removed value: -"Generated EbayOfferDetailsWithId request body"

addedInput schema / properties / body / properties

Added value: +{
+  "availableQuantity": {
+    "description": "Purchasable quantity. FIXED_PRICE offers take any quantity; AUCTION offers list a single unit, so omit it or set it to 1",
+    "type": "number"
+  },
+  "categoryId": {
+    "type": "string"
+  },
+  "charity": {
+    "additionalProperties": false,
+    "properties": {
+      "charityId": {
+        "type": "string"
+      },
+      "donationPercentage": {
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "extendedProducerResponsibility": {
+    "additionalProperties": false,
+    "properties": {
+      "producerProductId": {
+        "type": "string"
+      },
+      "productDocumentationId": {
+        "type": "string"
+      },
+      "productPackageId": {
+        "type": "string"
+      },
+      "shipmentPackageId": {
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "hideBuyerDetails": {
+    "type": "boolean"
+  },
+  "includeCatalogProductDetails": {
+    "type": "boolean"
+  },
+  "listingDescription": {
+    "type": "string"
+  },
+  "listingDuration": {
+    "description": "FIXED_PRICE offers use GTC. AUCTION offers need a day count (DAYS_1, DAYS_3, DAYS_5, DAYS_7, or DAYS_10 everywhere; DAYS_14, DAYS_21, and DAYS_30 only where ebay_get_listing_type_policies lists them for the category) and never GTC",
+    "enum": [
+      "DAYS_1",
+      "DAYS_3",
+      "DAYS_5",
+      "DAYS_7",
+      "DAYS_10",
+      "DAYS_14",
+      "DAYS_21",
+      "DAYS_30",
+      "GTC"
+    ],
+    "type": "string"
+  },
+  "listingPolicies": {
+    "additionalProperties": true,
+    "properties": {
+      "bestOfferTerms": {
+        "additionalProperties": true,
+        "properties": {
+          "autoAcceptPrice": {
+            "additionalProperties": false,
+            "properties": {
+              "currency": {
+                "type": "string"
+              },
+              "value": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "currency",
+              "value"
+            ],
+            "type": "object"
+          },
+          "autoDeclinePrice": {
+            "$ref": "#/properties/body/properties/listingPolicies/properties/bestOfferTerms/properties/autoAcceptPrice"
+          },
+          "bestOfferEnabled": {
+            "description": "Enable Best Offer where the category allows it. On AUCTION offers it cannot be combined with a Buy It Now price (pricingSummary.price)",
+            "type": "boolean"
+          }
+        },
+        "type": "object"
+      },
+      "eBayPlusIfEligible": {
+        "description": "FIXED_PRICE offers only; not applicable to auctions",
+        "type": "boolean"
+      },
+      "fulfillmentPolicyId": {
+        "type": "string"
+      },
+      "paymentPolicyId": {
+        "type": "string"
+      },
+      "productCompliancePolicyIds": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "returnPolicyId": {
+        "type": "string"
+      },
+      "takeBackPolicyIds": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "type": "object"
+  },
+  "listingStartDate": {
+    "description": "Schedules the listing to go live later (ISO 8601 UTC). Only set it when the user explicitly asked for a scheduled start — eBay may charge a scheduling fee; never add it on your own",
+    "type": "string"
+  },
+  "lotSize": {
+    "type": "number"
+  },
+  "merchantLocationKey": {
+    "type": "string"
+  },
+  "pricingSummary": {
+    "additionalProperties": true,
+    "properties": {
+      "auctionReservePrice": {
+        "$ref": "#/properties/body/properties/listingPolicies/properties/bestOfferTerms/properties/autoAcceptPrice",
+        "description": "Optional AUCTION reserve; must be higher than auctionStartPrice and eBay charges a reserve fee whether or not the item sells"
+      },
+      "auctionStartPrice": {
+        "$ref": "#/properties/body/properties/listingPolicies/properties/bestOfferTerms/properties/autoAcceptPrice",
+        "description": "Opening bid for AUCTION offers (required before publish); not allowed on FIXED_PRICE offers"
+      },
+      "minimumAdvertisedPrice": {
+        "$ref": "#/properties/body/properties/listingPolicies/properties/bestOfferTerms/properties/autoAcceptPrice"
+      },
+      "originalRetailPrice": {
+        "$ref": "#/properties/body/properties/listingPolicies/properties/bestOfferTerms/properties/autoAcceptPrice"
+      },
+      "price": {
+        "$ref": "#/properties/body/properties/listingPolicies/properties/bestOfferTerms/properties/autoAcceptPrice",
+        "description": "Listing price for FIXED_PRICE offers (required before publish). For AUCTION offers this is the optional Buy It Now price, at least 30% above auctionStartPrice and not combinable with Best Offer"
+      },
+      "pricingVisibility": {
+        "enum": [
+          "NONE",
+          "PRE_CHECKOUT",
+          "DURING_CHECKOUT"
+        ],
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "quantityLimitPerBuyer": {
+    "description": "Per-buyer purchase cap for FIXED_PRICE offers; not applicable to auctions",
+    "type": "number"
+  },
+  "secondaryCategoryId": {
+    "type": "string"
+  },
+  "storeCategoryNames": {
+    "items": {
+      "type": "string"
+    },
+    "type": "array"
+  },
+  "tax": {
+    "additionalProperties": true,
+    "properties": {
+      "applyTax": {
+        "type": "boolean"
+      },
+      "thirdPartyTaxCategory": {
+        "type": "string"
+      },
+      "vatPercentage": {
+        "type": "number"
+      }
+    },
+    "type": "object"
+  }
+}

addedInput schema / properties / body / type
```
Added value: +"object"
```

Addedv1.14.1Jul 22, 2026
Removedv1.14.1Jul 22, 2026
First observedv1.8.10May 31, 2026

TDQS

A3.7/5.0

Behavior3/5

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

With no annotations provided, the description bears the full burden and does disclose important constraints: full details must be sent, format cannot change, and auction rules (including reserve price above start bid) apply. However, it does not address state prerequisites, effects on published offers, or failure behavior, which leaves gaps for a mutation tool.

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?

Three sentences with no filler; the purpose is front-loaded and each sentence adds a distinct constraint. It is concise without sacrificing the most important usage information.

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

Completeness3/5

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

For a tool with a large nested body, no output schema, and no annotations, the description covers the core update semantics and auction-specific rules but omits practical context such as retrieving the existing offer first, state restrictions, and how omissions in the body are handled. It is adequate but not complete.

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 only 50%, and the description adds modest value by naming auctionStartPrice, auctionReservePrice, and listingDuration and pointing to create-offer rules. It does not compensate for the many undocumented nested fields, and most parameter semantics still rely on the schema.

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 description opens with 'Update an existing offer,' a specific verb and resource that clearly distinguishes this tool from ebay_create_offer, ebay_delete_offer, and ebay_publish_offer. It also adds the scope constraint that the format itself cannot change, which further clarifies its role.

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

Usage Guidelines3/5

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

It gives the key instruction to send full offer details and cross-references ebay_create_offer for auction field rules, but it never explicitly states when to choose this tool over alternatives or when not to use it. The usage context is implied by the name and sibling list rather than spelled out.

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

Deploy Server

ebay_update_offer

Instructions

Input Schema

Schema Changelog

TDQS

Other Tools