eBay MCP

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "_dmd": {
      "type": "string",
      "description": "Result layout: 'Grid' or 'List'. Cosmetic; does not change the items returned."
    },
    "_ipg": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Results per page. Allowed values: 25, 50 (default), 100, 200."
    },
    "_nkw": {
      "type": "string",
      "description": "Search query — anything you'd type in eBay's search box. Required unless category_id is set."
    },
    "_pgn": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number (1-based). Default 1."
    },
    "_sop": {
      "type": "string",
      "description": "Sort order code: '12' = Best Match (default), '1' = ending soonest, '10' = newly listed, '15' = price+shipping lowest first, '16' = price+shipping highest first."
    },
    "_blrs": {
      "type": "string",
      "description": "Set to 'spell_auto_correct' to exclude results from an auto-corrected spelling of the query."
    },
    "_sasl": {
      "type": "string",
      "description": "Seller username(s) to filter by, comma-separated."
    },
    "_udhi": {
      "type": "number",
      "minimum": 0,
      "description": "Maximum price (in the marketplace currency)."
    },
    "_udlo": {
      "type": "number",
      "minimum": 0,
      "description": "Minimum price (in the marketplace currency)."
    },
    "_salic": {
      "type": "string",
      "description": "Filter items by location, as a country code (e.g. '1' for US — see eBay location ids)."
    },
    "_stpos": {
      "type": "string",
      "description": "Buyer ZIP/postal code, used for location- and shipping-based filtering."
    },
    "_saslop": {
      "type": "integer",
      "maximum": 2,
      "minimum": 1,
      "description": "How to apply _sasl: 1 = only these sellers (default), 2 = exclude these sellers."
    },
    "no_cache": {
      "type": "boolean",
      "description": "Force a fresh SerpAPI fetch and bypass this server's result cache. Default false."
    },
    "show_only": {
      "type": "string",
      "description": "Extra filters, comma-separated: Sold, Complete (sold & completed listings), FS (free shipping), FR (free returns), RPA (returns accepted), Lots, Charity, Savings, SaleItems, AS, AV, LPickup."
    },
    "LH_PrefLoc": {
      "type": "string",
      "description": "Preferred item location: 'Domestic', 'Regional' or 'Worldwide' (mapped internally to SerpAPI's numeric LH_PrefLoc codes — the words themselves are rejected by the upstream API)."
    },
    "zero_trace": {
      "type": "boolean",
      "description": "Enterprise-only ZeroTrace mode: don't store search params/metadata on SerpAPI. Default false."
    },
    "category_id": {
      "type": "string",
      "description": "eBay category id to concentrate the search in. Can be used with or instead of _nkw."
    },
    "ebay_domain": {
      "type": "string",
      "description": "eBay marketplace domain, e.g. 'ebay.com' (default), 'ebay.de', 'ebay.co.uk', 'ebay.com.au'."
    },
    "buying_format": {
      "type": "string",
      "description": "Buying format filter: 'Auction', 'BIN' (Buy It Now) or 'BO' (Best Offer)."
    },
    "LH_ItemCondition": {
      "type": "string",
      "description": "Item condition id(s), pipe-separated for multiple ('1000|3000'): 1000 New, 1500 Open box, 2500 Seller refurbished, 3000 Used, 7000 For parts/not working, 10 Not specified."
    }
  }
}