Advertise
MCP.so
Sign In

MLB Stats MCP Server

@etweisberg

Repository

Basic information

Category

Other

Transports

stdio

Author

etweisberg

About MLB Stats MCP Server

MCP server for advanced baseball analytics (statcast, fangraphs, baseball reference, mlb stats API)

#mcp#baseball-statistics#statcast#baseball-data#mlb-stats-api#baseball-analytics#fangraphs#mcp-server#mcp-client

MLB Stats MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mlb-mcp": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

MLB Stats MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MLB Stats MCP Server?

A Python project that implements a Model Context Protocol (MCP) server for accessing Major League Baseball statistics. It combines the MLB Stats API and the pybaseball library (Statcast, FanGraphs, Baseball Reference) to provide structured baseball data to MCP-compatible clients like Claude Desktop.

How to use MLB Stats MCP Server?

Install uv, create a virtual environment (uv venv), activate it, and install dependencies (uv pip install -e .). Set the ANTHROPIC_API_KEY environment variable and optionally configure logging. Then add the server to your MCP client (e.g., Claude Desktop) using the provided JSON configuration.

Key features of MLB Stats MCP Server

  • Combines MLB Stats API, Statcast, FanGraphs, and Baseball Reference data.
  • Generates matplotlib plots returned as base64-encoded images.
  • Configurable logging via environment variables (MLB_STATS_LOG_LEVEL, MLB_STATS_LOG_FILE).
  • Comprehensive test suite using pytest and pytest-asyncio.
  • Linting and code formatting enforced by Ruff and pre-commit hooks.
  • Option to install automatically via Smithery for Claude Desktop.

Use cases of MLB Stats MCP Server

  • Query player statistics, game logs, and team data from multiple MLB sources.
  • Retrieve Statcast metrics (exit velocity, launch angle, etc.) for advanced analysis.
  • Generate and view matplotlib visualizations of baseball data.
  • Integrate real-time baseball data into AI assistants using MCP protocol.

Frequently asked questions

1

What dependencies does the server require?

Python, `uv` (package manager), and libraries including `mcp[cli]`, `mlb-statsapi`, `httpx`, `pytest`, `pytest-asyncio`, and `matplotlib` (for plotting).

2

How do I install the server?

Run `uv venv && source .venv/bin/activate && uv pip install -e .` in the project directory. Alternatively, install via Smithery with `npx -y @smithery/cli install @etweisberg/mlb-mcp --client claude`.

3

How do I configure the server for Claude Desktop?

Add an entry to `claude_desktop_config.json` with the `command` set to your `uv` path, `args` pointing to `python -m mlb_stats_mcp.server`, and `env` for logging and API key.

4

How do I configure logging?

Set the environment variables `MLB_STATS_LOG_LEVEL` (e.g., DEBUG, INFO) and `MLB_STATS_LOG_FILE` (path to log file). If the log file is not set, logs go to stdout.

5

What data sources are available through the tools?

The server provides tools for the MLB Stats API, Statcast data, and supplemental `pybaseball` functions for FanGraphs and Baseball Reference statistics.

Comments

More Other MCP servers

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K
Advertise