{"_id":"godotlens-mcp","_rev":"9-540ccf7f4da91d67062f0b720def6607","name":"godotlens-mcp","dist-tags":{"latest":"1.2.0"},"versions":{"1.0.0":{"name":"godotlens-mcp","version":"1.0.0","keywords":["mcp","godot","gdscript","lsp","code-analysis","ai","semantic-analysis"],"author":{"name":"Peter Zalutski"},"license":"MIT","_id":"godotlens-mcp@1.0.0","maintainers":[{"name":"pzalutski","email":"pzalutski@gmail.com"}],"homepage":"https://github.com/pzalutski-pixel/godotlens-mcp","bugs":{"url":"https://github.com/pzalutski-pixel/godotlens-mcp/issues"},"bin":{"godotlens-mcp":"bin/godotlens-mcp.js"},"dist":{"shasum":"e4644bbfb1aed0b155602fe9baf196c5d3859a1c","tarball":"https://registry.npmjs.org/godotlens-mcp/-/godotlens-mcp-1.0.0.tgz","fileCount":7,"integrity":"sha512-YNXdqzatxWs/06MAWWyHDQ0skYqc42lY9NiiPYyh12HxDwRj0Rqc+qlQgPI1j/oqMFIzxdnIrJ+Atc8lBZiYwg==","signatures":[{"sig":"MEUCICTqOiZ3h6mJwvrTwBIOlBP9cVhh8YXOmYurgQeqP3DAAiEA3uG9xLp5mnqTPWufYrw4Cb9PBQlU1Cn72z613Fk61vo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35018},"engines":{"node":">=16"},"gitHead":"00eadd5732418b9fe07424bf3ff1429bca4b0960","_npmUser":{"name":"pzalutski","email":"pzalutski@gmail.com"},"repository":{"url":"git+https://github.com/pzalutski-pixel/godotlens-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server providing 15 AI-optimized tools for GDScript code analysis via Godot's built-in LSP","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/godotlens-mcp_1.0.0_1775516415014_0.005847422615105513","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"godotlens-mcp","version":"1.0.1","keywords":["mcp","mcp-server","godot","gdscript","lsp","code-analysis","code-intelligence","semantic-analysis","ai-agents","claude","developer-tools"],"author":{"name":"Peter Zalutski"},"license":"MIT","_id":"godotlens-mcp@1.0.1","maintainers":[{"name":"pzalutski","email":"pzalutski@gmail.com"}],"homepage":"https://github.com/pzalutski-pixel/godotlens-mcp","bugs":{"url":"https://github.com/pzalutski-pixel/godotlens-mcp/issues"},"bin":{"godotlens-mcp":"bin/godotlens-mcp.js"},"dist":{"shasum":"3d485852aaafdcf6d49302e09432bbf590727db4","tarball":"https://registry.npmjs.org/godotlens-mcp/-/godotlens-mcp-1.0.1.tgz","fileCount":7,"integrity":"sha512-2vfakSB1W0U9A35yaeI3XD1xQqh/a3IIG8YgWd3XCg4Yt+BcEgXyjwNw7rhZff/Tj/rIqA2whZFcKPfA1pP2LQ==","signatures":[{"sig":"MEUCIAZXfg0gmBTlktTorl6kJhmBteTplkbBsDMsrJPFzGxvAiEA9oNRG/oncMsWr3MRwZTorQElMtgufcGcJM6O9AeeWFw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35105},"engines":{"node":">=16"},"gitHead":"f9b68fbf6c12567c2af564fc031ba97d44fa1d89","_npmUser":{"name":"pzalutski","email":"pzalutski@gmail.com"},"repository":{"url":"git+https://github.com/pzalutski-pixel/godotlens-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server providing 15 AI-optimized tools for GDScript code analysis via Godot's built-in LSP","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/godotlens-mcp_1.0.1_1775516801098_0.12144569696361263","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"godotlens-mcp","version":"1.0.2","keywords":["mcp","mcp-server","godot","gdscript","lsp","code-analysis","code-intelligence","semantic-analysis","ai-agents","claude","developer-tools"],"author":{"name":"Peter Zalutski"},"license":"MIT","_id":"godotlens-mcp@1.0.2","maintainers":[{"name":"pzalutski","email":"pzalutski@gmail.com"}],"homepage":"https://github.com/pzalutski-pixel/godotlens-mcp","bugs":{"url":"https://github.com/pzalutski-pixel/godotlens-mcp/issues"},"bin":{"godotlens-mcp":"bin/godotlens-mcp.js"},"dist":{"shasum":"d7c888410c1073d33026e971fb65ad6ea3fef757","tarball":"https://registry.npmjs.org/godotlens-mcp/-/godotlens-mcp-1.0.2.tgz","fileCount":7,"integrity":"sha512-2QoPAvOA7QbCsa2BL10A47Rszku4YslO4HJ+EP+CuO3ixoZ9x+pSS9UIC190A8JkxPvc6+VhiKmleleK6AmBLQ==","signatures":[{"sig":"MEUCIEs7PPe44X3uxBGppuNDEPNQyjeTVx/VEHmGDDctSGxNAiEAzpKxvJZaNk7ai1VeWSdNJGRgomfoFibwUX9f0DpIFpE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35157},"engines":{"node":">=16"},"gitHead":"93295a6cef7bdcbb2456b4407ced93bb656d2178","mcpName":"io.github.pzalutski-pixel/godotlens","_npmUser":{"name":"pzalutski","email":"pzalutski@gmail.com"},"repository":{"url":"git+https://github.com/pzalutski-pixel/godotlens-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server providing 15 AI-optimized tools for GDScript code analysis via Godot's built-in LSP","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/godotlens-mcp_1.0.2_1775651591507_0.7430423047656387","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"godotlens-mcp","version":"1.0.3","keywords":["mcp","mcp-server","godot","gdscript","lsp","code-analysis","code-intelligence","semantic-analysis","ai-agents","claude","developer-tools"],"author":{"name":"Peter Zalutski"},"license":"MIT","_id":"godotlens-mcp@1.0.3","maintainers":[{"name":"pzalutski","email":"pzalutski@gmail.com"}],"homepage":"https://github.com/pzalutski-pixel/godotlens-mcp","bugs":{"url":"https://github.com/pzalutski-pixel/godotlens-mcp/issues"},"bin":{"godotlens-mcp":"bin/godotlens-mcp.js"},"dist":{"shasum":"bc54a12ff52e12086c74b8190578b613f038bfda","tarball":"https://registry.npmjs.org/godotlens-mcp/-/godotlens-mcp-1.0.3.tgz","fileCount":7,"integrity":"sha512-9OqHIFLKb8L1M3kxZbL83c8eqP6YvA8bHqgTXBR3vqNbhelm0O+qYhzSPBcUV5zWes1czYqTFatM8b6Bzx4/mw==","signatures":[{"sig":"MEUCIQDcJV+kDGTEwfmbxQMdNTXEuld6/gtLoT8L8HRrKqubaQIgP/VfdikPFggxI3KB9ZXCupZtQQRahV/+Qxukc5s7LWA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35157},"engines":{"node":">=16"},"gitHead":"91b7032a92a7df6584c3b2c639329fb386cb9bb4","mcpName":"io.github.pzalutski-pixel/godotlens","_npmUser":{"name":"pzalutski","email":"pzalutski@gmail.com"},"repository":{"url":"git+https://github.com/pzalutski-pixel/godotlens-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server providing 15 AI-optimized tools for GDScript code analysis via Godot's built-in LSP","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/godotlens-mcp_1.0.3_1775651691759_0.21498109300419554","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"godotlens-mcp","version":"1.0.4","keywords":["mcp","mcp-server","godot","gdscript","lsp","code-analysis","code-intelligence","semantic-analysis","ai-agents","claude","developer-tools"],"author":{"name":"Peter Zalutski"},"license":"MIT","_id":"godotlens-mcp@1.0.4","maintainers":[{"name":"pzalutski","email":"pzalutski@gmail.com"}],"homepage":"https://github.com/pzalutski-pixel/godotlens-mcp","bugs":{"url":"https://github.com/pzalutski-pixel/godotlens-mcp/issues"},"bin":{"godotlens-mcp":"bin/godotlens-mcp.js"},"dist":{"shasum":"e32669417b4af5c3ee1a188f2ce147d20081852d","tarball":"https://registry.npmjs.org/godotlens-mcp/-/godotlens-mcp-1.0.4.tgz","fileCount":7,"integrity":"sha512-7R0dtuTkTnN1K4AD8cw4mTivAGKvU8O4qQxjj7TniMBVYmCyhJsB8gTY3SqzJaxHVs5UxSwY7+yA97cu5uggFw==","signatures":[{"sig":"MEQCIB/TYDEvyhzDpXacIiRRIreTz01iAAXF8eF3KMPcD2VdAiBuA24Lmy4uAEWnvrm+GJGnd17fMcpfYOS3+xj13BSUlw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":34592},"engines":{"node":">=16"},"gitHead":"4ff21c85461f8fdc22eb8e54a1216c9f03e4f770","mcpName":"io.github.pzalutski-pixel/godotlens","_npmUser":{"name":"pzalutski","email":"pzalutski@gmail.com"},"repository":{"url":"git+https://github.com/pzalutski-pixel/godotlens-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server providing 15 AI-optimized tools for GDScript code analysis via Godot's built-in LSP","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/godotlens-mcp_1.0.4_1776260157220_0.5978316536154102","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"godotlens-mcp","version":"1.0.5","keywords":["mcp","mcp-server","godot","gdscript","lsp","code-analysis","code-intelligence","semantic-analysis","ai-agents","claude","developer-tools"],"author":{"name":"Peter Zalutski"},"license":"MIT","_id":"godotlens-mcp@1.0.5","maintainers":[{"name":"pzalutski","email":"pzalutski@gmail.com"}],"homepage":"https://github.com/pzalutski-pixel/godotlens-mcp","bugs":{"url":"https://github.com/pzalutski-pixel/godotlens-mcp/issues"},"bin":{"godotlens-mcp":"bin/godotlens-mcp.js"},"dist":{"shasum":"91efe9682bc016d1e55362a78e9ac1dc45b42f9e","tarball":"https://registry.npmjs.org/godotlens-mcp/-/godotlens-mcp-1.0.5.tgz","fileCount":7,"integrity":"sha512-YygiyFD9DDDhidrgORtXxUEkyZXLK5i4u+yKv19xuuezXINrvqFWDXLlpL6w0tSIzjMjpdM86gES46jUxzGc+w==","signatures":[{"sig":"MEUCIQCvuIqXcxl8YQPaYiIbvNjQeO3Ps+6mLNyUopJ6fDZaKgIgK5ugSJzEU/Kl99QugaCoxJVIXHUTHwixkku345YCguE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":40144},"engines":{"node":">=16"},"gitHead":"62dfb8f2b3adf1c53401c0dbcc49ffa211ed0439","mcpName":"io.github.pzalutski-pixel/godotlens","_npmUser":{"name":"pzalutski","email":"pzalutski@gmail.com"},"repository":{"url":"git+https://github.com/pzalutski-pixel/godotlens-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server providing 15 AI-optimized tools for GDScript code analysis via Godot's built-in LSP","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/godotlens-mcp_1.0.5_1776263967122_0.98702247438053","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"godotlens-mcp","version":"1.1.0","keywords":["mcp","mcp-server","godot","gdscript","lsp","code-analysis","code-intelligence","semantic-analysis","ai-agents","claude","developer-tools"],"author":{"name":"Peter Zalutski"},"license":"Apache-2.0","_id":"godotlens-mcp@1.1.0","maintainers":[{"name":"pzalutski","email":"pzalutski@gmail.com"}],"homepage":"https://github.com/pzalutski-pixel/godotlens-mcp","bugs":{"url":"https://github.com/pzalutski-pixel/godotlens-mcp/issues"},"bin":{"godotlens-mcp":"bin/godotlens-mcp.js"},"dist":{"shasum":"a7f1377ecacadeda6d2eae1d979379eb6130d525","tarball":"https://registry.npmjs.org/godotlens-mcp/-/godotlens-mcp-1.1.0.tgz","fileCount":12,"integrity":"sha512-e4skw+6ltBYkQ5APQ6WzYsVtzTG1BJcxlVXpJLBVs7F32aU+oHpWdZeggYPDVm6NIv5CBGqSaWR5n9Iw0sA94A==","signatures":[{"sig":"MEUCIQDbr4a4ydBJcaBnqOUOJgOCsSBaWi/8NA5esl6LiRNCBAIgWQFJUF3vp3IAbcx1LuugV+inBWxzcyx9v9E0lOgoIdM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":142506},"engines":{"node":">=16"},"gitHead":"5b99014da2cb70dfef2ef76c32636ea7d725cc3c","mcpName":"io.github.pzalutski-pixel/godotlens","_npmUser":{"name":"pzalutski","email":"pzalutski@gmail.com"},"repository":{"url":"git+https://github.com/pzalutski-pixel/godotlens-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server giving AI agents Godot's own view of a GDScript project: navigation, diagnostics, engine API, and scene verification","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/godotlens-mcp_1.1.0_1785159296077_0.15829110352150377","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"godotlens-mcp","version":"1.1.1","keywords":["mcp","mcp-server","godot","gdscript","lsp","code-analysis","code-intelligence","semantic-analysis","ai-agents","claude","developer-tools"],"author":{"name":"Peter Zalutski"},"license":"Apache-2.0","_id":"godotlens-mcp@1.1.1","maintainers":[{"name":"pzalutski","email":"pzalutski@gmail.com"}],"homepage":"https://github.com/pzalutski-pixel/godotlens-mcp","bugs":{"url":"https://github.com/pzalutski-pixel/godotlens-mcp/issues"},"bin":{"godotlens-mcp":"bin/godotlens-mcp.js"},"dist":{"shasum":"d76f1227310a0cd32fbb3f5f9665a1f478f697f8","tarball":"https://registry.npmjs.org/godotlens-mcp/-/godotlens-mcp-1.1.1.tgz","fileCount":14,"integrity":"sha512-jQfB9zoTx1wcQZYH1XpoNZJTaKeBxFLB/DgvD0Hc+9awtUTZkUYBbge6VghXBtokcz+AsFcyu9D5JLfNES5Ahw==","signatures":[{"sig":"MEUCIQCNclhj3j7xsSd54hAh9pSvx2y3hMtefAY1BqnDvdkoZQIgWIc+Hhn4qfBa3M96/IYRVqA2vpaSOSu+H1Omfn2Lalk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":154170},"engines":{"node":">=16"},"gitHead":"5265e8020d761459457343f16ab631806a335f86","mcpName":"io.github.pzalutski-pixel/godotlens","_npmUser":{"name":"pzalutski","email":"pzalutski@gmail.com"},"repository":{"url":"git+https://github.com/pzalutski-pixel/godotlens-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server giving AI agents Godot's own view of a GDScript project: navigation, diagnostics, engine API, and scene verification","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/godotlens-mcp_1.1.1_1785161884904_0.9556757179945279","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"_id":"godotlens-mcp@1.2.0","bin":{"godotlens-mcp":"bin/godotlens-mcp.js"},"bugs":{"url":"https://github.com/pzalutski-pixel/godotlens-mcp/issues"},"dist":{"shasum":"5ef408be75f83881c0c80158b73c5c1e89cca321","tarball":"https://registry.npmjs.org/godotlens-mcp/-/godotlens-mcp-1.2.0.tgz","fileCount":22,"integrity":"sha512-PAm/rjt+FlwCb9d59DeylXKssnJyG5cDSOijXSsH5eqKB0cdk+GR58xjHmwXlAuAoIl+VkIDKj/s4lKvdp3LqQ==","signatures":[{"sig":"MEUCIQDJFeu0J92gqzsrY5MD0KYkOhnVXesvvPx0Tj+yoQF5YQIgDI61W6mhUPCSvABFnMsWzWmc65AnD1Cr8ks3ZK46CXU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIC+CY4+k2ELvw98meiJKd1BUgo/GJlyCDkfQz7ZwTwXJAiEAxVsCf0fgTs0GitW4xenZD0qm5fI2RG8wdS61BZXTYTQ="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/godotlens-mcp@1.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":289703},"name":"godotlens-mcp","author":{"name":"Peter Zalutski"},"engines":{"node":">=16"},"gitHead":"c26c7e89009f3b45982bc4b50cc01d68a03f7a1f","license":"Apache-2.0","mcpName":"io.github.pzalutski-pixel/godotlens","version":"1.2.0","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"e3c8919b-4361-4629-8933-8c31b93e96ad"}},"homepage":"https://github.com/pzalutski-pixel/godotlens-mcp","keywords":["mcp","mcp-server","godot","gdscript","lsp","code-analysis","code-intelligence","semantic-analysis","ai-agents","claude","developer-tools"],"repository":{"url":"git+https://github.com/pzalutski-pixel/godotlens-mcp.git","type":"git"},"_npmVersion":"11.17.0","description":"MCP server giving AI agents Godot's own view of a GDScript project, and a running game to observe and drive: navigation, diagnostics, engine API, scene checks, runtime","directories":{},"maintainers":[{"name":"pzalutski","email":"pzalutski@gmail.com"}],"_nodeVersion":"24.21.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/godotlens-mcp_1.2.0_1792270526174_0.6231699388009777"}}},"time":{"created":"2026-04-06T23:00:14.930Z","modified":"2026-10-17T20:55:26.599Z","1.0.0":"2026-04-06T23:00:15.159Z","1.0.1":"2026-04-06T23:06:41.240Z","1.0.2":"2026-04-08T12:33:11.696Z","1.0.3":"2026-04-08T12:34:51.906Z","1.0.4":"2026-04-15T13:35:57.407Z","1.0.5":"2026-04-15T14:39:27.255Z","1.1.0":"2026-07-27T13:34:56.223Z","1.1.1":"2026-07-27T14:18:05.080Z","1.2.0":"2026-10-17T20:55:26.269Z"},"bugs":{"url":"https://github.com/pzalutski-pixel/godotlens-mcp/issues"},"author":{"name":"Peter Zalutski"},"license":"Apache-2.0","homepage":"https://github.com/pzalutski-pixel/godotlens-mcp","keywords":["mcp","mcp-server","godot","gdscript","lsp","code-analysis","code-intelligence","semantic-analysis","ai-agents","claude","developer-tools"],"repository":{"url":"git+https://github.com/pzalutski-pixel/godotlens-mcp.git","type":"git"},"description":"MCP server giving AI agents Godot's own view of a GDScript project, and a running game to observe and drive: navigation, diagnostics, engine API, scene checks, runtime","maintainers":[{"name":"pzalutski","email":"pzalutski@gmail.com"}],"readme":"# godotlens-mcp\n\n[![npm](https://img.shields.io/npm/v/godotlens-mcp.svg)](https://www.npmjs.com/package/godotlens-mcp)\n[![PyPI](https://img.shields.io/pypi/v/godotlens-mcp.svg)](https://pypi.org/project/godotlens-mcp/)\n[![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://github.com/pzalutski-pixel/godotlens-mcp/blob/main/LICENSE)\n\nAn MCP server that gives AI agents **Godot's own view** of a GDScript project — navigation,\ndiagnostics, engine API and scene verification from the engine itself — and lets them run the\ngame, look at it and drive it: the live scene tree, values, errors, input, hot reload and\nscreenshots.\n\n## Requirements\n\n| | Needed for |\n|---|---|\n| **Godot 4.6+**, editor open on your project | `gdscript_*` and `debug_*` (the LSP and debug adapter live in the editor) |\n| A Godot **binary** via `GODOT_BIN`, `./godot/`, or PATH | `scene_*`, `project_*` and `runtime_*`, which run the engine themselves |\n| **Python 3.10+** on PATH | this npm wrapper spawns the bundled server |\n\nGodot 4.6 is the floor because the language server's behaviour changed materially at 4.5\n(URI encoding) and 4.6 (document ownership). Older versions are refused with a clear\nmessage rather than silently misread.\n\nTurn on **Import Resources When Unfocused** in Editor Settings: an agent-driven editor never\ngains focus, so without it new `class_name` scripts and assets are not registered. Games that\n`runtime_run` launches run headless, beside your editor, one per agent. For CI, the editor\ndoes not need a visible window:\n\n```bash\ngodot --path <project> --editor --headless --lsp-port 6005 --dap-port 6006\n```\n\n## Quick Start\n\n```json\n{\n  \"mcpServers\": {\n    \"godotlens\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"godotlens-mcp\"]\n    }\n  }\n}\n```\n\n## What this package does\n\nBundles the full server (pure Python, **zero runtime dependencies**), checks for Python 3.10+,\nand launches it over stdio. No pip install, no network access after install.\n\n## Why\n\nAn agent working from text alone cannot tell a call from a comment, cannot know which methods\nexist on a `CharacterBody2D` in *your* Godot version, and cannot see that a signal handler is\nwired by name inside a `.tscn`. Every answer here comes from the engine.\n\n| Without | With |\n|---|---|\n| `grep take_damage` — matches comments and strings | `gdscript_references` — the actual call sites |\n| Guess a coordinate, land one column off, get nothing | `gdscript_find` — look a symbol up by name |\n| Recall Godot's API from memory | `gdscript_engine_api` — signatures from *your* build |\n| Rename a signal handler, break the scene silently | `gdscript_rename` warns; `scene_validate` catches it |\n| Paste console output back by hand | `debug_run` — run it and read what it printed |\n\n## Tools\n\n49 tools. Line and character parameters are **0-indexed** throughout.\n\n- **Navigation** — `gdscript_find` (by name), `gdscript_definition`, `gdscript_references`,\n  `gdscript_references_in_file`, `gdscript_hover`, `gdscript_symbols`, `gdscript_signature_help`\n- **Authoring** — `gdscript_engine_api`, `gdscript_complete` (scene-aware), `gdscript_validate`\n  (check content before writing it to disk)\n- **Refactoring** — `gdscript_rename`\n- **Project & scenes** — `project_config`, `project_validate`, `scene_state`, `scene_validate`\n- **Debugger (your editor)** — `debug_run`, `debug_output`, `debug_set_breakpoints`,\n  `debug_stack_trace`, `debug_inspect`, `debug_evaluate`, plus execution control\n- **Runtime (games GodotLens launches)** — `runtime_run`, `runtime_tree`, `runtime_inspect`,\n  `runtime_set`, `runtime_eval`, `runtime_input`, `runtime_output`, `runtime_reload`, `runtime_screenshot`, `runtime_monitors`,\n  `runtime_pause`, `runtime_time_scale`, `runtime_step`, `runtime_status`, `runtime_stop`\n- **Sync & diagnostics** — `gdscript_sync_file`, `gdscript_sync_files`, `gdscript_diagnostics`,\n  `gdscript_release_file`, batch variants\n\nGodot's LSP does not watch the filesystem, so call `gdscript_sync_file` after editing a `.gd`\nfile. Results carry a `verified` flag: an empty diagnostics list with `verified: false` means\nGodot never reported back — **not** that the file is clean.\n\n## Configuration\n\n| Variable | Default | Description |\n|---|---|---|\n| `GODOT_LSP_HOST` | `127.0.0.1` | Language server host |\n| `GODOT_LSP_PORT` | `6005` | Language server port (the official VS Code extension uses `6008`) |\n| `GODOT_DAP_HOST` | `127.0.0.1` | Debug adapter host |\n| `GODOT_DAP_PORT` | `6006` | Debug adapter port, used by `debug_*` |\n| `GODOT_BIN` | auto | Godot executable, required by `scene_*` and `project_config` |\n| `GODOT_PROJECT_ROOT` | auto | Project root; auto-detected by walking up for `project.godot` |\n| `GODOT_LSP_TIMEOUT` | `15` | Seconds to wait for any single LSP response |\n| `GODOT_DIAGNOSTICS_TIMEOUT` | `8` | Seconds to wait for diagnostics after a sync |\n| `GODOT_VERSION` | auto | Override capability detection |\n| `GODOT_FIND_FILE_LIMIT` | `60` | Max files `gdscript_find` inspects when searching the whole project |\n| `GODOT_RUNTIME_MAX_SESSIONS` | `4` | Max games `runtime_run` keeps running at once |\n\n## Documentation\n\nFull tool reference and rationale: [GitHub](https://github.com/pzalutski-pixel/godotlens-mcp)\n","readmeFilename":"README.md"}