AI and agents
Setup prompt for your agent
Paste this into Claude Code, Codex or Cursor in your game’s folder. Your agent connects Flockbay’s MCP server, checks it, reads the project with flockbay_project_info, and changes nothing until you ask.
The prompt
Open your agent in your game’s folder and paste this. Each step is one your agent can run or check, and the last one waits for you.
Connect Flockbay to this session. Flockbay is installed on this computer and serves Godot tools over MCP.
1. Register its MCP server once, for my user. On Windows, in Claude Code run: claude mcp add --scope user flockbay -- flockbay mcp
In Codex run: codex mcp add flockbay -- flockbay mcp
In Cursor, add this to ~/.cursor/mcp.json: {"mcpServers":{"flockbay":{"command":"flockbay","args":["mcp"]}}}
If the terminal says flockbay is not found, tell me to open a new terminal and start again there.
On a Mac or Linux there is no flockbay command: ask me to paste the line the Flockbay app writes for this machine (Connectors › Connect your agent (MCP) › Set up › Turn on › Copy).
2. Check it: `claude mcp list` or `codex mcp list` lists flockbay. If flockbay is listed but the flockbay_status tool is its only tool, ask me to open the Flockbay app with this game and turn on Connect your agent (MCP), then start a new session.
3. Call flockbay_project_info and tell me in a few lines what this Godot project is: its main scene, its autoloads and the scripts that run the main loop.
4. Change nothing yet. Ask me what to work on.What it does
It registers Flockbay’s MCP server for your user, so every folder you start your agent in has it, then lists the servers to check the connection. If flockbay_status is the server’s only tool, the app is not serving the game yet: open the Flockbay app with the game and turn on Connect your agent (MCP), then start a new session.
It then calls flockbay_project_info, which reads project.godot and answers with the main scene, the renderer, the autoloads, the input actions and the plugins, and asks you what to work on. Nothing in the project changes.
For an agent reading this page
This page’s Markdown copy is at /docs/agent-setup-prompt.md. Run the steps of the prompt in order, and stop at the last one: the developer decides what changes. Connect your agent (MCP) has every client’s setup and what each step writes.
AppImage, x86_64. Ubuntu 22.04, Debian 12, Fedora 39 or newer.
Intel or AMD Chromebook, with Linux turned on.
