Setup Guide

Connect CardChain AI to get real-time card data, pricing, grading analysis, and portfolio management directly in your conversations.

Setup

Connect to Claude

Open Claude Settings — Go to claude.ai (or open the Claude desktop app). Click on your profile icon (bottom-left) and select Settings.
Add the MCP Connector — In Settings, go to Integrations (or Connectors). Click "Add Integration" (or "Add more") and enter the connector URL:
https://api.cardchain.ai/mcp/claude
Click Add / Connect.
Authenticate — Claude will prompt you to log in — click the authentication link. You'll be redirected to the CardChain AI login page. Sign in with your CardChain AI account (or create one). After login, you'll be redirected back to Claude — the connector is now active.

You'll see "CardChain AI" listed as a connected integration with a green status.

Server Details

Property	Value
Connector URL	`https://api.cardchain.ai/mcp/claude`
Protocol	`MCP (Model Context Protocol)`
Auth	`OAuth 2.0`

Tools

Once connected, just talk to Claude naturally. CardChain AI gives Claude access to real-time sports card data, pricing, grading analysis, and your portfolio. Many responses include interactive widgets rendered directly in the chat.

Search Cards

search_cards

Look up any card by player, year, set, card number, or parallel. Filter by sport and grade.

Try"Search for 2023 Bowman Chrome Victor Wembanyama"

Parameter	Type	Required	Description
`query`	`string`	Yes	Player name, year, set, or card description

Get Card Price

get_card_price

Detailed pricing with 30-day price history chart rendered as an interactive widget.

Try"What's the price of a 2020 Prizm Joe Burrow rookie?"

Parameter	Type	Required	Description
`card_id`	`string`	Yes	Card identifier from a search result

Should I Grade?

should_i_grade

ROI analysis — is it worth sending to PSA/BGS? Shows raw vs graded price comparison, profit/loss scenarios, grading costs, and population data.

Try"Should I grade my 2018 Prizm Luka Doncic?"

Parameter	Type	Required	Description
`card_id`	`string`	Yes	Card identifier from a search result
`expected_grade`	`string`	Yes	Grade you expect (e.g. PSA 9, PSA 10)

Population Data

get_population

Check PSA, BGS and SGC grading population at each grade level for any card.

Try"What's the PSA population for a 2003 Topps Chrome LeBron James rookie?"

Parameter	Type	Required	Description
`card_id`	`string`	Yes	Card identifier from a search result

Identify a Card to Grade

find_card_for_grading

Identify a card from a photo, then run the grading ROI on the match. Send the image in the conversation.

Try"[photo] Is this one worth grading?"

Parameter	Type	Required	Description
`image`	`image`	Yes	A photo of the card front

Identify a Card to Add

find_card_to_add

Identify a card from a photo and add the confirmed match to your portfolio.

Try"[photo] Add this to my collection, I paid $25"

Parameter	Type	Required	Description
`image`	`image`	Yes	A photo of the card front
`purchase_price`	`number`	No	What you paid for the card

View My Portfolio

get_portfolio

See your full card collection with current values, trends, and total worth. Filterable by sport, year, grader, grade, and favorites.

Try"Show me my portfolio"

Parameter	Type	Required	Description
`sort_by`	`string`	No	Sort field (value, name, date_added)

Add to Portfolio

add_to_portfolio

Add cards to your collection with purchase price for profit tracking. Two-step: search first, then add.

Try"Add a 2023 Topps Chrome Elly De La Cruz to my portfolio"

Parameter	Type	Required	Description
`card_id`	`string`	Yes	Card identifier from a search result
`purchase_price`	`number`	No	What you paid for the card

Player Stats

get_player_stats

Season stats and market momentum for the player behind a card.

Try"How is Paul Skenes trending right now?"

Parameter	Type	Required	Description
`player`	`string`	Yes	Player name

Browse Marketplace

get_cardchain_listings

See real listings for sale from CardChain sellers with card images, prices, and seller info.

Try"Show me basketball cards for sale on CardChain"

Parameter	Type	Required	Description
`query`	`string`	No	Search query to filter listings
`sport`	`string`	No	Filter by sport (basketball, football, baseball, hockey)

Troubleshooting

"Integration not found"

Make sure you're entering the exact URL: https://api.cardchain.ai/mcp/claude. Check for trailing spaces or typos.

"Authentication failed"

Try disconnecting and reconnecting the integration in Settings → Integrations. Make sure you're signing in with the same CardChain AI account.

Widgets not showing

Interactive widgets work on all Claude plans. If they're not appearing, try disconnecting and reconnecting the integration in Settings → Integrations, then refresh the page.

Stale data

Card prices update continuously. If something looks off, try asking again — Claude fetches fresh data on every request.

Claude doesn't use the tools

Be specific with your prompt. "2023 Bowman Chrome Wembanyama PSA 10" works better than "Wembanyama card". You can also say "use CardChain" to nudge Claude.

Tips

Be specific — "2023 Bowman Chrome Wembanyama PSA 10" works better than "Wembanyama card".
Grade matters — You can specify grades like "Raw", "PSA 10", "BGS 9.5" in your search.
Multi-step flows — Grading analysis and add-to-portfolio are two-step: search first, then act. Claude handles this automatically.
Widgets are interactive — Click cards, scrub charts, expand details directly in the chat.
Dark mode — Widgets automatically match Claude's light/dark theme.

Support

Questions? Email support@cardchain.ai. For privacy information, see our privacy policy.