Skip to main content
Glama

ebay_bulk_create_offer

Bulk create up to 25 eBay offers in a single request, automatically applying correct pricing, listing duration, and format rules for fixed-price and auction listings.

Instructions

Bulk create up to 25 offers in one request. Each request follows the ebay_create_offer rules: 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.

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: +false
    • removedInput schema / properties / body / description
      Removed value: -"Generated BulkEbayOfferDetailsWithKeys request body"
    • addedInput schema / properties / body / properties
      Added value: +{
      +  "requests": {
      +    "items": {
      +      "additionalProperties": true,
      +      "properties": {
      +        "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/requests/items/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/requests/items/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/requests/items/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/requests/items/properties/listingPolicies/properties/bestOfferTerms/properties/autoAcceptPrice"
      +            },
      +            "originalRetailPrice": {
      +              "$ref": "#/properties/body/properties/requests/items/properties/listingPolicies/properties/bestOfferTerms/properties/autoAcceptPrice"
      +            },
      +            "price": {
      +              "$ref": "#/properties/body/properties/requests/items/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"
      +        }
      +      },
      +      "required": [
      +        "sku",
      +        "marketplaceId",
      +        "format"
      +      ],
      +      "type": "object"
      +    },
      +    "type": "array"
      +  }
      +}
    • addedInput schema / properties / body / required
      Added value: +[
      +  "requests"
      +]
    • addedInput schema / properties / body / type
      Added value: +"object"
  2. Changed3 schema fields changedv1.14.1
    • addedInput schema / properties / body
      Added value: +{
      +  "description": "Generated BulkEbayOfferDetailsWithKeys request body"
      +}
    • removedInput schema / properties / requests
      Removed value: -{
      -  "additionalProperties": true,
      -  "description": "Bulk offer creation requests",
      -  "properties": {
      -    "requests": {
      -      "items": {
      -        "additionalProperties": true,
      -        "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/requests/properties/requests/items/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/requests/properties/requests/items/properties/listingPolicies/properties/bestOfferTerms/properties/autoAcceptPrice"
      -              },
      -              "originalRetailPrice": {
      -                "$ref": "#/properties/requests/properties/requests/items/properties/listingPolicies/properties/bestOfferTerms/properties/autoAcceptPrice"
      -              },
      -              "price": {
      -                "$ref": "#/properties/requests/properties/requests/items/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"
      -      },
      -      "type": "array"
      -    }
      -  },
      -  "required": [
      -    "requests"
      -  ],
      -  "type": "object"
      -}
    • changedInput schema / required
      Previous value: -[
      -  "requests"
      -]New value: +[
      +  "body"
      +]
  3. First observedv1.8.10

TDQS

A4.4/5.0
Behavior4/5

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

With no annotations, the description carries the full behavioral disclosure burden. It goes beyond the schema by warning that listingStartDate can incur a fee, stating that mixed-format bodies are rejected before any eBay request, and clarifying format-specific restrictions like no per-buyer limit or eBay Plus for auctions. It does not cover partial-failure behavior or rate limits, but it is substantially informative.

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

Conciseness4/5

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

The description is dense but every sentence carries rule content; there is no filler. It is front-loaded with the core purpose and max limit, then details format-specific rules and a fee warning. It could be more scannable, but the length is justified by the complexity of the supported offer formats.

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?

Given the complex nested schema and absence of both annotations and output schema, the description covers the critical decisions: format selection, pricing fields, listing duration, quantity, Best Offer, eBay Plus, and scheduling. Missing details like partial-failure semantics or behavior when exceeding 25 offers are not addressed, but the description is strong enough for an agent to invoke the tool with correct intent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is effectively 0% for the top-level parameter, and the description compensates extensively. It maps FIXED_PRICE vs AUCTION formats to their required and optional fields, adds cross-field constraints like the 30% Buy It Now margin and incompatibility with Best Offer, and clarifies auction-specific rules such as availableQuantity omitted or 1. This is far more semantically useful than the raw 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 a specific verb and resource: 'Bulk create up to 25 offers in one request.' It clearly distinguishes this tool from ebay_create_offer by emphasizing the bulk aspect and immediately scoping the operation to a maximum of 25 offers.

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?

The description gives clear context for when to use the tool — bulk offer creation — and states that each request must follow ebay_create_offer rules. It does not explicitly name alternatives or exclusion conditions, such as 'use ebay_create_offer for a single offer,' but the bulk framing and detailed constraints make the intended usage clear.

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