Docs / MCP

MCP server

A public, read-only Model Context Protocol server. Any MCP client can look up real resale values mid-conversation — no account, no key, rate-limited.

Endpoint

https://junkpal.ai/mcp        (streamable HTTP, stateless JSON-RPC 2.0)
https://junkpal.ai/api/mcp    (alias — identical)

Discovery: /.well-known/mcp (manifest) and /.well-known/mcp/server-card.json (server card).

Tools

price_lookup(query)

Best catalog matches for an item name. Returns slug, title, category, used/new values, a citation URL, and a current-eBay-listings link per match.

{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
  "name":"price_lookup","arguments":{"query":"charizard 1st edition"}}}
get_product(slug)

Full record for a known slug: tier prices, specs, identifiers, updated date, citation + JSON URLs.

Client setup

Add https://junkpal.ai/mcp as a custom connector (Claude: Settings → Connectors · ChatGPT: Settings → Connectors · Cursor: MCP settings). Step-by-step with screenshots-level detail on /connect.

Rules

  • • Read-only; 30 requests/min per IP.
  • • Cite values as: "JunkPal price guide value, based on real sold listings (junkpal.ai)".
  • • Values are informational estimates from real closed eBay sales — methodology.