README

ebay-mcp

Search eBay and get real price data, straight from an AI agent.

Wraps the eBay Browse API as an MCP server with three tools: search listings, fetch a single item, and get an aggregated price landscape across conditions. Read-only and buy-side only — no user auth required.

Install

git clone https://github.com/cunicopia-dev/ebay-mcp
cd ebay-mcp
python3.12 -m venv .venv && source .venv/bin/activate
pip install -e .

Configure credentials (see docs/SETUP.md), then wire into Claude:

{
  "mcpServers": {
    "ebay": { "command": "/path/to/.venv/bin/ebay-mcp" }
  }
}

Tools

`ebay_price_check`

Get a price landscape for any item — min, median, max, broken down by condition, with the cheapest listings at the bottom.

query: "RTX 5080", exclude: ["laptop", "notebook"]
→ { count: 47, min: 899, median: 1099, max: 2200,
    by_condition: { New: {...}, Used: {...} },
    cheapest: [ { price: 899, title: "...", itemWebUrl: "..." }, ... ] }

`ebay_search`

Full listing search with filtering and sorting.

query: "macbook pro m4", sort: "price", limit: 20
→ [ { itemId, title, price, condition, seller, itemWebUrl }, ... ]

`ebay_get_item`

Fetch complete item detail by ID.

item_id: "v1|123456789|0"
→ full eBay item object

Config

Credentials live in ~/.ebay-mcp.toml (chmod 600) or environment variables. See docs/SETUP.md.

ebay-mcp-config   # validate config and show masked creds

License

MIT

ebay-mcp

README

ebay-mcp

Install

Tools

ebay_price_check

ebay_search

ebay_get_item

Config

License

Recommended Servers

`ebay_price_check`

`ebay_search`

`ebay_get_item`