Skip to main content
Glama

ebay_create_offer

Create an unpublished listing draft for an inventory SKU, supporting fixed-price and auction formats with pricing, duration, and policies.

Instructions

Create a new offer (unpublished listing draft) for an inventory item SKU.

FIXED_PRICE offers take pricingSummary.price and listingDuration GTC. AUCTION offers take pricingSummary.auctionStartPrice (opening bid), an optional auctionReservePrice above it, an optional pricingSummary.price as Buy It Now (at least 30% above the opening bid, and not together with Best Offer), a day-count listingDuration (DAYS_1/3/5/7/10, or DAYS_14/21/30 where the category allows; never GTC), availableQuantity omitted or 1, and no per-buyer limit or eBay Plus. Do not add listingStartDate unless the user asked for a scheduled start (it can incur a fee). Bodies that mix the two formats are rejected before any eBay request.

Check ebay_get_listing_type_policies for the formats and durations the category allows, then ebay_get_listing_fees (reserve prices carry a fee) before ebay_publish_offer.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
bodyYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed5 schema fields changedv1.16.0
    • addedInput schema / properties / body / additionalProperties
      Added value: +true
    • removedInput schema / properties / body / description
      Removed value: -"Generated EbayOfferDetailsWithKeys 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"
      +  },
      +  "format": {
      +    "description": "FIXED_PRICE (price + GTC) or AUCTION (auctionStartPrice + day-count listingDuration; availableQuantity omitted or 1)",
      +    "enum": [
      +      "AUCTION",
      +      "FIXED_PRICE"
      +    ],
      +    "type": "string"
      +  },
      +  "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"
      +  },
      +  "marketplaceId": {
      +    "enum": [
      +      "EBAY_AT",
      +      "EBAY_AU",
      +      "EBAY_BE",
      +      "EBAY_CA",
      +      "EBAY_CH",
      +      "EBAY_CN",
      +      "EBAY_CZ",
      +      "EBAY_DE",
      +      "EBAY_DK",
      +      "EBAY_ES",
      +      "EBAY_FI",
      +      "EBAY_FR",
      +      "EBAY_GB",
      +      "EBAY_GR",
      +      "EBAY_HK",
      +      "EBAY_HU",
      +      "EBAY_ID",
      +      "EBAY_IE",
      +      "EBAY_IL",
      +      "EBAY_IN",
      +      "EBAY_IT",
      +      "EBAY_JP",
      +      "EBAY_MY",
      +      "EBAY_NL",
      +      "EBAY_NO",
      +      "EBAY_NZ",
      +      "EBAY_PE",
      +      "EBAY_PH",
      +      "EBAY_PL",
      +      "EBAY_PR",
      +      "EBAY_PT",
      +      "EBAY_RU",
      +      "EBAY_SE",
      +      "EBAY_SG",
      +      "EBAY_TH",
      +      "EBAY_TW",
      +      "EBAY_US",
      +      "EBAY_VN",
      +      "EBAY_ZA",
      +      "EBAY_HALF_US",
      +      "EBAY_MOTORS_US"
      +    ],
      +    "type": "string"
      +  },
      +  "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"
      +  },
      +  "sku": {
      +    "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 / required
      Added value: +[
      +  "sku",
      +  "marketplaceId",
      +  "format"
      +]
    • addedInput schema / properties / body / type
      Added value: +"object"
  2. Changed3 schema fields changedv1.14.1
    • addedInput schema / properties / body
      Added value: +{
      +  "description": "Generated EbayOfferDetailsWithKeys request body"
      +}
    • removedInput schema / properties / offer
      Removed value: -{
      -  "additionalProperties": true,
      -  "description": "Offer details including SKU, marketplace, pricing, and policies",
      -  "properties": {
      -    "availableQuantity": {
      -      "type": "number"
      -    },
      -    "categoryId": {
      -      "type": "string"
      -    },
      -    "format": {
      -      "enum": [
      -        "AUCTION",
      -        "FIXED_PRICE"
      -      ],
      -      "type": "string"
      -    },
      -    "listingDescription": {
      -      "type": "string"
      -    },
      -    "listingPolicies": {
      -      "additionalProperties": true,
      -      "properties": {
      -        "bestOfferTerms": {
      -          "additionalProperties": true,
      -          "properties": {
      -            "autoAcceptPrice": {
      -              "additionalProperties": true,
      -              "properties": {
      -                "currency": {
      -                  "type": "string"
      -                },
      -                "value": {
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "currency",
      -                "value"
      -              ],
      -              "type": "object"
      -            },
      -            "autoDeclinePrice": {
      -              "$ref": "#/properties/offer/properties/listingPolicies/properties/bestOfferTerms/properties/autoAcceptPrice"
      -            },
      -            "bestOfferEnabled": {
      -              "type": "boolean"
      -            }
      -          },
      -          "type": "object"
      -        },
      -        "eBayPlusIfEligible": {
      -          "type": "boolean"
      -        },
      -        "fulfillmentPolicyId": {
      -          "type": "string"
      -        },
      -        "paymentPolicyId": {
      -          "type": "string"
      -        },
      -        "returnPolicyId": {
      -          "type": "string"
      -        }
      -      },
      -      "type": "object"
      -    },
      -    "marketplaceId": {
      -      "type": "string"
      -    },
      -    "merchantLocationKey": {
      -      "type": "string"
      -    },
      -    "pricingSummary": {
      -      "additionalProperties": true,
      -      "properties": {
      -        "minimumAdvertisedPrice": {
      -          "$ref": "#/properties/offer/properties/listingPolicies/properties/bestOfferTerms/properties/autoAcceptPrice"
      -        },
      -        "originalRetailPrice": {
      -          "$ref": "#/properties/offer/properties/listingPolicies/properties/bestOfferTerms/properties/autoAcceptPrice"
      -        },
      -        "price": {
      -          "$ref": "#/properties/offer/properties/listingPolicies/properties/bestOfferTerms/properties/autoAcceptPrice"
      -        },
      -        "pricingVisibility": {
      -          "enum": [
      -            "NONE",
      -            "PRE_CHECKOUT",
      -            "DURING_CHECKOUT"
      -          ],
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "price"
      -      ],
      -      "type": "object"
      -    },
      -    "quantityLimitPerBuyer": {
      -      "type": "number"
      -    },
      -    "sku": {
      -      "type": "string"
      -    },
      -    "tax": {
      -      "additionalProperties": true,
      -      "properties": {
      -        "applyTax": {
      -          "type": "boolean"
      -        },
      -        "thirdPartyTaxCategory": {
      -          "type": "string"
      -        },
      -        "vatPercentage": {
      -          "type": "number"
      -        }
      -      },
      -      "type": "object"
      -    }
      -  },
      -  "required": [
      -    "sku",
      -    "marketplaceId",
      -    "format"
      -  ],
      -  "type": "object"
      -}
    • changedInput schema / required
      Previous value: -[
      -  "offer"
      -]New value: +[
      +  "body"
      +]
  3. First observedv1.8.10

TDQS

A4.7/5.0
Behavior5/5

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

With no annotations provided, the description carries the full burden and delivers. It discloses fee implications ('reserve prices carry a fee', listingStartDate 'can incur a fee'), validation rejection behavior ('Bodies that mix the two formats are rejected before any eBay request'), and mutual-exclusion constraints (Buy It Now 'not together with Best Offer'). The description even warns against adding listingStartDate unprompted.

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?

Dense but every sentence earns its place. The purpose is front-loaded, then the format split (FIXED_PRICE vs AUCTION) organizes the rules cleanly, followed by the workflow caveats. The two-format breakdown avoids repetition by grouping constraints per format rather than listing them per-field.

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 tool with 1 deeply nested parameter object and 0% top-level schema coverage, the description covers the critical format-specific pitfalls, fee implications, and the required workflow (check policies → check fees → publish). It also flags the scheduled-start fee risk. The only omission is that it doesn't describe the return value, but with no output schema and a draft-creation use case, this is minor.

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 description coverage is 0% at the top level, so the description must compensate for parameter meaning. It thoroughly explains pricingSummary.price, auctionStartPrice, auctionReservePrice, availableQuantity, listingDuration, and listingStartDate with format-specific rules. However, it leaves several nested parameters (tax, charity, lotSize, listingPolicies, hideBuyerDetails, storeCategoryNames, merchantLocationKey, extendedProducerResponsibility) unexplained in the description, relying on the schema's field descriptions for those.

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?

Opens with a specific verb+resource pair ('Create a new offer (unpublished listing draft) for an inventory item SKU') that immediately distinguishes it from siblings like ebay_publish_offer, ebay_bulk_create_offer, and ebay_update_offer. The 'unpublished listing draft' clarification removes ambiguity about whether this tool publishes.

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?

Explicitly routes the agent through prerequisite checks: 'Check ebay_get_listing_type_policies for the formats and durations the category allows, then ebay_get_listing_fees... before ebay_publish_offer.' It establishes a clear workflow order. However, it doesn't mention when to prefer ebay_bulk_create_offer for bulk scenarios or explicitly say 'use X instead when...'.

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

Deploy Server

Other Tools