@striderlabs/mcp-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