# StatHead MCP server

> Provides an AI client with live NFL fantasy football analytics, including player stats, dynasty values, Sleeper league data, and custom Excel projections.

- Repository: https://github.com/dachhack/stathead
- Page: https://hostedmcp.org/servers/dachhack/stathead-mcp
- Transport: stdio
- Stars: 3
- License: MIT
- Latest version: 1.0.126

## Install

### Claude Code

```sh
claude mcp add stathead-mcp -- npx -y stathead-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "stathead-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "stathead-mcp"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "stathead-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "stathead-mcp"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"stathead-mcp","type":"stdio","command":"npx","args":["-y","stathead-mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "stathead-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "stathead-mcp"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add stathead-mcp -- npx -y stathead-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.stathead-mcp]
command = "npx"
args = ["-y", "stathead-mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user stathead-mcp npx -- -y stathead-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "stathead-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "stathead-mcp"
      ]
    }
  }
}
```

## FAQ

### How do I use my own projections and rankings?

You can export projections or rankings to an Excel file, edit the values in Excel or Google Sheets, and then import the file back to use those values as overrides in your queries.

### Does this server require any runtime dependencies to run?

No, it is a single self-contained bundle with no runtime dependencies that fetches all data on demand.

### Can I use this with Claude Desktop?

Yes, you can add it to your Claude Desktop configuration file using npx to run the server.

### How can I access the tools via a URL instead of a local command?

The tools are hosted over MCP's Streamable HTTP transport by a Cloudflare Worker, which you can add as a custom connector in Claude.
