Start.gg MCP Server
A Model Context Protocol (MCP) server that provides access to the Start.gg GraphQL API. This server allows LLMs to query tournament information, event standings, player sets, and report bracket results directly.
Features
- Tournament & Event Discovery: Look up tournaments and events by their slugs and IDs.
- Standings & Statistics: Fetch event standings, entrants, and recent sets for specific players.
- Bracket Management: Retrieve bracket sets (matches) and report winners.
- Game Search: Find videogame IDs to filter tournament searches.
Prerequisites
- Node.js: Version 22.0.0 or higher.
- Start.gg API Key: You must have a valid Personal Access Token from Start.gg Developer Settings.
Setup & Configuration
1. Get an API Key
- Log in to Start.gg.
- Go to Developer Settings in your profile.
- Create a new Personal Access Token.
- Copy the token and keep it secure.
2. Environment Variables
The server requires the following environment variable to be set:
STARTGG_API_KEY: Your Start.gg Personal Access Token.
3. Build & Run locally
Clone the repository and install dependencies:
npm install
npm run build
npm run start:stdio
Available Tools
| Tool | Description |
|---|---|
get_tournament | Retrieves details for a tournament by slug, including its events. |
get_event | Retrieves details for an event by slug (e.g., tournament/genesis-9/event/ultimate-singles). |
get_event_standings | Retrieves paginated standings (placements) for an event ID. |
get_event_entrants | Retrieves a paginated list of entrants for an event ID. |
get_event_sets | Retrieves paginated bracket sets (matches) for an event ID. |
get_player_sets | Retrieves the most recent sets played by a player by their player ID. |
search_videogame | Retrieves the Start.gg videogame ID for a given game name. |
report_bracket_set | Reports the winner of a specific bracket set. |
Usage with MCP Clients
Claude Desktop
Add the following configuration to your claude_desktop_config.json:
{
"mcpServers": {
"startgg": {
"command": "node",
"args": ["/path/to/startgg-mcp/dist/index.js"],
"env": {
"STARTGG_API_KEY": "your_api_key_here"
}
}
}
}
Example Prompts
Once configured, you can ask Claude things like:
- "Who won the Melee singles at Genesis X?"
- "Find the Start.gg ID for Super Smash Bros. Melee."
- "Show me the top 8 standings for the Ultimate event at Smash Con 2024."
- "What are the most recent sets played by Mang0?"
Troubleshooting
API Key Issues
- Ensure
STARTGG_API_KEYis correctly set in your environment or client config. - Verify the key is a "Personal Access Token" and not a "Client ID".
- Check if your key has expired or has been revoked in Start.gg settings.
Connection Errors
- If running via HTTP, ensure the server is listening on the correct port and accessible from your client.
- Check the server logs (outputted to stderr in stdio mode) for detailed error messages.
Development
- Build:
npm run build - Watch mode:
npm run dev:stdio - Lint & Format:
bun run devcheck - Test:
npm test
License
Apache-2.0