Fennara Godot MCP

Fennara connects AI coding agents to real Godot feedback so they can inspect, fix, and rerun work instead of guessing from files alone.

Game development breaks in places normal coding agents cannot see: script errors, node warnings, runtime errors, diagnostics, missing resources, nested subresources, scene state, and screenshots. Fennara gives agents that Godot context through the Godot plugin and local MCP server.

Start Here

Do not install Fennara by copying files from this repository. The supported setup path is the Fennara dashboard installer:

https://www.fennara.io/docs/get-started

The installer handles:

• creating the local device identity
• installing the Godot plugin
• installing the local Fennara MCP server
• choosing the Godot project Fennara should connect to
• configuring supported MCP apps such as Codex, Cursor, Cline, VS Code, Claude Code, Claude Desktop, and Antigravity

Setup Steps

1. Create a Fennara account.
2. Open your Fennara dashboard.
3. Copy the install command for your operating system.
4. Run the command in your terminal.
5. In the installer, choose the Godot project you want Fennara to use.
6. If your project uses C#, choose C# support in Step 2. If you only use GDScript, you can skip C# support.
7. In Step 3, choose the MCP app you want to connect, then click that app's config/update button.
8. Open the Godot project and paste your API key in the Fennara plugin settings.
9. Fully restart your MCP app so it reloads the Fennara MCP server.

If your MCP app is not shown in the installer, finish the installer first, then use the manual MCP setup guide:

https://www.fennara.io/docs/mcp#manual-setup

Other MCP apps can work when they support local stdio MCP servers and are configured manually.

How to Confirm It Works

After setup, open your MCP app and ask:

Use Fennara MCP to run fennara_status and tell me which Godot project is connected.

If Fennara reports the expected Godot project, the MCP server and plugin are connected.

If it does not appear, restart the MCP app and check:

• the Fennara installer finished successfully
• the MCP app was selected in installer Step 3
• the app's config/update button was clicked
• your Godot project is open
• your API key is saved in the Fennara plugin settings

What Fennara Tools Do

Fennara exposes Godot-aware tools for agent workflows:

• file and script writes with diagnostics
• one-off scene edit scripts
• scene tree inspection
• node property inspection
• Godot class/API inspection
• runtime error capture
• scene screenshots
• scene validation
• SemanticSearch for indexed project code
• shader search

For the full tools reference, see:

https://www.fennara.io/docs/tools

Demos

Start with the real-project test: Fennara MCP with Codex on GDQuest's open-source Godot 4 Open RPG project.

In the demo, Codex works on an existing RPG codebase instead of an empty project. The first script breaks, Fennara returns Godot feedback, and Codex patches the implementation.

More demos:

• Open RPG demo breakdown
• More Fennara demos
• Fennara vs traditional Godot MCP

Useful Links

• Setup guide: https://www.fennara.io/docs/get-started
• MCP setup: https://www.fennara.io/docs/mcp
• Godot tools docs: https://www.fennara.io/docs/tools
• Godot MCP overview: https://www.fennara.io/godot-mcp
• Godot AI plugin overview: https://www.fennara.io/godot-ai-plugin
• Website: https://www.fennara.io

Repository Status

This public repository is for discoverability, documentation, setup links, demo context, and public metadata. The installable Fennara plugin and MCP server are distributed through the Fennara installer, not by copying an addons folder from this repo.

Some service-side components are not open source.

License

See LICENSE.md.