docs: align MCP tool docs with actual behavior

Remove the ECS scaffolding claim and the "200+ entries" count, and
document target_type, ranked search, URP-only HLSL, data path behavior,
and how to run the tests.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MpEiWjv38TrdFcgqU8ER5L

Author: TMHSDigital

README.md

@@ -71,7 +71,7 @@ Then ask the AI agent to scaffold a MonoBehaviour, look up an API, or generate a
 
 ## Features
 
-- **Script scaffolding** -- Generate MonoBehaviours, ScriptableObjects, Editor windows, and ECS systems following Unity 6 conventions
+- **Script scaffolding** -- Generate MonoBehaviours, ScriptableObjects, Editor windows, inspectors, state machines, and tests following Unity 6 conventions
 - **API lookup** -- Search common Unity APIs by name, namespace, or category via MCP tools
 - **Shader patterns** -- Get HLSL code and Shader Graph node setups for common effects (dissolve, outline, hologram, etc.)
 - **Performance-aware coding rules** -- Catch deprecated APIs, allocation-heavy patterns, and common mistakes
@@ -243,7 +243,7 @@ The server starts automatically when Cursor invokes an MCP tool.
 
 | Tool | Description |
 |:-----|:------------|
-| `scaffold_script` | Generate C# scripts following Unity 6 conventions. Supports MonoBehaviour, ScriptableObject, Editor, and ECS templates. |
+| `scaffold_script` | Generate C# scripts following Unity 6 conventions. Supports MonoBehaviour, ScriptableObject, Editor window, custom inspector, property drawer, interface, state machine, and test templates. |
 | `lookup_api` | Search the Unity API reference database by name, namespace, or category. Returns signatures, descriptions, and examples. |
 | `shader_helper` | Get shader code patterns for common effects (dissolve, outline, hologram, etc.) with HLSL and Shader Graph guidance. |
 | `platform_info` | Get platform-specific defines, capabilities, limitations, and build recommendations. |

docs/index.md

@@ -10,7 +10,7 @@
 
 Unity Developer Tools is a plugin for [Cursor](https://www.cursor.com/) that teaches its AI assistant how to build Unity games and tools. Once installed, you can ask the AI to:
 
-- Scaffold MonoBehaviours, ScriptableObjects, Editor windows, and ECS systems
+- Scaffold MonoBehaviours, ScriptableObjects, Editor windows, inspectors, and tests
 - Look up Unity APIs by name, namespace, or category
 - Generate shader patterns for common effects (dissolve, outline, hologram, etc.)
 - Get platform-specific defines, capabilities, and build recommendations
@@ -29,7 +29,7 @@ For a detailed walkthrough, see the [Getting Started guide](GETTING-STARTED.md).
 
 ## Features
 
-- **Script scaffolding** -- Generate MonoBehaviours, ScriptableObjects, Editor windows, and ECS systems following Unity 6 conventions
+- **Script scaffolding** -- Generate MonoBehaviours, ScriptableObjects, Editor windows, inspectors, state machines, and tests following Unity 6 conventions
 - **API lookup** -- Search common Unity APIs by name, namespace, or category via MCP tools
 - **Shader patterns** -- Get HLSL code and Shader Graph node setups for common effects
 - **Performance-aware coding rules** -- Catch deprecated APIs, allocation-heavy patterns, and common mistakes

mcp-server/README.md

@@ -7,16 +7,17 @@ A Model Context Protocol server providing Unity development tools for the Cursor
 ### scaffold_script
 Generate well-structured C# scripts following Unity conventions.
 - **type**: monobehaviour, scriptableobject, editor-window, custom-inspector, property-drawer, interface, state-machine, test
-- **name**: Class name for the generated script
+- **name**: Class name for the generated script (must be a valid C# identifier)
 - **namespace**: Optional namespace (default: MyGame)
+- **target_type**: Type inspected or drawn, for custom-inspector and property-drawer. Defaults to the name without its Editor/Inspector/Drawer suffix (`PlayerEditor` -> `Player`)
 
 ### lookup_api
-Search the Unity API reference database for classes, methods, and usage patterns.
+Search the Unity API reference database for classes, methods, and usage patterns. Multi-word queries match entries containing every word; exact name matches rank first.
 - **query**: Search term (class name, method name, or keyword)
-- **category**: Optional filter (physics, ui, animation, audio, rendering, input, networking, editor)
+- **category**: Optional filter (general, physics, ui, animation, audio, rendering, input, networking, editor)
 
 ### shader_helper
-Get shader code patterns and property setups for common effects.
+Get shader code patterns and property setups for common effects. Hand-written HLSL currently targets URP; HDRP and Built-in requests return properties and Shader Graph guidance only.
 - **effect**: Effect name (dissolve, outline, toon, water, hologram, fresnel)
 - **pipeline**: Target render pipeline (urp, hdrp, builtin)
 
@@ -34,9 +35,20 @@ pip install -r requirements.txt
 python server.py
 ```
 
+The server reads its data from `data/` next to `server.py`, so it can be started from any directory. Set `UNITY_DATA_PATH` to use a different data folder. If a data file is missing, the server exits with an error instead of returning empty results.
+
+## Testing
+
+```bash
+pip install -r requirements-dev.txt
+python -m pytest tests
+```
+
+The suite covers every tool and includes a stdio smoke test that starts the server and calls it through the MCP client.
+
 ## Data Files
 
-- `unity_api_common.json` - Common Unity API reference (200+ classes and methods)
+- `unity_api_common.json` - Curated Unity 6 API reference (75 entries across 9 categories)
 - `shader_properties.json` - Built-in shader properties and effect patterns
 - `platform_defines.json` - Platform scripting defines and capabilities
 - `lifecycle_order.json` - MonoBehaviour execution order reference