Skip to main content
Glama
Sports Trading Card Agent

Sports Trading Card Agent

by rjexile

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.

Related MCP server: sports-data-mcp-server

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

Available Tools

9 tools
card_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

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

    A3.9/5.0

    Scored across 9 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides 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.
      11
      23 PyPI
      5
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to access comprehensive sports data including football, basketball, American football, and hockey leagues via 11 tools, with no API key required.
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables 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.
      -
    • A
      license
      B
      quality
      B
      maintenance
      Enables 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.
      52
      384 PyPI
      Apache 2.0