Initial Void Bastion 0.20 prototype

addons/agent_tools/README.md

@@ -0,0 +1,43 @@
+# 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).