init: vaultmesh mcp server

packages/vaultmesh_mcp/README.md

@@ -0,0 +1,87 @@
+# VaultMesh MCP Server
+
+Model Context Protocol server exposing VaultMesh Guardian and Treasury tools to Claude.
+
+## Installation
+
+```bash
+pip install -r packages/vaultmesh_mcp/requirements.txt
+```
+
+## Tools Exposed
+
+### Guardian Tools
+
+| Tool | Description | Capability |
+|------|-------------|------------|
+| `guardian_anchor_now` | Anchor scrolls and compute Merkle root snapshot | `anchor` |
+| `guardian_verify_receipt` | Verify a receipt exists by hash | `guardian_view` |
+| `guardian_status` | Get status of all scrolls | `guardian_view` |
+
+### Treasury Tools
+
+| Tool | Description | Capability |
+|------|-------------|------------|
+| `treasury_create_budget` | Create a new budget | `treasury_write` |
+| `treasury_balance` | Get budget balance(s) | `treasury_view` |
+| `treasury_debit` | Spend from a budget | `treasury_write` |
+| `treasury_credit` | Add funds to a budget | `treasury_write` |
+
+## Usage
+
+### With Claude Desktop
+
+Add to your Claude Desktop config (`~/.config/claude-desktop/config.json`):
+
+```json
+{
+  "mcpServers": {
+    "vaultmesh": {
+      "command": "python",
+      "args": ["-m", "packages.vaultmesh_mcp.server"],
+      "cwd": "/path/to/vaultmesh",
+      "env": {
+        "VAULTMESH_ROOT": "/path/to/vaultmesh"
+      }
+    }
+  }
+}
+```
+
+### Standalone Testing
+
+```bash
+# List available tools
+python -m packages.vaultmesh_mcp.server
+
+# Call a tool directly
+python -m packages.vaultmesh_mcp.server guardian_status '{}'
+
+# Create a budget
+python -m packages.vaultmesh_mcp.server treasury_create_budget '{"budget_id": "ops-2025", "name": "Operations", "allocated": 100000}'
+
+# Anchor all scrolls
+python -m packages.vaultmesh_mcp.server guardian_anchor_now '{}'
+```
+
+## Receipt Emission
+
+Every tool call emits a receipt to `receipts/mcp/mcp_calls.jsonl` containing:
+
+```json
+{
+  "schema_version": "2.0.0",
+  "type": "mcp_tool_call",
+  "timestamp": "2025-12-07T12:00:00Z",
+  "scroll": "mcp",
+  "tags": ["mcp", "tool-call", "<tool_name>"],
+  "root_hash": "blake3:...",
+  "body": {
+    "tool": "<tool_name>",
+    "arguments": {...},
+    "result_hash": "blake3:...",
+    "caller": "did:vm:mcp:client",
+    "success": true
+  }
+}
+```