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.

BASH
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.

JSON
{  "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.

JSON
{  "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.

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" }    }  }}

#Claude API

Claude calls Soldgraph's tools inside one Messages API request through the MCP connector.

BASH
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.

BASH
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/soldgraph and 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 with SOLDGRAPH_KEY.

#Tools

There is one tool for each search route. Each takes that route's parameters:

ToolWhat it returns
ebay_sold, poshmark_sold, mercari_soldSold listings: what items actually sold for
ebay_listings, poshmark_listings, mercari_listings, depop_listings, whatnot_listingsActive listings and asking prices
offerup_listings, offerup_itemLocal OfferUp listings near a ZIP code, and one listing's details
facebook_listings, facebook_itemLocal Facebook Marketplace listings near a ZIP code, and one listing's details
vinted_listings, vinted_itemActive Vinted listings in the US, UK or Europe, and one listing's details
tcgplayer_search, tcgplayer_salesTCGplayer products with market price, and a product's recent sales sample
account_usageYour plan, requests used and remaining. Free
api_statusEach marketplace's live health. Free
get_resultFinishes 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 calls get_result with it, and that is not charged again.
  • Compact rows. Results include the fields most agents need: title, price, condition, dates and link. Pass fields: "full" for every field the API returns. Either way, listing searches and TCGplayer recent sales include result.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_usage and api_status are 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