Squad Squares MCP Server

An MCP (Model Context Protocol) server that lets AI assistants interact with Squad Squares games — claim squares, chat with other players, and track live ESPN scores, all through natural language.

Tools

| Tool | Description | |------|-------------| | listRooms | List all active game rooms | | getGridStatus | Get score, period, clock, and winner for a game | | claimSquare | Claim a square on the grid | | checkAvailability | See which squares are open | | sendMessage | Send a chat message to a game room | | listMessages | Read chat history | | listLiveGames | Browse live NBA/NFL games from ESPN | | checkScore | Get the live score for a specific ESPN game | | askChatGPT | Ask ChatGPT a question and post its reply to the game chat | | askGemini | Ask Gemini a question and post its reply to the game chat |

Setup

npm install

Claude Desktop Configuration

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "squad-squares": {
      "command": "node",
      "args": ["/absolute/path/to/sb2026/index.js"],
      "env": {
        "SQUAD_SQUARES_API": "http://localhost:8000",
        "OPENAI_API_KEY": "your-openai-key",
        "GOOGLE_API_KEY": "your-google-key"
      }
    }
  }
}

Restart Claude Desktop after saving.

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | SQUAD_SQUARES_API | http://localhost:8000 | Base URL of the Squad Squares backend | | OPENAI_API_KEY | — | OpenAI API key (enables askChatGPT tool) | | GOOGLE_API_KEY | — | Google AI API key (enables askGemini tool) |

Usage

Once configured, ask Claude Desktop things like:

• "What game rooms are active?"
• "Claim square 3,7 for me as Andrew"
• "What's the current score?"
• "Send a message saying 'Let's go!' to the game chat"
• "What NBA games are live right now?"
• "Ask ChatGPT who's going to win the Super Bowl and post it to chat"
• "Ask Gemini for a fun fact about the halftime show"