ebay-mcp

An MCP server that lets an LLM search and inspect eBay listings through the official Browse API. Read-only, buyer-side: it searches and reads listings, it does not bid or buy.

This is a fork of Suat Oneren's ebay-browse-mcp, which speaks stdio. The fork keeps the two tools and their response shaping and swaps the transport for streamable-HTTP (:8000/mcp) plus a /healthz probe, so it runs as a self-hosted container behind an MCP client such as LibreChat — the same shape as its sibling kleinanzeigen-mcp.

Unlike Kleinanzeigen (no public API, so scraping is unavoidable), eBay offers a sanctioned API — so this server hits it directly: no headless browser, no bot-detection fragility.

Tools

Tool	What it does
search_ebay	Search by keyword with optional filters (price, condition, buying option, seller country) and sort. Returns listing summaries + item_ids.
get_item_details	Full record for one item_id: description, item specifics, images, shipping options, return terms, seller.

Configuration

Set an eBay Developer keyset (free — https://developer.ebay.com/my/keys):

Env var	Default	Meaning
EBAY_CLIENT_ID	—	App ID (Client ID) from your keyset
EBAY_CLIENT_SECRET	—	Cert ID (Client Secret) from your keyset
EBAY_MARKETPLACE	EBAY_DE	Marketplace: EBAY_DE, EBAY_US, EBAY_GB, …
EBAY_ENV	sandbox	sandbox or production
MCP_TRANSPORT	http	http (streamable-HTTP) or stdio
MCP_HOST / MCP_PORT / MCP_PATH	0.0.0.0 / 8000 / /mcp	HTTP bind

Sandbox has almost no real inventory — use it to prove the wiring, then set EBAY_ENV=production (with a production, OAuth-enabled keyset) for real results.

Run

Docker (recommended)

docker run --rm -p 8000:8000 \
  -e EBAY_CLIENT_ID=... -e EBAY_CLIENT_SECRET=... \
  -e EBAY_MARKETPLACE=EBAY_DE -e EBAY_ENV=production \
  ghcr.io/jnslmk/ebay-mcp:latest
# MCP endpoint: http://localhost:8000/mcp   health: http://localhost:8000/healthz

Local (stdio, for desktop MCP clients)

python3 -m venv .venv && .venv/bin/pip install .
cp .env.example .env   # fill in your keyset
MCP_TRANSPORT=stdio .venv/bin/ebay-mcp

Quick client-free check of the keyset:

.venv/bin/python -m ebay_mcp.ebay_client "raspberry pi 5"

License

MIT. See LICENSE — retains the original upstream copyright.