Sports Card Agent

io.github.rjexile由 GitHub 帳號 rjexile 發布v1.0.1更新於 Oct 24, 2026

Sports card pricing, market analysis, grading ROI, and player stats (NBA/NFL/MLB)

已驗證STDIO僅桌面金融資料與分析

概覽

AI 產生的概覽

讓助理查詢運動球星卡價格、市場趨勢、鑑定投資報酬率，以及 NBA/NFL/MLB 球員數據。

可以做什麼
提供九個工具進行球星卡研究：eBay 成交價與在售價查詢、含套利偵測的市場趨勢分析、PSA、BGS、SGC 的鑑定投資報酬率計算、買進/賣出/持有建議、熱門球員提醒，以及涵蓋 40 多個 2000 年前系列的復古卡分析。球員數據工具涵蓋 NBA、NFL、MLB 表現並結合卡市背景。它在本機執行，未設定 API 金鑰時可用模擬資料啟動。
適用情境
適合需要為某張卡定價、判斷鑑定費用是否划算、比較裸卡與鑑定卡價值，或把球員近期表現與卡價走勢連結起來的情境。較適合收藏者與賣家反覆做卡片研究，而非一次性查詢。
執行需求
以本機 Python 程序執行，從 PyPI 安裝（pip install sports-card-agent），透過 stdio 通訊，僅支援桌面端。選用憑證：球員數據需要 BALLDONTLIE_API_KEY，eBay 價格需要 EBAY_APP_ID 與 EBAY_CERT_ID。未設定金鑰時會退回模擬資料。取得即時資料需要網路連線。
安裝前請注意
需要三個密鑰：BALLDONTLIE_API_KEY、EBAY_APP_ID 和 EBAY_CERT_ID；請放在環境變數或 .env 檔案中，不要外流。未設定金鑰時伺服器回傳模擬資料，價格與建議可能是虛構的，而非真實資料。投資建議與套利訊號屬於模型生成內容，並非經查證的理財指導，卡價依賴第三方 eBay 與數據 API。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Sports Card Agent，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

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

bash
pip install sports-card-agent

Run the server

bash
sports-card-agent

Use with Claude Desktop

Add to your claude_desktop_config.json:

json
{  "mcpServers": {    "sports-card-agent": {      "command": "sports-card-agent"    }  }}

Use with Claude Code

Add to your .mcp.json:

json
{  "mcpServers": {    "sports-card-agent": {      "command": "sports-card-agent"    }  }}

Configuration

Create a .env file or set environment variables:

bash
# eBay API (register free at developer.ebay.com)EBAY_APP_ID=your_app_idEBAY_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

bash
git clone https://github.com/rjexile/sports-card-agent.gitcd sports-card-agentpython -m venv venvsource venv/Scripts/activate  # Windowspip install -e .python test_all.py  # Run all 29 tests

License

MIT

來源：README.md，提交 9e59a60

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分