estatehelm 1.0.7 → 1.0.9

package/README.md

@@ -24,19 +24,27 @@ This will:
 
 ### 2. Configure Claude Code
 
-Add to your `~/.claude.json` (or Claude Code settings):
-
-```json
-{
-  "mcpServers": {
-    "estatehelm": {
-      "command": "estatehelm",
-      "args": ["mcp"]
-    }
-  }
-}
+**Windows:**
+```bash
+claude mcp add --transport stdio estatehelm -- cmd /c npx estatehelm mcp
+```
+
+**Mac/Linux:**
+```bash
+claude mcp add --transport stdio estatehelm -- npx estatehelm mcp
+```
+
+**For staging environment:**
+```bash
+# Windows
+claude mcp add --transport stdio estatehelm-staging -- cmd /c npx estatehelm mcp --staging
+
+# Mac/Linux
+claude mcp add --transport stdio estatehelm-staging -- npx estatehelm mcp --staging
 ```
 
+Verify with `claude mcp list`.
+
 ### 3. Use with Claude Code
 
 Start Claude Code and you can now ask questions like:
@@ -122,20 +130,40 @@ The server exposes your EstateHelm data as MCP resources:
 
 - `estatehelm://households` - List all households
 - `estatehelm://households/{id}` - Specific household
-- `estatehelm://households/{id}/pets` - Pets in household
-- `estatehelm://households/{id}/properties` - Properties
-- `estatehelm://households/{id}/vehicles` - Vehicles
-- `estatehelm://households/{id}/contacts` - Contacts
-- `estatehelm://households/{id}/insurance` - Insurance policies
-- `estatehelm://households/{id}/bank_account` - Bank accounts
-- And more...
+- `estatehelm://households/{id}/{entityType}` - Entities by type
+
+**Supported entity types:**
+`pet`, `property`, `vehicle`, `contact`, `insurance`, `bank_account`, `investment`, `subscription`, `maintenance_task`, `password`, `access_code`, `document`, `medical`, `prescription`, `credential`, `utility`
 
 ## MCP Tools
 
-- `search_entities` - Full-text search across entities
-- `get_household_summary` - Overview with counts
-- `get_expiring_items` - Items expiring soon
-- `refresh` - Force re-sync from server
+| Tool | Description | Parameters |
+|------|-------------|------------|
+| `search_entities` | Full-text search across entities | `query` (required), `householdId`, `entityType` |
+| `get_household_summary` | Overview with entity counts | `householdId` (required) |
+| `get_expiring_items` | Items expiring within N days | `days` (default: 30), `householdId` |
+| `get_file` | Download and decrypt a file attachment | `fileId`, `householdId`, `entityId`, `entityType` (all required) |
+| `refresh` | Force re-sync from server | none |
+
+**`get_expiring_items` checks:**
+- Insurance policies (`expiration_date`)
+- Vehicle registrations (`registration_expiration`)
+- Vehicle tabs (`tabs_expiration`)
+- Subscriptions (`expiration_date`)
+
+**`get_file` returns:**
+- `fileName`: Original filename
+- `mimeType`: File MIME type
+- `size`: File size in bytes
+- `data`: Base64-encoded decrypted file content
+
+## MCP Prompts
+
+| Prompt | Description |
+|--------|-------------|
+| `household_summary` | "Give me an overview of my household" |
+| `expiring_soon` | "What's expiring in the next 30 days?" |
+| `emergency_contacts` | "Show me emergency contacts" |
 
 ## Security