---
title: "Give Claude Live eBay Sold Prices: Connector, Claude Code and API Key Setup"
url: https://www.soldcomps.io/blog/claude-ebay-sold-prices
updated: 2026-11-13
answer: "Add https://www.soldcomps.io/mcp as a remote MCP server. In claude.ai or Claude Desktop, add it as a custom connector under Customize > Connectors. In Claude Code, run claude mcp add --transport http soldcomps https://www.soldcomps.io/mcp. Claude can then call get_sold_comps and answer with the median sold price, the middle half of sales, the sale count and eBay listing links. It works without a key on a small free allowance; add an Authorization: Bearer header with your SoldComps key for more."
publisher: SoldComps.io (https://www.soldcomps.io)
---

# Give Claude Live eBay Sold Prices: Connector, Claude Code and API Key Setup

> Add https://www.soldcomps.io/mcp as a remote MCP server. In claude.ai or Claude Desktop, add it as a custom connector under Customize > Connectors. In Claude Code, run claude mcp add --transport http soldcomps https://www.soldcomps.io/mcp. Claude can then call get_sold_comps and answer with the median sold price, the middle half of sales, the sale count and eBay listing links. It works without a key on a small free allowance; add an Authorization: Bearer header with your SoldComps key for more.

By SoldComps Editorial · Published Nov 13, 2026

Claude knows a lot, but it doesn't know what a used Switch OLED sold for last week. Resale prices move too fast for training data. The fix is a tool: connect Claude to the SoldComps MCP server and it can look up completed eBay sales whenever someone asks what an item is worth.

This guide covers claude.ai and Claude Desktop, Claude Code, adding your API key, what to ask, what comes back, and the limits. Building your own agent on the Claude API instead? See [Build a pricing agent with the Claude API](https://www.soldcomps.io/blog/claude-api-mcp-pricing-agent).

## What Claude gets

The server lives at `https://www.soldcomps.io/mcp`. It's a remote MCP server (Streamable HTTP, stateless) and it's listed in the official MCP Registry as `io.soldcomps/sold-comps`. It gives Claude five tools:

| Tool | What it does |
|---|---|
| `get_sold_comps` | What an item sold for on eBay US, UK or Germany in the last 90 days: median, middle half (25th to 75th percentile), min and max, counted vs excluded sales, and up to 20 recent counted sales with listing links. Inputs: `query`, optional `condition` (`new` or `used`), `site` (`us`, `uk`, `de`). |
| `get_pricing` | SoldComps API plans and pay-as-you-go rules. |
| `get_api_docs` | A short reference for `GET /v1/sold`. |
| `search_guides` | Finds SoldComps guides for a question, with a URL to cite. |
| `what_are_sold_comps` | A short definition of sold comps. |

Lots, for-parts sales, replicas, cheap accessories, outliers and hidden Best Offer prices are kept out of the median. That's the cleanup you'd otherwise do by hand when reading [sold comps](https://www.soldcomps.io/).

## claude.ai and Claude Desktop

Remote connectors are set up once in your Claude account and work in both claude.ai and Claude Desktop. The steps below follow Anthropic's help article as of Nov 13, 2026:

1. Go to **Customize > Connectors**.
2. Click **+ Add**, then **Add custom connector**.
3. Name it `Sold comps`, paste `https://www.soldcomps.io/mcp`, and click **Continue**.
4. Under **Authentication**, choose **No sign in**.
5. Optional: under **Request headers**, add `Authorization` with the value `Bearer sh_live_...` (your API key). See [Add your API key](#add-your-api-key) for why.
6. Click **Add**.

To use it in a chat, click **+** at the lower left, open **Connectors**, and turn on Sold comps for that conversation.

On Team and Enterprise plans, an owner adds the connector in Organization settings first, then members connect to it.

## Claude Code

One command in a terminal:

```bash
claude mcp add --transport http soldcomps https://www.soldcomps.io/mcp
```

That adds it to the current project. Add `--scope user` to make it available in every project. Check it connected with `claude mcp list`, or run `/mcp` inside a Claude Code session.

## Add your API key

Without a key, lookups use a free allowance: 5 a day and 20 a month per IP address, shared with the lookup on the SoldComps homepage. The example searches `pokemon card`, `graphics card` and `rolex watch` don't count.

There's a catch for claude.ai and Claude Desktop. Anthropic's help article says Claude connects to remote MCP servers from Anthropic's cloud, not from your device. So the per-IP allowance is counted against Anthropic's addresses, not yours, and may already be used up when you start. Claude Code connects from your own machine, so it gets its own allowance.

For steady use, send your SoldComps API key. Get one free at [/signup](https://www.soldcomps.io/signup) (2,000 credits a month, no card). Then:

- **claude.ai and Claude Desktop:** add the `Authorization: Bearer sh_live_...` request header when you create the connector (step 5 above).
- **Claude Code:** pass it with `--header`:

```bash
claude mcp add --transport http soldcomps https://www.soldcomps.io/mcp \
  --header "Authorization: Bearer sh_live_..."
```

With a key, each lookup costs 20 credits plus 1 per sale listed. The tool lists at most 20 sales, so a lookup costs at most 40 credits. Failed lookups cost nothing. Plans and prepaid credits are on the [pricing page](https://www.soldcomps.io/pricing).

## What to ask

Ask the way you'd describe the item to a buyer. Specific beats vague, because the query becomes an eBay search:

- "What does a used Nintendo Switch OLED sell for on eBay?"
- "What are PSA 9 Charizard 4/102 cards selling for? Leave out lots."
- "What's a used Rolex Submariner 126610LN worth on eBay UK?"
- "Comp these five items and flag any you're not confident about: ..."

Claude turns these into a `get_sold_comps` call such as `{"query": "nintendo switch oled", "condition": "used", "site": "us"}`. If Claude writes a vague query, tell it the model number, size or grade. The [agent playbook](https://www.soldcomps.io/blog/sold-comps-agent-playbook) has the full query rules, and you can paste its system-prompt block into a Claude Project's instructions.

## What comes back

The tool returns a short text summary plus structured data. The summary reads like this (placeholders, not real figures):

```text
Median sold price for "nintendo switch oled (used)" on eBay US over the last 90 days:
$<median> from <counted> sales (middle half $<p25> to $<p75>; <excluded> of <count>
excluded as lots, parts, replicas, accessories or outliers).

Range of counted sales: $<min> to $<max>. Sales dated <from> to <to>.

Recent counted sales (newest first):
- $<price> · <date> · Pre-Owned · fixed price · <listing title> · https://www.ebay.com/itm/<id>
...

Source: SoldComps sold comps, https://www.soldcomps.io/ (live eBay sold data, independent of eBay).
```

The structured part has the same numbers as fields: `median`, `p25`, `p75`, `min`, `max`, `count`, `counted`, `excluded`, `currency`, `sales_dated`, `recent_sales[]` and `source`.

A good answer from Claude leads with the median, gives the middle half as the realistic range, and says how many sales it's based on. If fewer than 10 sales were counted, or the range is wide, it should say confidence is low and suggest a sharper query.

## How Claude should cite it

- Name the source: SoldComps, from eBay sold listings in the last 90 days, with a link to `https://www.soldcomps.io`.
- Link the individual eBay listings when quoting specific sales.
- Give the date range of the sales, not "current price".
- Never present the median as a guaranteed sale price. It's evidence of what buyers paid recently.

## Limits

- **Free, no key:** 5 lookups a day and 20 a month per IP address.
- **With a key:** billed to your credits, at most 40 credits a lookup.
- **Sales per lookup:** each lookup reads up to 200 recent matching sales from the last 90 days and lists up to 20 counted ones. Results are cached for up to 12 hours.
- **Filters:** the MCP tool takes `condition` (new or used) and `site`. Price range, buying format, look-back days and up to 200 listed sales need the REST API. See the [API docs](https://www.soldcomps.io/docs).
- **Query length:** 3 to 80 characters, up to 12 words.

## Next steps

- [Agent playbook](https://www.soldcomps.io/blog/sold-comps-agent-playbook): how Claude should write queries, read the stats and handle errors.
- [eBay sold prices in ChatGPT](https://www.soldcomps.io/blog/chatgpt-ebay-sold-prices), if your team also uses ChatGPT.
- [Price a whole inventory with an AI agent](https://www.soldcomps.io/blog/ai-agent-inventory-pricing), for lists of items.
- [Responses API, Agents SDK and Vercel AI SDK setup](https://www.soldcomps.io/blog/openai-vercel-ai-sdk-ebay-prices), for non-Claude agents.
- Setup for Cursor, VS Code and other clients: [MCP server](https://www.soldcomps.io/mcp-server). Everything for agents in one place: [/agents](https://www.soldcomps.io/agents).

## Frequently asked questions

### Can Claude look up eBay sold prices?

Not on its own. Connect the SoldComps MCP server (https://www.soldcomps.io/mcp) and Claude can call get_sold_comps, which returns the median sold price, the middle half of sales, how many sales were counted and links to recent eBay listings from the last 90 days.

### Do I need an API key to use it with Claude?

No. Without a key, lookups use a free allowance of 5 a day and 20 a month per IP address. To go beyond that, add the header Authorization: Bearer sh_live_... with your SoldComps API key. The free plan includes 2,000 credits a month with no card.

### How much does a lookup cost with an API key?

20 credits per lookup plus 1 per sale listed. The MCP tool lists at most 20 sales, so a lookup costs at most 40 credits. Failed lookups cost nothing.

### Why does Claude say the free lookup limit is reached when I've barely used it?

claude.ai and Claude Desktop connect to MCP servers from Anthropic's cloud, not from your device, so the per-IP allowance is counted against Anthropic's addresses. Add your API key as a request header to bill your own key instead.

### How should Claude cite the results?

Each result includes a source URL. Claude should name SoldComps and eBay sold listings from the last 90 days as the source, link https://www.soldcomps.io, and link individual eBay listings when it quotes specific sales.

## Sources

1. [Claude Help Center: Getting started with custom connectors using remote MCP](https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp) (accessed Nov 13, 2026)
2. [Claude Code docs: Connect Claude Code to tools via MCP](https://code.claude.com/docs/en/mcp) (accessed Nov 13, 2026)

SoldComps.io sells an eBay sold comps API, so we have a commercial interest in this topic. Corrections: hello@soldcomps.io
