About Sports Trading Card Agent
Sports Trading Card Agent is an MCP server for sports card collectors and investors, giving AI agents pricing, market, and player-performance analysis across the NBA, NFL, and MLB.
Key features
- 01Look up eBay sold and active prices
- 02Analyze trends and detect arbitrage opportunities
- 03Retrieve NBA, NFL, and MLB player stats
- 04Calculate PSA, BGS, and SGC grading ROI
- 05Get buy, sell, or hold recommendations
- 06Analyze vintage cards and track trending players
Use cases
- 01Assess the market price of a specific card
- 02Compare potential returns on raw and graded cards
- 03Use player performance to inform trading decisions
- 04Analyze vintage cards issued before 2000
MCP support
The MCP server exposes 9 sports-card data and analysis tools to AI agents, covering pricing, player statistics, and investment analysis.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
uvx sports-card-agentEBAY_APP_IDSecreteBay API application ID (register free at developer.ebay.com)EBAY_CERT_IDSecreteBay API certificate ID (register free at developer.ebay.com)BALLDONTLIE_API_KEYSecretBall Don't Lie API key for player stats (register free at app.balldontlie.io)Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMESports 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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.