Sports Data MCP Server

24-in-1 MCP server for sports data. Get NHL hockey, MLB baseball, and Premier League soccer stats with AI assistants like Claude, GPT, or any MCP-compatible tool.

Built by John Rippy | johnrippy.link

---

🎯 What This Actor Does

This MCP server bundles 24 sports data tools into a single endpoint. AI assistants can call any tool to:

• NHL Hockey - Teams, rosters, standings, player stats, game boxscores, schedules, league leaders
• MLB Baseball - Teams, rosters, standings, player stats, game boxscores, schedules, league leaders
• Premier League Soccer - Standings, fixtures, teams, scorers, match details, head-to-head stats

---

🛠️ Available Tools

NHL Hockey (8 tools)

Tool	Description	Key Inputs
nhl_teams	Get all 32 NHL teams	None
nhl_team_roster	Get team roster with player details	teamAbbreviation (e.g., "STL")
nhl_team_schedule	Get team's game schedule	teamAbbreviation, season
nhl_standings	Get league standings by division	season
nhl_player_stats	Get player statistics	playerId
nhl_game_boxscore	Get detailed game stats	gameId
nhl_schedule	Get games for a date range	startDate, endDate
nhl_leaders	Get league stat leaders	category (goals, assists, points)

MLB Baseball (8 tools)

Tool	Description	Key Inputs
mlb_teams	Get all 30 MLB teams	None
mlb_team_roster	Get team roster with player details	teamId
mlb_team_schedule	Get team's game schedule	teamId, season
mlb_standings	Get league standings by division	season
mlb_player_stats	Get player statistics	playerId, season
mlb_game_boxscore	Get detailed game stats	gameId
mlb_schedule	Get games for a date range	startDate, endDate
mlb_leaders	Get league stat leaders	category (batting, pitching)

Premier League Soccer (8 tools)

Tool	Description	Key Inputs
premier_league_standings	Get current table	season
premier_league_fixtures	Get upcoming matches	matchday
premier_league_teams	Get all 20 teams in league	season
premier_league_team_details	Get specific team info	teamId
premier_league_scorers	Get top scorers	season, limit
premier_league_match	Get single match details	matchId
premier_league_matches	Get matches for date range	dateFrom, dateTo
premier_league_head_to_head	Get H2H stats between teams	matchId

---

💰 Pricing (Pay-Per-Event)

Category	Cost per Call
NHL tools	$0.01/call
MLB tools	$0.01/call
Premier League tools	$0.02/call

Demo mode is FREE - Test any tool with sample data before using real credits.

---

🚀 Quick Start

Demo Mode (Free)

{
  "tool": "nhl_standings",
  "demoMode": true
}

Real Data

{
  "apifyToken": "your_apify_token",
  "footballDataApiKey": "your_football_data_key",
  "tool": "premier_league_standings",
  "toolInput": {
    "season": 2024
  },
  "demoMode": false
}

---

📋 Tool Input Examples

NHL Tools

nhl_teams

{
  "tool": "nhl_teams",
  "demoMode": false
}

nhl_team_roster

{
  "tool": "nhl_team_roster",
  "toolInput": {
    "teamAbbreviation": "STL"
  }
}

nhl_standings

{
  "tool": "nhl_standings",
  "toolInput": {
    "season": "20242025"
  }
}

nhl_player_stats

{
  "tool": "nhl_player_stats",
  "toolInput": {
    "playerId": 8478402
  }
}

MLB Tools

mlb_teams

{
  "tool": "mlb_teams",
  "demoMode": false
}

mlb_team_roster

{
  "tool": "mlb_team_roster",
  "toolInput": {
    "teamId": 138
  }
}

mlb_standings

{
  "tool": "mlb_standings",
  "toolInput": {
    "season": 2024
  }
}

mlb_player_stats

{
  "tool": "mlb_player_stats",
  "toolInput": {
    "playerId": 545361,
    "season": 2024
  }
}

Premier League Tools

premier_league_standings

{
  "tool": "premier_league_standings",
  "toolInput": {
    "season": 2024
  }
}

premier_league_scorers

{
  "tool": "premier_league_scorers",
  "toolInput": {
    "season": 2024,
    "limit": 10
  }
}

premier_league_team_details

{
  "tool": "premier_league_team_details",
  "toolInput": {
    "teamId": 57
  }
}

---

🔗 MCP Integration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "sports-data": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-client", "https://api.apify.com/v2/acts/localhowl~sports-data-mcp-server/runs?token=YOUR_TOKEN"]
    }
  }
}

n8n / Make / Zapier

Use the webhook URL parameter to receive results:

{
  "tool": "nhl_standings",
  "toolInput": { "season": "20242025" },
  "webhookUrl": "https://your-webhook-endpoint.com/receive"
}

---

📊 Sample Output

nhl_standings

{
  "tool": "nhl_standings",
  "standings": [
    {
      "division": "Central",
      "teams": [
        {
          "team": "Winnipeg Jets",
          "abbreviation": "WPG",
          "wins": 32,
          "losses": 12,
          "otLosses": 3,
          "points": 67,
          "gamesPlayed": 47
        }
      ]
    }
  ]
}

mlb_standings

{
  "tool": "mlb_standings",
  "standings": [
    {
      "division": "AL Central",
      "teams": [
        {
          "team": "Cleveland Guardians",
          "wins": 92,
          "losses": 70,
          "pct": ".568",
          "gamesBack": "-"
        }
      ]
    }
  ]
}

premier_league_standings

{
  "tool": "premier_league_standings",
  "standings": [
    {
      "position": 1,
      "team": "Liverpool",
      "playedGames": 19,
      "won": 14,
      "draw": 4,
      "lost": 1,
      "points": 46,
      "goalsFor": 45,
      "goalsAgainst": 17
    }
  ]
}

---

🔧 API Sources

League	API	Auth Required
NHL	api-web.nhle.com	No (free)
MLB	statsapi.mlb.com	No (free)
Premier League	football-data.org	Yes (free tier: 10 calls/min)

---

❓ FAQ

Q: What's the difference between demo mode and real data? A: Demo mode returns realistic sample data instantly (free). Real data mode calls the actual APIs and returns live data.

Q: Do I need API keys? A: NHL and MLB are free public APIs. Premier League requires a free API key from football-data.org.

Q: Can I use this without an AI assistant? A: Yes! Call the Apify API directly or use the Apify console to run the actor.

---

📞 Support

• GitHub Issues: Report bugs or request features
• LinkedIn: John Rippy
• Website: johnrippy.link