mcpField
S
Sports Trading Card Agent

Sports Trading Card Agent

Local
github.com/rjexileAI & Agents3Updated 31w ago

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

  1. 01Look up eBay sold and active prices
  2. 02Analyze trends and detect arbitrage opportunities
  3. 03Retrieve NBA, NFL, and MLB player stats
  4. 04Calculate PSA, BGS, and SGC grading ROI
  5. 05Get buy, sell, or hold recommendations
  6. 06Analyze vintage cards and track trending players

Use cases

  1. 01Assess the market price of a specific card
  2. 02Compare potential returns on raw and graded cards
  3. 03Use player performance to inform trading decisions
  4. 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.

mcp.json · Universal config
{
"mcpServers": {
"sports-card-agent": {
"command": "uvx",
"args": [
"sports-card-agent"
],
"env": {
"EBAY_APP_ID": "<EBAY_APP_ID>",
"EBAY_CERT_ID": "<EBAY_CERT_ID>",
"BALLDONTLIE_API_KEY": "<BALLDONTLIE_API_KEY>"
}
}
}
}
Run commanduvx sports-card-agent
Environment variables to set
EBAY_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.

Packages
pypisports-card-agent1.0.1

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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
ToolDescription
card_price_lookupReal-time sold and active prices from eBay. Supports any sport, brand, year, or grading.
card_market_analysisTrend analysis comparing sold vs asking prices. Detects arbitrage opportunities where cards are listed below market value.
Player Stats
ToolDescription
player_stats_lookupMulti-sport player stats (NBA/NFL/MLB) with card market insights based on performance.
nfl_stats_lookupNFL passing, rushing, receiving, and defensive stats with card market insights.
mlb_stats_lookupMLB batting (AVG, HR, RBI, OPS) and pitching (ERA, K, WHIP) stats with card insights.
Analysis & Strategy
ToolDescription
grading_roi_calculatorCalculates whether grading a card is profitable. Compares raw vs graded prices for PSA, BGS, and SGC with fee-adjusted ROI.
card_investment_advisorBuy/sell/hold recommendations combining market trends with player performance data across all 3 sports.
trending_playersIdentifies NBA players with breakout performances whose cards are likely rising in value.
vintage_card_analysisEra-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

Markdown supported

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.