About Soldgraph
Soldgraph is a marketplace data service for MCP clients such as Claude, Cursor, and VS Code. It searches sold and active listings across eBay, Poshmark, Mercari, Depop, Vinted, TCGplayer, and other platforms, and checks card prices.
Key features
- 01Search sold listings
- 02Search active listings
- 03Check card prices
- 04Cover multiple marketplaces
- 05Connect over HTTP
Use cases
- 01Compare sold-item activity across marketplaces
- 02Check prices for trading cards
- 03Search listings from a coding client
MCP support
Soldgraph provides a Streamable HTTP MCP server at https://api.soldgraph.com/mcp, with Bearer-key authentication.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://api.soldgraph.com/mcpclaude mcp add --transport http soldgraph-soldgraph https://api.soldgraph.com/mcp{"mcpServers":{"soldgraph-soldgraph":{"type":"http","url":"https://api.soldgraph.com/mcp"}}}Open in Cursor{"servers":{"soldgraph-soldgraph":{"type":"http","url":"https://api.soldgraph.com/mcp"}}}Open in VS Code{"mcpServers":{"soldgraph-soldgraph":{"type":"http","url":"https://api.soldgraph.com/mcp"}}}{"mcpServers":{"soldgraph-soldgraph":{"serverUrl":"https://api.soldgraph.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://api.soldgraph.com/mcpAuth requiredTools
19| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | Yes | Search keywords, 1–200 characters, as you'd type them into the marketplace's search box. Be specific: model, size, grade, edition. |
| page | integer | No | Source page to fetch. Where an endpoint has cursor, pages after 1 also need it. |
| sort | enum | No | Result order. Leave it out for eBay's best match. recently_sold is newest sale first. price_asc and price_desc sort by price plus shipping.best_match | recently_sold | price_asc | price_desc |
| count | enum | No | Rows per page: 200, 120, 60 or 40. Send 200 for the most eBay gives; leaving it out means 40. A search costs one request at any size. Optional.40 | 60 | 120 | 200 |
| fields | enum | No | summary keeps the fields most agents need; full returns every field the API returns.summary | full |
| country | enum | No | Which eBay site to search: us (ebay.com), uk (ebay.co.uk), ca (ebay.ca), au (ebay.com.au), de (ebay.de), fr (ebay.fr), it (ebay.it) or es (ebay.es). Results, prices, min_price and max_price use that site's currency. Optional.us | uk | ca | au | de | fr | it | es |
| condition | array | No | eBay's own condition groups. Send one or more, separated by commas, like new,open_box. new is Brand New, open_box is Open Box or New (Other), refurbished is every refurbished grade, used is Pre-Owned and for_parts is Parts Only. eBay applies the filter. |
| max_price | integer | No | Highest price, in whole units of the country's currency (US dollars for us). Optional. You can send it without min_price. |
| min_price | integer | No | Lowest price, in whole units of the country's currency (US dollars for us). Optional. Must not be more than max_price. You can send it without max_price. |
| category_id | integer | No | eBay numeric category ID, such as 27386 for graphics cards. Keeps only listings in that category. Optional. |
| buying_format | enum | No | Only one kind of listing: auction, buy_it_now (fixed price, including listings that also take offers) or best_offer (listings that take offers). eBay applies the filter.auction | buy_it_now | best_offer |
| item_location | enum | No | Where sellers are. domestic keeps sellers in the country you search; worldwide includes every country. Leave it out for the eBay site's own default. On fr the default is narrow: send worldwide for far more results.domestic | worldwide |
Details
From the project READMESoldgraph MCP server
Connect Claude, Cursor, VS Code or any MCP client to Soldgraph. Your assistant can then search sold and active listings and check card prices, with no code.
- URL:
https://api.soldgraph.com/mcp - Auth:
Authorization: Bearer <your API key> - Transport: Streamable HTTP
Claude Code
claude mcp add --transport http soldgraph https://api.soldgraph.com/mcp \
--header "Authorization: Bearer $SOLDGRAPH_KEY"
Cursor
~/.cursor/mcp.json, or .cursor/mcp.json for one project:
{
"mcpServers": {
"soldgraph": {
"url": "https://api.soldgraph.com/mcp",
"headers": { "Authorization": "Bearer ${env:SOLDGRAPH_KEY}" }
}
}
}
VS Code
.vscode/mcp.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}" }
}
}
}
Other clients: soldgraph.com/docs/guides/mcp.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.