copilot-money-mcp 1.3.0 → 1.5.0

package/README.md

@@ -187,7 +187,7 @@ After installing the MCP server, Claude Desktop will request **one-time approval
 
 ## Available Tools
 
-The MCP server provides **8 read-only tools** for querying your financial data:
+The MCP server provides **12 read-only tools** for querying your financial data:
 
 | Tool | Description |
 |------|-------------|
@@ -197,6 +197,10 @@ The MCP server provides **8 read-only tools** for querying your financial data:
 | `get_recurring_transactions` | Identify subscriptions and recurring charges with frequency, monthly cost, and next expected date. Filter by name for detailed view. |
 | `get_budgets` | Get budgets from Copilot's native budget tracking with spending vs. limit comparisons. |
 | `get_goals` | Get financial goals with progress tracking, monthly history, and savings status. |
+| `get_connection_status` | Check bank sync/connection health for linked financial institutions, including last sync timestamps and error states. |
+| `get_holdings` | Get current investment holdings with ticker, quantity, price, average cost, and total return per holding. |
+| `get_investment_prices` | Get historical price data (daily + high-frequency) for stocks, ETFs, mutual funds, and crypto. |
+| `get_investment_splits` | Get stock split history with ratios, dates, and multipliers for accurate historical calculations. |
 | `get_cache_info` | Get information about the local data cache, including date range and transaction count. |
 | `refresh_database` | Refresh the in-memory cache to pick up newly synced data from Copilot Money. Cache auto-refreshes every 5 minutes. |
 
@@ -331,6 +335,39 @@ COPILOT_CACHE_TTL_MINUTES=0 copilot-money-mcp
 
 You can also manually refresh the cache using the `refresh_database` tool.
 
+### Decode Timeout
+
+For large databases (500MB+), you may need to increase the decode timeout. The default is 90 seconds (90,000ms).
+
+**Via environment variable:**
+```bash
+DECODE_TIMEOUT_MS=600000 copilot-money-mcp
+```
+
+**Via CLI flag:**
+```bash
+copilot-money-mcp --timeout 600000
+```
+
+**In Claude Desktop config** (with increased Node.js memory for 1GB+ databases):
+```json
+{
+  "mcpServers": {
+    "copilot-money": {
+      "command": "node",
+      "args": [
+        "--max-old-space-size=4096",
+        "/path/to/copilot-money-mcp/dist/cli.js",
+        "--db-path",
+        "/path/to/your/database",
+        "--timeout",
+        "600000"
+      ]
+    }
+  }
+}
+```
+
 ## Known Limitations
 
 ### Local Cache Size
@@ -359,6 +396,14 @@ If you see "Database not available":
 3. Verify `.ldb` files exist in the directory
 4. Provide custom path: `copilot-money-mcp --db-path /path/to/database`
 
+### Decode Worker Timed Out (Large Databases)
+
+If you see "Decode worker timed out after Xms":
+1. Your database may be too large for the default 90-second timeout
+2. Increase the timeout: `copilot-money-mcp --timeout 300000` (5 minutes)
+3. For databases over 1GB, also increase Node.js memory: `node --max-old-space-size=4096 dist/cli.js --timeout 300000`
+4. Set via environment variable: `DECODE_TIMEOUT_MS=600000`
+
 ### No Transactions Found
 
 - Copilot Money may not have synced yet - open the app and wait for sync