ebay_search
Pack: ebay · Endpoint: https://gateway.pipeworx.io/ebay/mcp
Search active eBay listings (US marketplace). Returns title, price, condition, seller, thumbnail, and item_id per hit. Use ebay_get_item with the returned item_id for full detail.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
q | string | yes | Keyword query (e.g. “iPhone 15 Pro 256GB”) |
category_id | string | no | eBay category ID to scope to (see ebay_get_categories) |
limit | number | no | 1–200 (default 25) |
offset | number | no | Pagination offset (default 0) |
sort | string | no | price (asc) | -price (desc) | newlyListed | endingSoonest |
filter | string | no | Advanced Browse API filter, e.g. “price:[20..100],conditions:{NEW},buyingOptions:{FIXED_PRICE}”. See Browse docs. |
conditions | unknown | no | |
buyingOptions | unknown | no |
Example call
curl -X POST https://gateway.pipeworx.io/ebay/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ebay_search","arguments":{}}}'Response shape
Always returns: total, limit, offset, hits
| Field | Type | Description |
|---|---|---|
total | number | Total number of matching listings |
limit | number | Number of results returned (1-200) |
offset | number | Pagination offset used |
hits | array | Array of search result items |
Full JSON Schema
{
"type": "object",
"properties": {
"total": {
"type": "number",
"description": "Total number of matching listings"
},
"limit": {
"type": "number",
"description": "Number of results returned (1-200)"
},
"offset": {
"type": "number",
"description": "Pagination offset used"
},
"hits": {
"type": "array",
"description": "Array of search result items",
"items": {
"type": "object",
"properties": {
"item_id": {
"type": "string",
"description": "eBay item ID"
},
"title": {
"type": "string",
"description": "Item title"
},
"price": {
"type": [
"string",
"null"
],
"description": "Price with currency (e.g. '99.99 USD')"
},
"condition": {
"type": [
"string",
"null"
],
"description": "Item condition (e.g. NEW, USED)"
},
"seller": {
"type": [
"string",
"null"
],
"description": "Seller username"
},
"seller_feedback_pct": {
"type": [
"string",
"null"
],
"description": "Seller feedback percentage"
},
"buying_options": {
"type": "array",
"description": "Available buying options",
"items": {
"type": "string"
}
},
"end_date": {
"type": [
"string",
"null"
],
"description": "Auction end date (ISO format)"
},
"image_url": {
"type": [
"string",
"null"
],
"description": "Product thumbnail image URL"
},
"url": {
"type": [
"string",
"null"
],
"description": "eBay item webpage URL"
}
},
"required": [
"item_id",
"title"
]
}
}
},
"required": [
"total",
"limit",
"offset",
"hits"
]
}Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"ebay": {
"url": "https://gateway.pipeworx.io/ebay/mcp"
}
}
}See Getting Started for client-specific install steps.