eBay

liveMarketsReference

eBay Browse + Taxonomy APIs — search active listings, get item detail, and walk the US category tree via client_credentials.

3tools

0msauth

free tier50 calls/day

🔑Authentication

BYO app credentials. Format: ?_apiKey=<App ID>:<Cert ID>. Get a free production keyset at https://developer.ebay.com/my/keys.

Config with credentials

{
  "mcpServers": {
    "pipeworx-ebay": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gateway.pipeworx.io/ebay/mcp?_apiKey=your_app_id:your_cert_id"
      ]
    }
  }
}

Get an API key →

Tools

ebay_searchrequired: q

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

NameTypeDescription

qreqstringKeyword query

category_idoptstringeBay category ID

limitoptnumber1–200 (default 25)

offsetoptnumberPagination offset (default 0)

sortoptstringprice | -price | newlyListed | endingSoonest

filteroptstringAdvanced Browse API filter string

▶Try it

Response

ebay_get_itemrequired: item_id

Get full detail for a single eBay item. Accepts either the RESTful item ID ("v1|123456789|0") or the legacy numeric ID ("123456789").

Parameters

NameTypeDescription

item_idreqstringRESTful or legacy item ID

▶Try it

Response

ebay_get_categories

Get the eBay category subtree under category_id. Omit category_id for the top-level US categories. Returned ids feed into ebay_search.category_id.

Parameters

NameTypeDescription

category_idoptstringParent category ID. Omit for top-level.

▶Try it

Response

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools

bash

curl -X POST https://gateway.pipeworx.io/ebay/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Call a tool

bash

curl -X POST https://gateway.pipeworx.io/ebay/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"ebay_search","arguments":{"q": "hello"}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript

import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("ebay_search", {"q":"example"});

ask_pipeworx

// Or ask in plain English:
const answer = await px.ask("ebay browse + taxonomy apis — search active listings, get item detail, and walk the us category tree via client_credentials");

MCP Config

claude_desktop_config.json

{
  "mcpServers": {
    "pipeworx-ebay": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gateway.pipeworx.io/ebay/mcp"
      ]
    }
  }
}