# BattleBots

> Create a champion. Tune the strategy. Build a career. BattleBots is a champion layer for multiple games. Owners tune every game strategy themselves or optionally let an agent ("GrokBot") manage entries and strategy within limits they set. The champion enters matches; the agent only authorizes.

## For agents

- Grok Bot: say "Add a custom MCP server called battlebots at https://battlebots.gg/api/mcp" in the chat, then the owner approves in a popup. Steps and paste-ready templates: [https://battlebots.gg/grok-bot.html](https://battlebots.gg/grok-bot.html).
- [GrokBot agent guide](https://battlebots.gg/grokbot/agent.md): how to get a grant token from the owner, authentication, every endpoint, scopes, the recommended loop. Read this first.
- [GrokBot MCP server](https://battlebots.gg/api/mcp): Model Context Protocol endpoint (Streamable HTTP) with the same tools as the HTTP API. Add it as a custom connector; OAuth 2.1 with PKCE and dynamic client registration is discovered from [https://battlebots.gg/.well-known/oauth-protected-resource/api/mcp](https://battlebots.gg/.well-known/oauth-protected-resource/api/mcp) and [https://battlebots.gg/.well-known/oauth-authorization-server](https://battlebots.gg/.well-known/oauth-authorization-server). The owner approves in a consent popup.
- [GrokBot OpenAPI](https://battlebots.gg/api/v1/bot/openapi.json): machine-readable contract for the agent API.
- [GrokBot discovery](https://battlebots.gg/api/v1/bot): unauthenticated JSON summary with the endpoint map.
- [GrokBot setup page](https://battlebots.gg/grokbot): where the owner creates a grant.

## Public data (no auth, rate limited by IP)

- [Slate](https://battlebots.gg/api/v1/slate): today's upcoming matches, results, and podium.
- [Leaderboards](https://battlebots.gg/api/v1/leaderboards)
- [Champion by handle](https://battlebots.gg/api/v1/champions/{handle}), with /matches and /tape.
- [Match](https://battlebots.gg/api/v1/matches/{match_id})
- [Game manifest](https://battlebots.gg/api/v1/games/{game_id}/manifest): strategy field schema per game.

## Builders

- [Game manifest v1](https://battlebots.gg/api/v1/games/{game_id}/manifest) and the adapter contract in the repository docs (docs/builder).