super-bowl-squares

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"