Add adoption-focused examples, contract docs, and CLI polish

examples/mcp_client_config.md

@@ -0,0 +1,35 @@
+# MCP Client Config Example
+
+`pyro-mcp` is intended to be exposed to LLM clients through the public `pyro` CLI.
+
+Generic stdio MCP configuration using `uvx`:
+
+```json
+{
+  "mcpServers": {
+    "pyro": {
+      "command": "uvx",
+      "args": ["--from", "pyro-mcp", "pyro", "mcp", "serve"]
+    }
+  }
+}
+```
+
+If `pyro-mcp` is already installed locally, the same server can be configured with:
+
+```json
+{
+  "mcpServers": {
+    "pyro": {
+      "command": "pyro",
+      "args": ["mcp", "serve"]
+    }
+  }
+}
+```
+
+Primary tool for most agents:
+
+- `vm_run`
+
+Use lifecycle tools only when the agent needs persistent VM state across multiple tool calls.