eBay Marketplace

eBay Search MCP Tool

Search and browse product listings across multiple eBay international sites.

MCP tool name

nexscope_ebay_search

Legacy MCP endpoint

/api/skill-api/v1/mcp

JSON-RPC method

tools/call

Authentication

Send the user API key as a bearer token on every MCP JSON-RPC request.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.

Call this MCP tool

Use tools/call with the MCP tool name below. The arguments object should match the table on this page.

{
  "jsonrpc": "2.0",
  "id": "ebay-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_ebay_search",
    "arguments": {
      "pageSize": 10,
      "keyword": "phone case",
      "page": 1
    }
  }
}

Legacy endpoint

POST /api/skill-api/v1/mcp

Canonical detail URL

https://www.nexscope.ai/mcp-map/ebay-search

Arguments

Name	Type	Required	Meaning
`keyword`	`string`	optional	Search keyword, max 1024 characters Example: phone case
`ebayDomain`	`string`	optional	eBay site domain, default ebay.com. Options: ebay.com (United States), ebay.co.uk (United Kingdom), ebay.de (Germany), ebay.fr (France), ebay.it (Italy), ebay.es (Spain), ebay.ca (Canada), ebay.com.au (Australia), ebay.nl (Netherlands), ebay.at (Austria), ebay.ch (Switzerland), ebay.pl (Poland), ebay.ie (Ireland), ebay.com.hk (Hong Kong, China), ebay.com.my (Malaysia), ebay.com.sg (Singapore) Example: {}
`page`	`integer`	optional	Page number for pagination, default 1 Example: 1
`pageSize`	`integer`	optional	Maximum results per page, default 50. Options: 25, 50, 100, 200 Example: 10
`orderBy`	`string`	optional	Sort order, default 12 (Best Match). Options: 1 (Ending soonest), 2 (Price lowest), 3 (Price highest), 7 (Distance nearest), 10 (Newly listed), 12 (Best Match), 15 (Price + shipping lowest), 16 (Price + shipping highest), 18 (New first), 19 (Used first) Example: {}
`priceMin`	`number`	optional	Minimum price filter Example: 1
`priceMax`	`number`	optional	Maximum price filter Example: 1
`itemCondition`	`string`	optional	Item condition code, multiple separated by \ Example: {}
`buyingFormat`	`string`	optional	Buying format. Options: Auction, BIN (Buy It Now), BO (Best Offer) Example: {}
`showOnly`	`string`	optional	Filter conditions, comma-separated for multiple values. Options: Complete (Ended), Sold (Sold), FR (Free returns), RPA (Returns accepted), AS (Authorized seller), Savings (Discounts), SaleItems (Sale items), Lots (Lots), Charity (Charity), AV, FS (Free shipping), LPickup (Local pickup) Example: {}
`location`	`integer`	optional	Country/region code of item location (e.g., 1=United States, 2=Canada, 3=United Kingdom, 45=China, 77=Germany) Example: 1
`prefLoc`	`string`	optional	Preferred location scope. Options: 1 (Domestic), 2 (Regional), 3 (Worldwide) Example: {}
`zipCode`	`string`	optional	ZIP or postal code for filtering shippable items by region Example: {}
`categoryId`	`integer`	optional	eBay category ID for category-specific search Example: 1
`noCache`	`boolean`	optional	Whether to bypass cache, default false Example: false

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`data`	`any`	required	Data value used by this API operation.
`code`	`integer`	required	0 means accepted or successful; nonzero is a platform error.
`msg`	`string \| null`	required	Msg value used by this API operation.
`ts`	`string`	required	Epoch milliseconds.
`time`	`string`	required	Server local time: yyyy-MM-dd HH:mm:ss.
`cost`	`string`	required	Elapsed milliseconds, never credits; -1 outside web requests.
`traceId`	`string \| null`	required	Trace id value used by this API operation.

Any of option 1

Name	Type	Required	Description
`data`	`object`	required	Data value used by this API operation.
`data.total`	`integer`	optional	Total matching results Example: 1
`data.products`	`array`	optional	Product list array (see product fields below) Example: []
`data.columns`	`array`	optional	Rendered column definitions Example: []
`data.type`	`string`	optional	Render style identifier Example: null
`data.costToken`	`integer`	optional	Token consumption Example: 1
`data.products[].productId`	`string`	optional	eBay product ID Example: example-id
`data.products[].title`	`string`	optional	Product title Example: null
`data.products[].subtitle`	`string`	optional	Product subtitle Example: null
`data.products[].price`	`number`	optional	Current price / transaction price Example: 1
`data.products[].minPrice`	`number`	optional	Price range start value (for multi-SKU items) Example: 1
`data.products[].maxPrice`	`number`	optional	Price range end value (for multi-SKU items) Example: 1
`data.products[].oldPrice`	`number`	optional	Original price before discount Example: 1
`data.products[].currency`	`string`	optional	Currency unit (e.g., USD, GBP, EUR) Example: null
`data.products[].condition`	`string`	optional	Item condition description Example: null
`data.products[].link`	`string`	optional	eBay product detail page link Example: null
`data.products[].imageUrl`	`string`	optional	Product thumbnail URL Example: https://example.com/image.jpg
`data.products[].shipping`	`string`	optional	Shipping information Example: null
`data.products[].location`	`string`	optional	Item location Example: null
`data.products[].sellerName`	`string`	optional	Seller name Example: null
`data.products[].sellerReviews`	`integer`	optional	Seller feedback count Example: 1
`data.products[].positiveFeedbackInPercentage`	`number`	optional	Seller positive feedback percentage Example: 1
`data.products[].salesQuantity`	`integer`	optional	Quantity sold Example: 1
`data.products[].bidsCount`	`integer`	optional	Bid count (for auction items) Example: 1
`data.products[].returns`	`string`	optional	Return information Example: null
`data.products[].promotion`	`string`	optional	Promotion information Example: null
`data.products[].sponsored`	`boolean`	optional	Whether sponsored/promoted item Example: false
`data.products[].sourceType`	`string`	optional	Source platform identifier (ebay) Example: null
`data.products[].sourceTool`	`string`	optional	Source tool identifier Example: null
`data.title`	`string`	optional	Provider-specific response title. Example: null
`data.sourceType`	`string`	optional	Provider-specific source platform type. Example: null
`data.sourceTool`	`string`	optional	Provider-specific source tool name. Example: null
`data.costTime`	`integer`	optional	Execution time reported by the upstream provider. Example: null
`data.page`	`integer`	optional	Current page returned by the upstream provider. Example: null
`data.pageSize`	`integer`	optional	Page size returned by the upstream provider. Example: null
`data.pageItemCount`	`integer`	optional	Item count on the current page returned by the upstream provider. Example: null
`data.totalPage`	`integer`	optional	Total page count returned by the upstream provider. Example: null
`data.dataSnapshotMonth`	`string`	optional	Data snapshot month returned by the upstream provider. Example: null

Any of option 2

Name	Type	Required	Description
`data`	`null`	required	Data value used by this API operation.

Examples

Example arguments

{
  "pageSize": 10,
  "keyword": "phone case",
  "page": 1
}

Example structuredContent

{
  "data": {
    "total": 1,
    "products": [
      {
        "productId": "example-id",
        "price": 1,
        "minPrice": 1,
        "maxPrice": 1,
        "oldPrice": 1,
        "imageUrl": "https://example.com/image.jpg",
        "sellerReviews": 1,
        "positiveFeedbackInPercentage": 1,
        "salesQuantity": 1,
        "bidsCount": 1,
        "sponsored": false
      }
    ],
    "columns": [],
    "costToken": 1
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}