compsapi-mcp

# CompsAPI MCP Server · eBay Sold Listings for AI Agents

Hosted MCP server that gives any AI agent real eBay sold listings: up to **3 years of price history** and the **real accepted Best Offer price**, not the crossed out asking price. Ask for comps in plain language, get structured sold data back.

- **Server URL:** `https://api.compsapi.com/mcp` (streamable HTTP, no install)
- **Auth:** your CompsAPI key in the Authorization header, free key at [app.compsapi.com](https://app.compsapi.com) (100 searches a month, no card)
- **Docs:** [compsapi.com/docs](https://compsapi.com/docs)

## Setup

Claude Desktop, Claude Code, Cursor and any other MCP client that supports remote servers:

```json
{
  "mcpServers": {
    "compsapi": {
      "url": "https://api.compsapi.com/mcp",
      "headers": { "Authorization": "Bearer sk_live_YOUR_KEY" }
    }
  }
}
```

Claude Code one-liner:

```bash
claude mcp add --transport http compsapi https://api.compsapi.com/mcp --header "Authorization: Bearer sk_live_YOUR_KEY"
```

## Tool

### `search_sold_listings`

Search real eBay sold listings. Returns price statistics (average, median, range, best offer share) plus the newest matching sales.

| Parameter | Description |
|---|---|
| `query` | What to search, e.g. `charizard psa 10` |
| `days` | How far back, 1 to 1095 (3 years). Default 90. |
| `condition` | `new`, `open_box`, `refurbished`, `used`, `parts` |
| `best_offer` | `1` adds real accepted offer prices, `only` returns accepted offers only |
| `site` | eBay marketplace: `US` (default), `UK`, `DE`, `FR`, `IT`, `ES`, `CA`, `AU` |
| `category` | eBay category id(s), e.g. `31387` for wristwatches |
| `min_price` / `max_price` | Sold price range |
| `page` | Result page, newest first |

Example prompts once connected:

- "What does a PSA 10 Charizard actually sell for? Last 90 days."
- "Median sold price for a Rolex Submariner 126610 this year, accepted offers included."
- "Compare what iPhone 15 Pro sells for on eBay UK vs US."

## Why this data

eBay put sold listings behind a login in 2026 and the public sold search only ever showed 90 days. CompsAPI returns up to 3 years of real sales, including what accepted Best Offers actually closed at. Full REST API with the same data at [compsapi.com](https://compsapi.com).

Not affiliated with eBay Inc. eBay is a trademark of eBay Inc.