Ebay

MCP (Model Context Protocol) server connector for eBay. Enables AI agents to search products, view item details, track and place bids, make Buy It Now purchases, view order history, and track shipments — all via browser automation with Playwright.

Features

Tool	Description
search_products	Search eBay by keyword with filters (price, condition, sort)
get_item_details	Full item details: price, condition, specs, seller info, images
track_bids	View bid history and auction status
place_bid	Place a maximum bid on an auction
buy_it_now	Initiate a Buy It Now purchase and proceed to checkout
view_order_history	List your past eBay purchases
track_shipment	Track a shipment by tracking number or order item

Installation

npm install -g @striderlabs/mcp-ebay

Or install Playwright browsers after installing:

npx playwright install chromium

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "ebay": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-ebay"]
    }
  }
}

Usage with Claude Code

claude mcp add ebay -- npx -y @striderlabs/mcp-ebay

Tool Reference

search_products

{
  "query": "vintage rolex watch",
  "max_results": 10,
  "min_price": 500,
  "max_price": 5000,
  "condition": "1000",
  "sort": "15"
}

Condition codes: 1000=New, 2000=Refurbished, 3000=Used Sort codes: 12=Best Match, 15=Ending Soonest, 16=Newly Listed, 3=Price Lowest

get_item_details

{ "item_id": "123456789012" }

track_bids

{ "item_id": "123456789012" }

place_bid

{
  "item_id": "123456789012",
  "bid_amount": 75.00,
  "username": "[email protected]",
  "password": "yourpassword"
}

buy_it_now

{
  "item_id": "123456789012",
  "username": "[email protected]",
  "password": "yourpassword",
  "quantity": 1
}

Note: This proceeds to the eBay checkout page. Final payment must be completed on eBay.

view_order_history

{
  "username": "[email protected]",
  "password": "yourpassword",
  "days": 60
}

track_shipment

{ "tracking_number": "1Z999AA10123456784" }

Or by item ID (requires login):

{
  "item_id": "123456789012",
  "username": "[email protected]",
  "password": "yourpassword"
}

Security Notes

• Credentials are passed per-call and never stored
• Browser sessions are closed after each tool call
• Runs headless Chromium — no UI required
• For production use, consider using environment variables for credentials

Development

git clone https://github.com/markswendsen-code/mcp-ebay
cd mcp-ebay
npm install
npm run build

License

MIT