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
Metadata
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 | Provenance | Actions |
|---|---|---|---|---|
| sports_card_agent-1.0.1.tar.gz | 33.0 kB | Without provenance | Details for sports_card_agent-1.0.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| sports_card_agent-1.0.1-py3-none-any.whl | Python 3 | none | any | Details for sports_card_agent-1.0.1-py3-none-any.whl |
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
|
Security for sports-card-agent 1.0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.