44 lines
1.4 KiB
Markdown
44 lines
1.4 KiB
Markdown
# Agent Tools
|
|
|
|
Godot editor plugin that exposes **43 tools across 12 namespaces** (scene edits, signal wiring, resource creation, reference validation, animation, headless test runs, etc.) over MCP so coding agents can operate through the editor's real APIs instead of hand-editing `.tscn` / `.tres` / `project.godot` as text.
|
|
|
|
Works with any MCP-capable client — Claude Code, Claude Desktop, Cursor, Cline, Windsurf, Continue, Zed.
|
|
|
|
## Quick start
|
|
|
|
1. Enable this plugin: *Project → Project Settings → Plugins* → tick **Agent Tools**.
|
|
2. Confirm the Output panel shows `[agent_tools] listening on 127.0.0.1:9920`.
|
|
3. Configure your MCP client to run the bridge — see the [full setup guide](https://github.com/BlakeBukowsky/GodotTools#configure-your-agent) for per-client config paths.
|
|
|
|
Simplest user-scoped config (for Claude Code, Cursor, Windsurf, etc. — different config file per client):
|
|
|
|
```json
|
|
{
|
|
"mcpServers": {
|
|
"godot-agent-tools": {
|
|
"command": "npx",
|
|
"args": ["-y", "godot-agent-tools-mcp"]
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
Full documentation, troubleshooting, and tool catalog: **https://github.com/BlakeBukowsky/GodotTools**
|
|
|
|
## Raw TCP protocol (if you want to skip MCP)
|
|
|
|
Line-delimited JSON-RPC on `127.0.0.1:9920`:
|
|
|
|
```json
|
|
{"id": 1, "method": "scene.current", "params": {}}
|
|
```
|
|
|
|
Response:
|
|
```json
|
|
{"id": 1, "result": {"open": false}}
|
|
```
|
|
|
|
## License
|
|
|
|
MIT — see [LICENSE](LICENSE).
|