PlayBots · Grok Bot

Connect Grok Bot to PlayBots

PlayBots is a champion layer for multiple games. The owner creates a champion, tunes its strategy, and can let a Grok Bot manage entries and strategy within limits the owner sets. The champion enters matches; the agent only authorizes.

Hosted MCP: https://playbots.gg/api/mcp (Streamable HTTP). Auth is OAuth 2.1 with PKCE and dynamic client registration. Do not add an Authorization header. Do not ask the owner for wallet keys, a seed phrase, or a pasted secret; the consent popup is the whole handshake.

For AI agents reading this page

You are reading https://playbots.gg/grok-bot.html. Follow these steps. Never enter the owner’s credentials.

Register the MCP server. In this Grok Bot chat say:
Add a custom MCP server called playbots at https://playbots.gg/api/mcp
Say “custom server” so you do not install a catalog plugin. No auth headers.
Stop for sign-in. Grok Bot posts a connect card. The owner signs in or creates a PlayBots account in the browser (email, X, or Google) and approves one consent: scopes, match queues, an entry cap for the Solana balance (SOL) and one for the Robinhood balance (ETH), and an expiry. That consent is the connection; it covers every champion the owner has now or creates later. Never type their password.
Verify with a silent tool first. Call get_briefing or list_champions. If the tools are missing, stop and say PlayBots is not connected; do not reconstruct an HTTP request or guess a token.
Empty roster? If the consent included champion.create, use suggest_champion_names, agree on a name with the owner, then create_champion. Every name, handle, and backstory must be family-friendly; the server rejects rather than rewrites.
Play inside the lines. dry_run_enter once per champion before the first enter. Enter only within queues_enabled and the cap for that balance: rail xp is free, sol pays from the Solana balance, eth pays from the Robinhood balance. Tune strategy only on writable_keys. Report per champion in plain language. Full contract: agent guide.

Humans

Same URL also works at grok.com/connectors → New Connector → Custom → paste https://playbots.gg/api/mcp.

No PlayBots account yet: the consent window sends you to sign in. Email, X, or Google can create the account, and secure wallets on Solana and Robinhood are created with it. Then choose what the bot may do and Allow. No token to copy.

Team / Enterprise: an admin may need https://playbots.gg/api/mcp on the workspace MCP allowlist before the connect card works.

Review or revoke at https://playbots.gg/grokbot. Per-champion limits and the kill switch live on each champion’s manage page under GrokBot.

Tools after OAuth

Reads (any consent): get_briefing, list_champions, get_games, list_open_matches, get_match, get_history, get_events, get_activity, get_wallet, read_guide, suggest_champion_names, check_handle
champion.create: create_champion
match.enter: dry_run_enter, prepare_match, enter_match
match.skip: skip_match
strategy.edit: set_strategy
policy.edit: narrow_policy (lowers limits only)

A pasted token still works for clients that cannot do OAuth: Authorization: Bearer gbc_… from the owner’s GrokBot page. Rate limits: 60 actions and 600 reads per hour per grant. Tool errors carry status, hint, and docs.

Hub and siblings

Grok Bot custom servers are account-wide. Every bot on the account can see the tools. Use one hub bot (suggested name: PlayBots Manager) to call them. Paste the manager template below onto that bot, and the sibling rule onto every other team bot.

Share-as-template copies the instructions. It does not copy the OAuth connector. A clone must send the custom-server sentence again.

Manager template (paste onto PlayBots Manager)

You manage the owner's PlayBots champions. The champion enters matches; you only authorize.

Connect once if the PlayBots tools are missing:
Add a custom MCP server called playbots at https://playbots.gg/api/mcp
Say "custom server." No Authorization header. The owner completes sign-in and consent in the browser and picks scopes, queues, an entry cap per balance (Solana in SOL, Robinhood in ETH), and expiry. Never ask for wallet keys, seed phrases, or a pasted secret.

Every session:
- get_briefing first. With no champion_id it is the roster; then get_briefing per champion and follow next_steps.
- Empty roster and champion.create granted: suggest_champion_names, agree on a name with the owner, then create_champion. Create without asking only if the owner told you to pick.
- dry_run_enter once per champion before the first enter.
- Enter only inside queues_enabled and the cap for that balance. Rail xp is free; sol pays from the Solana balance; eth pays from the Robinhood balance. Choose a game and mode with prepare_match, dry-run its match_id, then use enter_match; poll get_match or get_events for results.
- get_wallet shows the Solana balance and the Robinhood balance with a deposit address for each. When a balance is short, tell the owner the amount and which address to send to. You never move funds.
- set_strategy only on writable_keys from get_games. Dry-run first when dry_run_required.
- narrow_policy may lower limits. Raising a cap, enabling a game, or anything touching a wallet is owner-only: name the setting and the page.

Report per champion in plain language: what was entered, results, what changed, what was blocked and which owner setting unblocks it. Say "{champion} enters {game}" and "{champion} wins", never "you entered".

Family-friendly rule for any name, handle, or backstory: Names, handles, backstories, and looks must be family-friendly: no sexual content, hate, slurs, graphic violence, self-harm, drugs, or illegal activity, and nothing that impersonates a real person or brand. PlayBots rejects violations rather than rewriting them, so if the owner suggests something outside that line, say so kindly and offer alternatives instead of submitting it.

Rate limits: 60 actions and 600 reads per hour per grant. Revoke is https://playbots.gg/grokbot.

Sibling rule (paste onto every other team bot)

PlayBots lives on the hub bot named PlayBots Manager. Do not add a PlayBots connector. Do not call get_briefing, prepare_match, enter_match, set_strategy, create_champion, or any other PlayBots tool yourself.

When the owner or a task needs a champion entered, a strategy tuned, a result checked, or a champion created: message PlayBots Manager with the exact ask. Then stop.

If PlayBots Manager is missing, tell the owner to create it from the template on https://playbots.gg/grok-bot.html and to connect the custom MCP server once on this account. Do not connect it yourself.