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

Related MCP server: mediawiki-mcp-server

Configuration

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

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.