# @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

```bash
npm install -g @striderlabs/mcp-ebay
```

Or install Playwright browsers after installing:

```bash
npx playwright install chromium
```

## Usage with Claude Desktop

Add to your `claude_desktop_config.json`:

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

## Usage with Claude Code

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

## Tool Reference

### search_products
```json
{
  "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
```json
{ "item_id": "123456789012" }
```

### track_bids
```json
{ "item_id": "123456789012" }
```

### place_bid
```json
{
  "item_id": "123456789012",
  "bid_amount": 75.00,
  "username": "your@email.com",
  "password": "yourpassword"
}
```

### buy_it_now
```json
{
  "item_id": "123456789012",
  "username": "your@email.com",
  "password": "yourpassword",
  "quantity": 1
}
```
> Note: This proceeds to the eBay checkout page. Final payment must be completed on eBay.

### view_order_history
```json
{
  "username": "your@email.com",
  "password": "yourpassword",
  "days": 60
}
```

### track_shipment
```json
{ "tracking_number": "1Z999AA10123456784" }
```
Or by item ID (requires login):
```json
{
  "item_id": "123456789012",
  "username": "your@email.com",
  "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

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

## License

MIT