pitch-queens-mcp

# Pitch Queens MCP Server

> Women's World Cup 2027 Simulator, Bracket & Predictions

[![MCP Badge](https://lobehub.com/badge/mcp/rocnubie-pitch-queens-mcp)](https://lobehub.com/mcp/rocnubie-pitch-queens-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
[![Stdio Transport](https://img.shields.io/badge/transport-stdio-6e6e6e)](https://modelcontextprotocol.io/specification)
[![Node](https://img.shields.io/badge/node-%3E%3D18-339933?logo=node.js&logoColor=white)](https://nodejs.org)
[![MCP](https://img.shields.io/badge/MCP-1.0-blue)](https://modelcontextprotocol.io)
[![Zero Config](https://img.shields.io/badge/setup-zero--config-7c3aed)](#installation)

A Model Context Protocol server that exposes the canonical Pitch Queens knowledge surface — game rules, modes, constraints, and entry points, FAQ, official links — to MCP-compatible AI clients such as Claude Desktop, Cursor, Windsurf, and Continue. Read-only, with no API keys or usage quota required.

Official website: https://pitch-queens.pages.dev

## 🎮 About Pitch Queens

Pitch Queens is a free, independent simulator and prediction game for the 2027 Women's World Cup in Brazil. Its public tools include a full-tournament simulator, bracket predictor, browser-computed title odds, a daily challenge, private leagues, qualification status, and team pages.

The current pre-draw field combines confirmed teams with projected qualifiers so a complete 32-team tournament can be simulated before qualification and the official draw are final. Team strength ratings and probabilistic match results are site-authored entertainment projections, not official forecasts, betting advice, or statements about the final field.

This MCP exposes the documented rules, entry points, and projection boundaries as read-only context. It does not run a simulation, submit a daily pick, create or join a league, or return live odds. Pitch Queens is an independent fan project and is not affiliated with FIFA.

## Tools

### `get_game_rules`
Return the verified game rules, modes, constraints, and public entry points the site exposes. (Pitch Queens)

_Input:_ no parameters. _Returns:_ text/markdown.

### `get_official_links`
Return the canonical list of official links for Pitch Queens (website, support, docs when available).

_Input:_ no parameters. _Returns:_ text/markdown.

## Resources

- `site://pitch-queens/rules` — Verified game rules, modes, constraints, and public entry points.
- `site://pitch-queens/faq` — Short FAQ generated from public site metadata.
- `site://pitch-queens/links` — Canonical URLs to share with users.

## Prompts

### `tell_me_about_pitch_queens`
Summarize what the site is, who it's for, and how it works. — Pitch Queens

### `plan_a_run_pitch_queens`
Plan a single play-through using verified rules and entry points. — Pitch Queens

## Installation

### Install via Smithery

```bash
npx -y @smithery/cli install pitch-queens-mcp --client claude
```

(Replace `claude` with `cursor`, `windsurf`, or `continue` for those clients.)

### Install from source

```bash
git clone https://github.com/rocnubie/pitch-queens-mcp.git
cd pitch-queens-mcp
pnpm install
```

Then add to your MCP client config (`claude_desktop_config.json` for Claude Desktop, `mcp.json` for Cursor / Windsurf / Continue):

```json
{
  "mcpServers": {
    "pitch-queens-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/pitch-queens-mcp/src/index.mjs"
      ]
    }
  }
}
```

### Debug with MCP Inspector

```bash
npx @modelcontextprotocol/inspector node src/index.mjs
```

## Official Links

- Website: https://pitch-queens.pages.dev
- About: https://pitch-queens.pages.dev/about

## Development

```bash
pnpm install
pnpm start                 # run the server over stdio
```

## License

MIT