Sports Card Agent
An MCP server that gives AI agents expert-level sports trading card data. Covers pricing, market analysis, arbitrage detection, grading ROI, investment advice, player stats (NBA/NFL/MLB), vintage card analysis, and trending player alerts.
9 tools. 3 sports. 40+ vintage sets. Zero manual research.
Tools
Pricing & Market
| Tool | Description |
|---|---|
card_price_lookup |
Real-time sold and active prices from eBay. Supports any sport, brand, year, or grading. |
card_market_analysis |
Trend analysis comparing sold vs asking prices. Detects arbitrage opportunities where cards are listed below market value. |
Player Stats
| Tool | Description |
|---|---|
player_stats_lookup |
Multi-sport player stats (NBA/NFL/MLB) with card market insights based on performance. |
nfl_stats_lookup |
NFL passing, rushing, receiving, and defensive stats with card market insights. |
mlb_stats_lookup |
MLB batting (AVG, HR, RBI, OPS) and pitching (ERA, K, WHIP) stats with card insights. |
Analysis & Strategy
| Tool | Description |
|---|---|
grading_roi_calculator |
Calculates whether grading a card is profitable. Compares raw vs graded prices for PSA, BGS, and SGC with fee-adjusted ROI. |
card_investment_advisor |
Buy/sell/hold recommendations combining market trends with player performance data across all 3 sports. |
trending_players |
Identifies NBA players with breakout performances whose cards are likely rising in value. |
vintage_card_analysis |
Era-specific analysis for pre-2000 cards. Covers 40+ iconic sets from 1909 T206 to 2000 Playoff Contenders with grade-based pricing. |
Quick Start
Install from PyPI
pip install sports-card-agent
Run the server
sports-card-agent
Use with Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"sports-card-agent": {
"command": "sports-card-agent"
}
}
}
Use with Claude Code
Add to your .mcp.json:
{
"mcpServers": {
"sports-card-agent": {
"command": "sports-card-agent"
}
}
}
Configuration
Create a .env file or set environment variables:
# eBay API (register free at developer.ebay.com)
EBAY_APP_ID=your_app_id
EBAY_CERT_ID=your_cert_id
# Ball Don't Lie API (register free at app.balldontlie.io)
BALLDONTLIE_API_KEY=your_api_key
The server works without API keys using mock data, so you can try it immediately.
Example Queries
Once connected, any AI agent can ask:
- "What's a 2023 Topps Chrome Wembanyama rookie selling for?"
- "Should I buy or sell my Patrick Mahomes rookie card?"
- "Is it worth grading my 1986 Fleer Jordan?"
- "Who are the trending NBA players whose cards are rising?"
- "Analyze the market for Ken Griffey Jr 1989 Upper Deck rookie"
- "What's the investment outlook on vintage 1952 Topps Mickey Mantle?"
- "How is Shohei Ohtani performing this season and what does that mean for his cards?"
Sports & Sets Covered
Sports: Baseball, Basketball, Football, Hockey, Soccer
Player Stats: NBA (all teams), NFL (all positions), MLB (batting + pitching)
Vintage Sets Include: 1909 T206, 1933 Goudey, 1951 Bowman, 1952 Topps, 1954-55 Topps, 1958 Topps Football, 1961 Fleer Basketball, 1965 Topps Football, 1966 Topps Hockey, 1969 Topps, 1979 O-Pee-Chee, 1981 Topps Football, 1984 Topps Football, 1986 Fleer Basketball, 1986 Donruss, 1989 Upper Deck, 1993 SP, 1996 Topps Chrome, 1997 Metal Universe, 2000 Playoff Contenders, and more.
Grading Companies: PSA, BGS, SGC (all service tiers with current pricing)
Development
git clone https://github.com/rjexile/sports-card-agent.git
cd sports-card-agent
python -m venv venv
source venv/Scripts/activate # Windows
pip install -e .
python test_all.py # Run all 29 tests
License
MIT
Release files for sports-card-agent 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sports_card_agent-1.0.1.tar.gz | 33.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sports_card_agent-1.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 73.4 kB
Release files / sports_card_agent-1.0.1.tar.gz
| Download URL | sports_card_agent-1.0.1.tar.gz |
|---|---|
| Size | 33.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f3ec10b12da8a4ec8b38c875a00e67510b2e704015427541082a839ac3151b4c
|
|
BLAKE2b-256 checksum How to use checksums |
1230ca53bb26c8cd9e37cbd3a52a9b2467d14debe92b9eff82b7acfe8620f5cd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.10
|
Release files / sports_card_agent-1.0.1-py3-none-any.whl
| Download URL | sports_card_agent-1.0.1-py3-none-any.whl |
|---|---|
| Size | 40.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
05745f78840a9c48f11c84de66f33a80439d12ec54bdff29e28bc19ea72f5c6f
|
|
BLAKE2b-256 checksum How to use checksums |
343da81c1fbf36769c4ab210df6f19c2e8154e641a8f5c00bd1cbbea46bdcc3a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.10
|