Skip to main content
Glama

MLB Stats MCP Server

by jdguggs10
GitHub
JavaScript
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

MLB Stats MCP Server - Enhanced with Meta-Tools

🔧 Version 2.1 - Now with Entity Resolution Meta-Tools!

A Cloudflare Worker that serves as an enhanced MCP (Model Context Protocol) server for accessing MLB Stats API data. Features meta-tools for intelligent entity resolution, comprehensive team/player mappings, and optimized data access patterns.

🎯 Enhanced Features

🔧 Meta-Tools for Entity Resolution

  • resolve_team: Convert team names to canonical MLB team IDs

  • resolve_player: Convert player names to canonical MLB player IDs

  • Comprehensive Mappings: All 30 MLB teams with aliases and abbreviations

  • Fuzzy Matching: "Yankees", "NYY", "New York Yankees" all resolve correctly

  • Smart Suggestions: "Did you mean?" fallbacks for typos and partial matches

⚾ MLB Data Access

  • Direct MLB API proxy with zero additional latency

  • All MLB endpoints supported (teams, players, stats, schedules, etc.)

  • CORS enabled for web applications

  • No API keys required (MLB Stats API is public)

  • Error handling and validation with detailed responses

🏗️ Architecture Benefits

  • Domain logic ownership: All MLB-specific logic contained within this worker

  • Service binding ready: Optimized for Cloudflare worker-to-worker communication

  • Token efficient: Meta-tools reduce round-trips and enable smart caching

  • Future-proof: Extensible pattern for other sports (NFL, NBA, NHL)

🛠️ Available Commands

🔧 Meta-Tools (Entity Resolution)

resolve_team - Team Name Resolution

Convert any team reference to canonical MLB team information.

Request:

{ "command": "resolve_team", "params": { "name": "Yankees" } }

Response:

{ "result": { "id": 147, "name": "New York Yankees", "abbreviation": "NYY", "query": "Yankees", "resolved": true } }

Supported Inputs:

  • Team names: "Yankees", "Red Sox", "Dodgers"

  • Full names: "New York Yankees", "Boston Red Sox"

  • Abbreviations: "NYY", "BOS", "LAD"

  • Cities: "New York", "Boston", "Los Angeles"

resolve_player - Player Name Resolution

Convert any player reference to canonical MLB player information.

Request:

{ "command": "resolve_player", "params": { "name": "Judge" } }

Response:

{ "result": { "id": 592450, "name": "Aaron Judge", "team": "New York Yankees", "query": "Judge", "resolved": true } }

Supported Players:

  • Aaron Judge, Shohei Ohtani, Mookie Betts, Freddie Freeman

  • Ronald Acuna Jr., Mike Trout, and other star players

  • Both full names and last names supported

⚾ MLB Data Commands

  • getTeamInfo - Get team information and details

  • getRoster - Get team roster and player positions

  • getPlayerStats - Get player statistics (hitting, pitching)

  • getSchedule - Get game schedule and dates

  • getLiveGame - Get live game data and updates

  • getStandings - Get league and division standings

  • getGameBoxscore - Get detailed game boxscore

  • getPlayerInfo - Get player biographical information

  • getSeasons - Get season information and years

  • getVenues - Get stadium and venue information

🎯 Enhanced Workflow

Traditional Approach:

// Step 1: User needs to know exact team ID {"command": "getRoster", "params": {"pathParams": {"teamId": "147"}}}

Enhanced Meta-Tool Approach:

// Step 1: Resolve team name to ID {"command": "resolve_team", "params": {"name": "Yankees"}} // Returns: {"result": {"id": 147, "name": "New York Yankees"}} // Step 2: Use resolved ID automatically (handled by sports-proxy) {"command": "getRoster", "params": {"pathParams": {"teamId": "147"}}}

Request Format

Send POST requests to the worker endpoint with the following JSON structure:

{ "command": "getPlayerStats", "params": { "pathParams": { "playerId": "660271" }, "queryParams": { "stats": "season", "group": "hitting", "season": "2024" } } }

Response Format

Successful responses return:

{ "result": { // MLB API response data } }

Error responses return:

{ "error": "Error message" }

Development

  1. Install Wrangler CLI:

    npm install -g wrangler

  2. Login to Cloudflare:

    wrangler login

  3. Deploy the worker:

    wrangler deploy

📋 Complete Usage Examples

🔧 Meta-Tool Examples

Resolve Team Names

# Basic team resolution curl -X POST https://mlbstats-mcp.your-domain.workers.dev \ -H "Content-Type: application/json" \ -d '{ "command": "resolve_team", "params": {"name": "Yankees"} }' # Response: {"result": {"id": 147, "name": "New York Yankees", "abbreviation": "NYY"}}
# Handle abbreviations and cities curl -X POST https://mlbstats-mcp.your-domain.workers.dev \ -H "Content-Type: application/json" \ -d '{ "command": "resolve_team", "params": {"name": "LAD"} }' # Response: {"result": {"id": 119, "name": "Los Angeles Dodgers", "abbreviation": "LAD"}}

Resolve Player Names

# Resolve player by last name curl -X POST https://mlbstats-mcp.your-domain.workers.dev \ -H "Content-Type: application/json" \ -d '{ "command": "resolve_player", "params": {"name": "Ohtani"} }' # Response: {"result": {"id": 660271, "name": "Shohei Ohtani", "team": "Los Angeles Dodgers"}}

⚾ Data Retrieval Examples

Get Team Information

{ "command": "getTeamInfo", "params": { "queryParams": { "season": "2025", "sportId": "1" } } }

Get Player Stats (with resolved player ID)

{ "command": "getPlayerStats", "params": { "pathParams": { "playerId": "592450" // Aaron Judge (from resolve_player) }, "queryParams": { "stats": "season", "group": "hitting", "season": "2025" } } }

Get Team Roster (with resolved team ID)

{ "command": "getRoster", "params": { "pathParams": { "teamId": "147" // Yankees (from resolve_team) }, "queryParams": { "season": "2025" } } }

Get Schedule

{ "command": "getSchedule", "params": { "queryParams": { "sportId": "1", "date": "2025-07-04", "teamId": "147" // Optional: filter by resolved team } } }

🔍 Error Handling Examples

Team Not Found

// Request: {"command": "resolve_team", "params": {"name": "Cowbays"}} // Response: { "error": "Team \"Cowbays\" not found. Did you mean: cowboys, astros, royals?" }

Player Not Found

// Request: {"command": "resolve_player", "params": {"name": "Jduge"}} // Response: { "error": "Player \"Jduge\" not found. Did you mean: judge?" }

🚀 Integration with Sports-Proxy

When used with the enhanced sports-proxy, the workflow becomes seamless:

# User input: "Get the Yankees roster" # 1. Sports-proxy detects MLB sport # 2. Extracts tools: resolve_team("yankees"), get_team_roster({}) # 3. MLB MCP resolves: resolve_team → {id: 147} # 4. Sports-proxy enriches: get_team_roster({teamId: "147"}) # 5. MLB MCP returns: Complete roster data

This eliminates the need for manual entity resolution and creates a natural language interface to MLB data!

This server cannot be installed

-
security - not tested
-
license - not tested
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Cloudflare Worker that provides access to MLB Statistics API data through the Model Context Protocol, supporting multiple endpoints like team info, player stats, game schedules, and live game data.

  1. 🎯 Enhanced Features
    1. 🔧 Meta-Tools for Entity Resolution
    2. ⚾ MLB Data Access
    3. 🏗️ Architecture Benefits
  2. 🛠️ Available Commands
    1. 🔧 Meta-Tools (Entity Resolution)
    2. ⚾ MLB Data Commands
    3. 🎯 Enhanced Workflow
  3. Request Format
    1. Response Format
      1. Development
        1. 📋 Complete Usage Examples
          1. 🔧 Meta-Tool Examples
          2. ⚾ Data Retrieval Examples
          3. 🔍 Error Handling Examples
          4. 🚀 Integration with Sports-Proxy

        Related MCP Servers

        • Remote MCP Server (Authless)

          apples2gotoday
          -
          security
          -
          license
          -
          quality
          A Cloudflare Workers-based Model Context Protocol server that can be deployed without authentication requirements, allowing users to create custom AI tools accessible from Cloudflare AI Playground or Claude Desktop.
          Last updated -

        • MLB Projections MCP Server

          ag2-mcp-servers
          -
          security
          -
          license
          -
          quality
          An MCP server that enables interaction with MLB (Major League Baseball) v3 projections through the SportsData.io API, allowing access to baseball statistics and projections through natural language.
          Last updated -

        • MLB V3 Scores MCP Server

          ag2-mcp-servers
          -
          security
          -
          license
          -
          quality
          An MCP Server that enables interaction with MLB scores and statistics via the SportsData.io MLB V3 Scores API, allowing users to access baseball data through natural language queries.
          Last updated -

        • Remote MCP Server (Authless)

          rokith
          -
          security
          -
          license
          -
          quality
          A deployable Cloudflare Workers service that implements Model Context Protocol without authentication, allowing AI models to access custom tools via clients like Claude Desktop or Cloudflare AI Playground.
          Last updated -

        View all related MCP servers

        New MCP Servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/jdguggs10/mlbstats-mcp'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server