Use it from an agent (MCP)

https://raritydb.com/mcp is a Model Context Protocol server (Streamable HTTP). Connect it with your API key and your agent gets these tools:

Tool What it does
search Fuzzy name search across species, sets and cards
get_card One card by code, TCGplayer product id or Cardmarket product id
list_cards Cards by name, set, Pokédex number, rarity, type, illustrator, region, legality
resolve_ids Translate up to 50 IDs from tcgdex, pokemontcg.io, tcgplayer or cardmarket
list_sets / get_set Browse sets and their card lists
get_species A Pokémon with names, forms, evolution line and cards
get_prices Cardmarket prices (in US dollars by default, converted from euros; pass currency for another) and marketplace links; live USD/graded prices with your provider key. get_card, get_sealed_product and set_pull_rates take currency too
get_sealed_product Sealed products with contents, MSRP, price
set_pull_rates Pull rates and expected value for a set (and its sealed products)
identify_card Identify a card and its exact printing from a photo (image_url or image_base64). See Identify a card from a photo
identify_cards Every card in a photo of several (a spread or a binder page, up to 20), in reading order; grid (e.g. 3x3) for pages whose cards touch
price_alerts List, create or delete price alerts on a printing's Cardmarket trend price (action). See Price alerts and webhooks
webhook_endpoints List, create, rotate the secret of, test or delete the https URLs alerts POST to (action)
pullbook_purchases Your Pullbook seller ledger: log purchases, add pulls, open sealed items, extra costs, inventory (action). See Pullbook
pullbook_report Holdings at market value, profit reports by purchase, stream or show, product or month, and a year's tax lots (read-only)
pullbook_sales Record, import (CSV) and settle sales in your Pullbook ledger, see profit, manage streams and shows (action)
verify_slab Where to verify a graded slab's cert (PSA, CGC, BGS, SGC, TAG) and whether the number is possible for that grader
assess_condition Condition from photos: centering, whitening, visible damage and a grade range (front_url / front_base64, optional back). See Card condition from photos
check_authenticity Red flags that a card is fake, from photos (front_url / front_base64, optional back). Never says "genuine". See Fake check
whoami Your account, plan limits and usage
graphql_query Any read-only GraphQL query, for everything else

The GraphQL schema is also published as the resource raritydb://schema.graphql. Each tools/call counts as one request against your limits.

Connect from ChatGPT or Claude

The connector URL is https://raritydb.com/mcp. ChatGPT and Claude sign you in with OAuth: you approve the connection on a RarityDB page and never paste a key. The connection then shows up under Connected apps on your account page, where you can see its usage and disconnect it. It shares your account's limits.

Claude (claude.ai, Desktop, mobile)

  1. Open Settings → Connectors → Add custom connector.
  2. Paste https://raritydb.com/mcp and add it.
  3. Press Connect, sign in to RarityDB if asked, and approve.

Custom connectors are on every Claude plan (Free allows one). On Team and Enterprise, an owner may need to add it first.

ChatGPT

  1. Open Plugins (chatgpt.com/plugins) → + → Add custom MCP server.
  2. Paste https://raritydb.com/mcp.
  3. Connect and approve.

OpenAI lets Business, Enterprise/Edu and Pro accounts add custom servers. Plus and Free users will be able to use RarityDB once it's listed in ChatGPT's app directory.

Cursor, VS Code, Gemini CLI and other MCP clients

Add https://raritydb.com/mcp as a remote (HTTP) MCP server. Clients that support OAuth sign you in the same way. Otherwise, send an API key header as shown below.

Claude Code (with an API key)

claude mcp add --transport http RarityDB https://raritydb.com/mcp \
  --header "Authorization: Bearer $API_KEY"

To pass a price-provider key too, add another header, e.g. --header "X-Provider-Key-Pokemonpricetracker: $PPT_KEY".

Other clients with an API key

Clients that take a JSON config:

{
  "mcpServers": {
    "RarityDB": {
      "type": "http",
      "url": "https://raritydb.com/mcp",
      "headers": { "Authorization": "Bearer rdb_…" }
    }
  }
}

Clients that can only launch a local process can bridge with npx mcp-remote https://raritydb.com/mcp --header "Authorization: Bearer rdb_…".

This page as Markdown: /docs/mcp.md