Flockbay MCP server
Commit Nov 3, 2026Enables AI coding agents to build, run, and playtest Godot 4 games by editing scenes, running headless instances, and capturing viewports.
Also known as flockbay/flockbay-plugin, flockbay-plugin
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Nov 3, 2026
- License
- MIT
What is Flockbay MCP?
Flockbay enables AI coding agents to build, run, and playtest Godot 4 games by editing scenes, running headless instances, and capturing viewports.
Summary generated from the project's README
About Flockbay MCP server
Flockbay provides a bridge between AI coding agents and the Godot 4 game engine. It allows developers using Claude Code, Codex, Cursor, or Gemini CLI to interact with a live Godot editor. The server enables agents to perform complex game development tasks such as editing GDScript files, modifying scenes, and running headless game instances to parse errors from the output.
To use this server, you must first install the Flockbay Windows application and open your project within it. On Windows, the plugin starts the server via the flockbay mcp command. Mac and Linux users must manually enable the connector within the Flockbay app settings and copy the specific connection string to their client. This setup transforms a standard coding agent into a functional game development assistant that can see the game viewport and send input events during playtesting.
What you can do with it
- 1Automated game debuggingAn AI agent can run a game in a headless mode to identify and fix coding errors.
- 2Visual playtestingDevelopers can have an agent capture the game viewport to see what is happening on screen.
- 3Interactive gameplay testingThe agent can simulate player actions by sending input events to the running game.
- 4Direct scene manipulationAn AI client can modify the structure of game scenes and the underlying GDScript code.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableflockbay/flockbay-plugin is public and reachablegithub.com/flockbay/flockbay-plugin ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-03github.com/flockbay/flockbay-plugin ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubFlockbay for Claude Code, Codex, Cursor and Gemini CLI
Connects your coding agent to Flockbay, the Godot editor with an AI agent built in. With it, Claude Code, Codex, Cursor or Gemini CLI can build, run and playtest a Godot 4 game in a live Godot editor:
- edit scenes and GDScript;
- run the game headless and read Godot's output and parse errors;
- send input events;
- capture the viewport.
This plugin only registers Flockbay's MCP server, flockbay. The tools come
from the Flockbay app.
Before you install
Install Flockbay for Windows from flockbay.com, and
open your game in it. The plugin starts flockbay mcp, which the Windows app
puts on your PATH; open a new terminal after installing so it is found.
On a Mac or Linux the app does not put that command on your PATH yet, so the plugin cannot start the server there. In the app, open Connectors, then Connect your agent (MCP), press Turn on, and copy the line it writes for your machine instead.
Claude Code
claude plugin marketplace add flockbay/flockbay-plugin && claude plugin install flockbay@flockbay
Or, inside a session:
/plugin marketplace add flockbay/flockbay-plugin
/plugin install flockbay@flockbay
Start a new session in your game's folder; /mcp lists flockbay.
Codex
codex plugin marketplace add flockbay/flockbay-plugin
Then install Flockbay from the Plugins Directory. Or add the server without the plugin:
codex mcp add flockbay -- flockbay mcp
Cursor
Add the server to ~/.cursor/mcp.json:
{
"mcpServers": {
"flockbay": { "command": "flockbay", "args": ["mcp"] }
}
}
Gemini CLI
gemini extensions install https://github.com/flockbay/flockbay-plugin
Without the plugin
Any MCP client can run the same server:
claude mcp add --scope user flockbay -- flockbay mcp
Setup for each agent, and what the tools do: flockbay.com/godot-ai-mcp.
Privacy
The plugin itself collects nothing: it only starts the Flockbay app's MCP server on your machine. The app's privacy policy is at flockbay.com/privacy.
License
MIT. See LICENSE.
Flockbay MCP questions
What can the AI agent do with Flockbay?
The agent can edit scenes and GDScript, run the game headless to parse errors, send input events, and capture the viewport.
Does this work on Mac or Linux?
The command is not automatically added to the PATH on Mac or Linux; you must manually enable the connector in the app's Connectors menu and copy the provided command.