MCP Claude Desktop

Sold prices in Claude. Ask what it's worth.

Connect Claude Desktop to Soldgraph's hosted MCP server and ask in chat. Claude answers with real eBay, Poshmark and Mercari sales and links to each one.

100 free requests · No credit card required

claude_desktop_config.json
{  "mcpServers": {    "soldgraph": {      "command": "npx",      "args": ["-y", "mcp-remote", "https://api.soldgraph.com/mcp", "--header", "Authorization:${AUTH_HEADER}"],      "env": { "AUTH_HEADER": "Bearer sg_your_key" }    }  }}
Setup

Three steps. No code.

You need a Soldgraph API key, Claude Desktop and Node.js.

  1. Get a key. Create a free account and make a key. It starts with sg_.
  2. Add the server. Open Settings, then Developer, then Edit Config. Paste the block on this page and put your key after Bearer.
  3. Restart Claude and ask. Soldgraph shows in the tools menu. Ask what something sold for.
Try asking

Plain English in, real sales out.

The assistant picks the tools, runs the searches and answers with links to each listing.

“What has a Nintendo Switch OLED sold for on eBay this month? Link three examples.”

Claude runs ebay_sold and answers with the median, the range and links to real sales.

“I found a Coach Tabby at a thrift store for $40. Is it worth flipping?”

Poshmark and eBay sold searches show what it really sells for, so you can judge the margin.

“What's Umbreon VMAX alt art worth, and what did it last sell for?”

tcgplayer_search finds the card and tcgplayer_sales shows its recent sales.

“Find road bikes under $400 near 94103 on OfferUp.”

offerup_listings returns local listings with prices and links.

Claude API

Building on Claude? Same tools, one request.

The Messages API connects to Soldgraph through the MCP connector. Claude calls the tools inside one request, so your app needs no tool code.

Messages API
curl https://api.anthropic.com/v1/messages \  -H "X-API-Key: $ANTHROPIC_API_KEY" \  -H "anthropic-version: 2023-06-01" \  -H "anthropic-beta: mcp-client-2025-11-20" \  -H "Content-Type: application/json" \  -d '{    "model": "claude-sonnet-5-5",    "max_tokens": 2000,    "messages": [{ "role": "user", "content": "What have used Switch OLEDs sold for on eBay?" }],    "mcp_servers": [{ "type": "url", "url": "https://api.soldgraph.com/mcp", "name": "soldgraph", "authorization_token": "sg_your_key" }],    "tools": [{ "type": "mcp_toolset", "mcp_server_name": "soldgraph" }]  }'
Tools

19 tools, all read-only.

One tool per search route. A completed search costs one request, the same as the API. Failed searches and the last three tools are free.

ToolWhat it returns
ebay_soldeBay sold listings
ebay_listingseBay active listings
poshmark_soldPoshmark sold listings
poshmark_listingsPoshmark active listings
mercari_soldMercari sold listings
mercari_listingsMercari active listings
depop_listingsDepop active listings
whatnot_listingsWhatnot active listings
tcgplayer_searchTCGplayer product search
tcgplayer_salesTCGplayer recent sales
offerup_listingsOfferUp local listings
offerup_itemOfferUp listing details
facebook_listingsFacebook local listings
facebook_itemFacebook listing details
vinted_listingsVinted active listings
vinted_itemVinted listing details
account_usageYour plan, requests used and remaining
api_statusEach marketplace's live health
get_resultFinishes a search that was still collecting

Full tool list, slow-search handling and rate limits are in the MCP guide.

Building with ChatGPT? Paste this.

One prompt gives your assistant the endpoint, the sign-in header and how to wait for a result, so its first script works.

Prompt for ChatGPT, Claude or Cursor
I'm building with the Soldgraph API. It returns sold and for-sale listings from eBay and other resale marketplaces.

Read the docs first: https://soldgraph.com/llms.txt
OpenAPI spec: https://soldgraph.com/openapi.json

Rules for the code you write:
- Base URL: https://api.soldgraph.com/v1
- Auth: send the header "Authorization: Bearer <key>". Read the key from the SOLDGRAPH_KEY environment variable. Never put it in browser code.
- eBay sold prices: GET /ebay/sold?q=<search words>. Add count=200 for up to 200 rows.
- A search often answers 202 with status "pending" and a poll_url. Request https://api.soldgraph.com plus poll_url with ?wait=20 and the same header, until status is "complete" or "failed".
- Read result.summary for the median, low and high price. The rows are in result.data, each with title, displayed_price, sold_date and link.
- Each completed search uses one request. A free account starts with 100 requests that do not refill, so save results while testing instead of repeating a search.

Start with a short script that prints the median sold price for "nintendo switch oled". Then ask me what I want to build.
Paste it in, add your key as SOLDGRAPH_KEY, and it writes working code.Open in ChatGPT Open in Claude
FAQ

Common questions

Something else? Email hello@soldgraph.com and a person will reply.

In Claude Desktop, open Settings, then Developer, then Edit Config. On a Mac it is ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows it is %APPDATA%\Claude\claude_desktop_config.json.

Claude Desktop starts servers on your computer. The config runs mcp-remote with npx, which connects it to Soldgraph's hosted server. That needs Node.js installed.

Not yet. Custom connectors on claude.ai sign in with OAuth, and Soldgraph's server uses an API key. Use Claude Desktop or Claude Code for now.

One request per completed search, the same as the API. Failed searches, account_usage and api_status are free.

Start with 100 free requests, no credit card required.

No. Every tool is read-only and searches public listings. It never asks for a marketplace login.

Connect Claude in about two minutes.

Create a free account, make a key, and send your first request. Start with 100 free requests, no credit card required.