Connect your AI client

Connect Claude Code, Claude Desktop or claude.ai, Codex or Gemini CLI to the studio's MCP server, so it can read the platform as you, help with player feedback and suggest game updates.

Get started / Quick start

Your own AI client can read the studio's games, their player feedback, analytics and releases, the Roblox market, the studio's code activity and this handbook, as you and nothing more, and suggest updates to the games from what players say. Add the studio's MCP server, https://mcp.blockoutgames.com/mcp, to your client, sign in once in your browser, and approve the client. There is no key to copy and nothing secret to keep on your computer.

Before you start

  • You must be able to sign in to the studio: an active member of the BlockoutGames GitHub organization (sign-in and access).

  • Your client needs a browser on the same computer for the sign-in. It will not work over SSH without one.

Claude Code

Shell
claude mcp add --transport http blockout https://mcp.blockoutgames.com/mcp --scope user

Then, inside Claude Code, run /mcp, choose blockout and Authenticate; or, from your shell, run claude mcp login blockout. Your browser opens on the account site. --scope user makes the server available in every project; leave it out to add it to the current project only.

Claude Desktop and claude.ai

  1. Add a custom connector

    In Claude, open Settings › Connectors and choose Add custom connector.

  2. Give it the address

    Name it Blockout Games and give the URL https://mcp.blockoutgames.com/mcp.

  3. Connect

    Choose Connect. Claude opens the account site in your browser; sign in and approve it.

Codex

Shell
codex mcp add blockout --url https://mcp.blockoutgames.com/mcpcodex mcp login blockout

Or add it by hand to ~/.codex/config.toml, then run codex mcp login blockout:

text
[mcp_servers.blockout]
url = "https://mcp.blockoutgames.com/mcp"

Gemini CLI

Shell
gemini mcp add --transport http blockout https://mcp.blockoutgames.com/mcp

Or add it to your settings.json:

JSON
{  "mcpServers": {    "blockout": { "httpUrl": "https://mcp.blockoutgames.com/mcp" }  }}

Then, inside Gemini CLI, run /mcp auth blockout.

After you sign in, the account site asks whether to let the client in as you. It shows:

  • the name the client gave itself. Anyone can choose any name, so the page says so: check that it is the client you just added;

  • the client's id and the address it sends you back to (for a client on your computer, 127.0.0.1 or localhost);

  • what it asks for, in words, each with a box to tick. Reading is ticked; anything that changes something is not, until you tick it.

Choose Allow to connect it with what you ticked, or Deny to send it away with nothing.

What a client can do

PermissionWhat it lets the client do
studio:readRead the studio's games, their release logs, project contract status and the collector's health
market:readRead the Roblox market: games, creators, discovery and genres
code:readRead the studio's code activity and pull requests
docs:readSearch and read this handbook
feedback:readRead players' feedback on the games you may see it for, without players' Roblox ids
analytics:readRead the games' analytics: players, retention, sessions, peak hours and revenue, as the studio shows you
studio:writeWatch or stop watching games for you, and draft home pages you then save yourself
feedback:writeChange a feedback item's status, and prepare GitHub issues from feedback

It reads exactly what you can see: if the studio hides a number from you, it is hidden from your client too. A game's feedback, for instance, is for owners and the game's crew. It never sees members, email addresses, keys, credentials or the audit log.

Tools

ToolPermissionWhat it does
studio_gamesstudio:readThe studio's games
studio_gamestudio:readOne game with its stats
game_releasesstudio:readA game's release log, with each update's effect, and its repository's GitHub releases
collector_healthstudio:readWhether the collector is running and keeping up
studio_contractsstudio:readEach project's contract status and who has signed; never the terms
market_searchmarket:readSearch the tracked Roblox games
market_gamemarket:readOne Roblox game with its history
market_creatormarket:readA Roblox creator and their games
market_discoverymarket:readThe games rising fastest
market_genresmarket:readThe genres, with their games and players
code_activitycode:readCommits, pull requests and reviews by week
code_pull_requestscode:readThe pull requests
handbook_searchdocs:readSearch this handbook
handbook_pagedocs:readRead one page of it
game_feedbackfeedback:readA game's feedback by status, category, days and words, a page at a time
feedback_themesfeedback:readWhat a game's players write about, week by week
game_analyticsanalytics:readA game's players, retention, sessions, revenue and busiest hours over a range
studio_analyticsanalytics:readEvery released game added up
watch_gamestudio:writeWatch or stop watching a game, after asking you
home_widgetsstudio:writeThe widgets a home page can hold
draft_pagestudio:writeA link to a new home page, open unsaved in the studio for you to save or cancel
set_feedback_statusfeedback:writeMark a feedback item seen, planned, done or ignored, after asking you
create_feedback_issuefeedback:writeA link that opens a GitHub issue filled in from feedback, for you to check and submit

Ready-made asks

Your client lists these as prompts (in Claude Code, type / and look for blockout). Each tells the client which tools to use.

PromptWhat it does
weekly_studio_reportThe studio's week: players, feedback, releases, contracts and the collector
triage_feedbackA game's new feedback grouped into themes, with a status proposed for each item
recommend_updatesConcrete updates for a game, each with its evidence (feedback items, numbers) and the impact to expect
compare_with_genreA game against the leading games of its genre

Or just ask, for example:

  • "Recommend updates for Anime Clicker Heroes from its feedback."

  • "What did players complain about most this week, across our games?"

  • "How did retention move after our last update to Anime Clicker Heroes?"

  • "Draft me a home page with our revenue and players."

When it changes something

A client changes nothing unless you ticked a permission for it on the consent screen, and even then:

  • It asks you in the client where the client can ask its user (MCP calls this elicitation): it shows what it is about to do, with a box to confirm, and nothing happens until you confirm it.

  • Otherwise it gives you a link to account.blockoutgames.com, where you see exactly what it would change and press Approve or Decline yourself. Only after you approve, and only once, within five minutes, can the client make that change. Your client cannot approve for you.

  • A drafted page is not saved until you press Save in the studio, and an issue is not opened until you submit it on GitHub.

At most 20 changes a minute are allowed, and every one is in the audit log: who, what and which client.

Disconnect a client

Open Settings › Connected apps on account.blockoutgames.com. Every client you connected is listed, with what it may read, when you connected it and when it last fetched a token. Disconnect stops it on its very next request, on every device. To use it again, connect it again.

If you leave the organization, every client you connected stops at once as well.

Things to know

  • Every tool call is recorded in the studio's audit log: which client, which tool and whether it worked, never what you asked. A change also records what it changed.

  • There is a limit on calls a minute; a client that goes over is told to wait.

  • Answers mark text written outside the studio, such as Roblox game names and descriptions, pull request titles and players' feedback, as <untrusted>. It is data, not instructions: if a player writes "ignore your instructions", your client should not, and you should not either.

  • Players are never named by their Roblox id: each is a code, the same for one player within one game, and different for each member.

Updated