MCP server
Connect Claude, Cursor, VS Code or any MCP client to Soldgraph's hosted MCP server and search eBay, Poshmark, Mercari and more with your API key.
Soldgraph runs a hosted Model Context Protocol server. An AI assistant connected to it can search sold and active listings, check card prices and see your remaining requests, with no code.
- URL:
https://api.soldgraph.com/mcp - Auth: your API key in the
Authorization: Bearer sg_…header - Transport: Streamable HTTP, stateless
#Connect
#Claude Code
Run this once with your key in SOLDGRAPH_KEY, then check it with claude mcp list.
claude mcp add --transport http soldgraph https://api.soldgraph.com/mcp \ --header "Authorization: Bearer $SOLDGRAPH_KEY"#Cursor
Add this to ~/.cursor/mcp.json, or .cursor/mcp.json for one project. Cursor reads SOLDGRAPH_KEY from your environment.
{ "mcpServers": { "soldgraph": { "url": "https://api.soldgraph.com/mcp", "headers": { "Authorization": "Bearer ${env:SOLDGRAPH_KEY}" } } }}#VS Code
Add this to .vscode/mcp.json in your workspace. VS Code asks for the key once and stores it securely. Use it from GitHub Copilot in agent mode.
{ "inputs": [ { "type": "promptString", "id": "soldgraph-key", "description": "Soldgraph API key", "password": true } ], "servers": { "soldgraph": { "type": "http", "url": "https://api.soldgraph.com/mcp", "headers": { "Authorization": "Bearer ${input:soldgraph-key}" } } }}#Claude Desktop
Claude Desktop starts local servers, so this uses mcp-remote to connect to the hosted URL. Add it to claude_desktop_config.json (Settings → Developer → Edit Config) and restart Claude. It needs Node.js.
{ "mcpServers": { "soldgraph": { "command": "npx", "args": ["-y", "mcp-remote", "https://api.soldgraph.com/mcp", "--header", "Authorization:${AUTH_HEADER}"], "env": { "AUTH_HEADER": "Bearer sg_your_key" } } }}#Claude API
Claude calls Soldgraph's tools inside one Messages API request through the MCP connector.
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" }] }'#Gemini CLI
Install the Soldgraph extension. Gemini CLI asks for your key during install and stores it securely. Change it later with gemini extensions config soldgraph.
gemini extensions install https://github.com/soldgraph/soldgraph-agent#Other MCP clients
Any client that supports Streamable HTTP with custom headers can connect: use https://api.soldgraph.com/mcp and send Authorization: Bearer sg_…. Clients that only start local servers can use mcp-remote, as in the Claude Desktop example.
Keep the key in your client's config or an environment variable, never in a prompt or a shared repo.
#Plugins and skills
The open-source repo soldgraph/soldgraph-agent packages this server with a Soldgraph skill that tells the agent when to use it and how to read a price result.
- Claude Code plugin:
/plugin marketplace add soldgraph/soldgraph-agent, then/plugin install soldgraph@soldgraph. It asks for your key once. - Gemini CLI extension:
gemini extensions install https://github.com/soldgraph/soldgraph-agent. - Cursor plugin: copy the repo into
~/.cursor/plugins/local/soldgraphand reload the window. - Skill only, for Codex, OpenClaw and other agents that read skills:
npx skills add soldgraph/soldgraph-agent. With no MCP tools connected, the skill calls the HTTP API withSOLDGRAPH_KEY.
#Tools
There is one tool for each search route. Each takes that route's parameters:
| Tool | What it returns |
|---|---|
ebay_sold, poshmark_sold, mercari_sold | Sold listings: what items actually sold for |
ebay_listings, poshmark_listings, mercari_listings, depop_listings, whatnot_listings | Active listings and asking prices |
offerup_listings, offerup_item | Local OfferUp listings near a ZIP code, and one listing's details |
facebook_listings, facebook_item | Local Facebook Marketplace listings near a ZIP code, and one listing's details |
vinted_listings, vinted_item | Active Vinted listings in the US, UK or Europe, and one listing's details |
tcgplayer_search, tcgplayer_sales | TCGplayer products with market price, and a product's recent sales sample |
account_usage | Your plan, requests used and remaining. Free |
api_status | Each marketplace's live health. Free |
get_result | Finishes a search that was still collecting. Free |
All tools are read-only.
#How calls work
- One call, one finished result. The server sends the search and waits for it, so the assistant gets rows instead of a job to poll.
- Slow searches. If a search is still collecting after about 55 seconds, the tool returns a
request_id. The assistant callsget_resultwith it, and that is not charged again. - Compact rows. Results include the fields most agents need: title, price, condition, dates and
link. Passfields: "full"for every field the API returns. Either way, listing searches and TCGplayer recent sales includeresult.summary, the median, lowest and highest price over the whole page. - Same costs as the API. Each completed search costs 1 request, cache hits included. Failed searches, errors,
get_result,account_usageandapi_statusare free. See Usage and billing. - Retries. A repeated identical call within five minutes reuses the same search, so a client retry is not charged twice.
- Rate limits. Your plan's per-minute limit applies. A tool call uses one to four API calls of it.
#Example prompts
- "What has a Nintendo Switch OLED sold for on eBay and Mercari this month? Give me the median and link three examples."
- "Find used road bikes under $400 on OfferUp near 94103."
- "Look up Charizard ex from Obsidian Flames on TCGplayer and show its recent sales."
- "How many Soldgraph requests do I have left?"
Overviews: eBay sold listings API · findCompletedItems alternative · Poshmark sold listings API · Mercari sold listings API · Pokémon card price API · Sold comps API for reseller apps