Sports Trading Card Agent
The Sports Trading Card Agent server provides AI agents with expert-level sports trading card data, market analysis, and investment insights across multiple sports.
Card Price Lookup – Retrieve real-time sold and active listing prices from eBay for any sports card by specifying year, brand, player, parallel, or grade
Market Analysis – Analyze price trends, compare sold vs. asking prices, calculate market spread, and detect arbitrage opportunities
Player Stats Lookup – Access current season stats for NBA, NFL (passing, rushing, receiving, defensive), and MLB (batting/pitching) players with card market insights tied to their performance
Grading ROI Calculator – Determine if professionally grading a card (PSA, BGS, or SGC) is worthwhile by comparing raw vs. graded prices minus grading fees
Card Investment Advisor – Get BUY/SELL/HOLD/AVOID recommendations with confidence levels by combining market trend data with player performance analysis
Trending Players – Identify NBA players with breakout performances whose cards are likely rising in value, with buying tips
Vintage Card Analysis – Specialized analysis for pre-2000 cards covering 40+ iconic sets (e.g., 1909 T206, 1952 Topps, 1986 Fleer) with grade-based pricing, condition sensitivity, and investment outlook
Multi-Sport Coverage – Supports baseball, basketball, football, hockey, and soccer cards
Flexible Configuration – Works with mock data for immediate testing or integrates with eBay and Ball Don't Lie APIs for real data
Retrieves real-time sold and active listing data from eBay to facilitate sports card pricing lookups, market trend analysis, and arbitrage detection.
Provides Major League Baseball batting and pitching statistics to offer performance-based insights and investment analysis for baseball cards.
Integrates National Basketball Association player performance data and breakout alerts to track market value trends for basketball cards.
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 |
| Real-time sold and active prices from eBay. Supports any sport, brand, year, or grading. |
| Trend analysis comparing sold vs asking prices. Detects arbitrage opportunities where cards are listed below market value. |
Player Stats
Tool | Description |
| Multi-sport player stats (NBA/NFL/MLB) with card market insights based on performance. |
| NFL passing, rushing, receiving, and defensive stats with card market insights. |
| MLB batting (AVG, HR, RBI, OPS) and pitching (ERA, K, WHIP) stats with card insights. |
Analysis & Strategy
Tool | Description |
| Calculates whether grading a card is profitable. Compares raw vs graded prices for PSA, BGS, and SGC with fee-adjusted ROI. |
| Buy/sell/hold recommendations combining market trends with player performance data across all 3 sports. |
| Identifies NBA players with breakout performances whose cards are likely rising in value. |
| Era-specific analysis for pre-2000 cards. Covers 40+ iconic sets from 1909 T206 to 2000 Playoff Contenders with grade-based pricing. |
Related MCP server: sports-data-mcp-server
Quick Start
Install from PyPI
pip install sports-card-agentRun the server
sports-card-agentUse 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_keyThe 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 testsLicense
MIT
Available Tools
9 toolscard_investment_advisorA
Get a buy/sell/hold recommendation for a sports card based on market trends and player performance data.
Args: card_query: Card to evaluate, e.g. "2023 Topps Chrome Victor Wembanyama rookie auto" or "Ken Griffey Jr 1989 Upper Deck rookie". player_name: Optional player name for stats cross-reference. Improves accuracy. e.g. "Victor Wembanyama" sport: Sport for player stats lookup: "nba", "nfl", or "mlb". Default: "nba"
Returns: BUY/SELL/HOLD/AVOID recommendation with confidence level, supporting market data, player stats, and key factors.
Inputs: card_query (required), player_name, sport. Returns: result
card_market_analysisA
Full market analysis for a sports card: price trends, buy/sell spread, and arbitrage opportunities where cards are listed below market value.
Args: query: Card search query, e.g. "2024 Panini Prizm Caitlin Clark rookie" or "Ken Griffey Jr 1989 Upper Deck rookie". Include year, brand, player name, and any grading info for best results.
Returns: Comprehensive market analysis including: - Average sold price vs average asking price - Price direction (rising/falling/stable) - Market spread percentage - Arbitrage opportunities (underpriced active listings) - Actionable buying/selling insights
Inputs: query (required). Returns: result
card_price_lookupA
Look up current market prices for a sports trading card.
Args: query: Card search query, e.g. "2023 Topps Chrome Victor Wembanyama rookie" or "Michael Jordan Fleer rookie PSA 9". Include as much detail as possible: year, brand/set, player name, card number, parallel, and grading info. listing_type: "sold" for recent sold prices (true market value) or "active" for current asking prices. Default: "sold" limit: Number of results to return (1-50). Default: 15
Returns: Price summary with average, median, low, high and individual listings.
Inputs: query (required), listing_type, limit. Returns: result
grading_roi_calculatorA
Calculate whether it's worth paying to professionally grade a sports card. Compares raw card value vs graded card value, factoring in grading costs, turnaround time, and marketplace fees.
Args: card_query: Card description, e.g. "2023 Topps Chrome Wembanyama rookie" or "1986 Fleer Michael Jordan". Do NOT include grading info. grading_company: "PSA", "BGS", or "SGC". Default: "PSA" expected_grade: Expected grade if submitted, e.g. "10", "9", "8". Default: "10"
Returns: Detailed ROI analysis including raw vs graded prices, grading cost, net profit, ROI percentage, and a clear recommendation.
Inputs: card_query (required), grading_company, expected_grade. Returns: result
mlb_stats_lookupA
Look up MLB player stats and get card market insights. Covers batting stats (AVG, HR, RBI, OPS) and pitching stats (ERA, K, WHIP, W-L).
Args: player_name: MLB player name, e.g. "Shohei Ohtani", "Aaron Judge", "Gerrit Cole", "Paul Skenes". Partial names work. season: MLB season year (e.g. 2025). Default: 2025
Returns: Player bio, season stats (batting or pitching), and card market insight based on performance.
Inputs: player_name (required), season. Returns: result
nfl_stats_lookupA
Look up NFL player stats and get card market insights. Covers passing, rushing, receiving, and defensive stats.
Args: player_name: NFL player name, e.g. "Patrick Mahomes", "Josh Allen", "Justin Jefferson", "Micah Parsons". Partial names work. season: NFL season year (e.g. 2025). Default: 2025
Returns: Player bio, season stats (passing/rushing/receiving/defense), and card market insight based on performance.
Inputs: player_name (required), season. Returns: result
player_stats_lookupA
Look up player stats for NBA, NFL, or MLB and get card market insights based on their performance.
Args: player_name: Player name, e.g. "LeBron James", "Patrick Mahomes", "Shohei Ohtani". Partial names work. sport: "nba", "nfl", or "mlb". Default: "nba" season: Season year (e.g. 2025). Default: 2025
Returns: Player bio, current season stats, and card market insight based on their performance level.
Inputs: player_name (required), sport, season. Returns: result
trending_playersA
Get a list of NBA players with breakout performances whose trading cards are likely rising in value. Scans a curated watchlist of young stars and ascending players.
Args: limit: Number of trending players to return (1-20). Default: 10
Returns: Ranked list of trending players with their stats, trend score, breakout reasons, and card buying tips.
Inputs: limit. Returns: result
vintage_card_analysisA
Specialized analysis for vintage and classic sports cards (pre-2000). Provides era-specific insights, condition sensitivity analysis, grade-based pricing, and investment outlook.
Args: card_query: Vintage card description, e.g. "1952 Topps Mickey Mantle", "1986 Fleer Michael Jordan rookie", "1979 O-Pee-Chee Wayne Gretzky rookie", "1989 Upper Deck Ken Griffey Jr rookie". Include year, brand, and player name.
Returns: Era classification, set significance, condition impact analysis, estimated prices by grade, investment outlook, and collector tips.
Inputs: card_query (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
There is significant functional overlap between tools, particularly among the stats lookups (mlb_stats_lookup, nfl_stats_lookup, player_stats_lookup) which all provide similar player stats and card market insights, differing mainly by sport specificity. Additionally, card_market_analysis and card_price_lookup both retrieve pricing data, though with different focuses. The descriptions help clarify distinctions, but an agent could easily misselect between these overlapping tools.
Tool names mostly follow a consistent snake_case pattern with descriptive verb_noun or noun_verb structures (e.g., card_price_lookup, grading_roi_calculator). However, there is a minor inconsistency with trending_players (which uses an adjective_noun format) and player_stats_lookup (which overlaps in naming style with the sport-specific stats tools). Overall, the naming is readable and largely predictable.
With 9 tools, the count is well-scoped for a sports trading card agent, covering key areas like pricing, analysis, stats, and trends. Each tool serves a distinct niche within the domain, and the number is manageable without being overwhelming or insufficient for the server's purpose.
The tool set provides comprehensive coverage for sports card evaluation, including pricing, market analysis, stats, ROI calculation, and trend identification. A minor gap exists in the lack of tools for managing a card collection (e.g., adding, tracking, or valuing a personal inventory), but core workflows for investment advice and market research are well-supported.
Maintenance
Related MCP Connectors
Trading card prices, grading math, card shows, and collection and eBay tools for collectors.
Live sports stats and pre-computed analysis for AI assistants across NBA, MLB, NFL, and NHL.
Values graded sports cards and Pokémon/TCG slabs by grade from real sales. Free, read-only.
Trading card prices and grading ROI for 1.5M+ Pokémon, Magic, Yu-Gi-Oh! and sports cards. Read-only.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides AI-powered sports betting intelligence including live odds, injury reports, and documented picks for NBA, NHL, and NCAAB. It enables AI agents to analyze line movements, win rates, and betting edges using real-time data from sportsbettingaianalyzer.com.1123 PyPI5MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to access comprehensive sports data including football, basketball, American football, and hockey leagues via 11 tools, with no API key required.MIT
- FlicenseNot gradedqualityBmaintenanceEnables AI assistants to look up trading-card market values across Pokémon, Magic, sports and other TCG catalogs, including raw prices by condition, graded ladders, price history, trending movers and set checklists. It also calculates grading ROI — gem premiums, net profit after fees, expected value and break-even gem rates — so collectors can decide whether a card is worth submitting.-
- AlicenseBqualityBmaintenanceEnables AI agents to query live and historical sports analytics, consensus betting odds, predictions, scores, schedules, standings, rosters, news, play-by-play, and win probabilities through structured tools and resources.52384 PyPIApache 2.0