docs: update README and MCP_TOOLS for deals-in-DB architecture
- README: update deal analytics count (19 dimensions, DB-backed) - MCP_TOOLS: remove deals.csv/deals_json from backtest output schema - MCP_TOOLS: add export_deals_csv tool documentation - MCP_TOOLS: update analytics tools to show report_id/report_dir/latest pattern - MCP_TOOLS: fix get_backtest_crash_info description Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -19,8 +19,8 @@ Claude: [compile → clean → backtest → analyze 1,847 deals]
|
||||
|---|---|---|
|
||||
| **Platform** | macOS/Linux native | Windows only |
|
||||
| **Backtest pipeline** | ✅ Full (compile → run → analyze) | ✅ Via MT5 Python package |
|
||||
| **Deal-level analytics** | ✅ 15+ dimensions | ❌ |
|
||||
| **Report organization** | ✅ SQLite + search + history | ❌ |
|
||||
| **Deal-level analytics** | ✅ 19 dimensions, DB-backed | ❌ |
|
||||
| **Report organization** | ✅ SQLite (reports + deals) + search + history | ❌ |
|
||||
| **MQL5 compilation** | ✅ Headless (MetaEditor via Wine, no GUI) | ⚠️ Via GUI or terminal |
|
||||
| **Optimization** | ✅ Background + results parsing + .set generation | ⚠️ Terminal only, no parsing |
|
||||
| **Crash debugging** | ✅ Wine/MT5 diagnostics | ❌ |
|
||||
|
||||
+50
-1
@@ -2629,7 +2629,7 @@ Get Wine prefix details: Windows version, installed programs, registry.
|
||||
|
||||
## `get_backtest_crash_info`
|
||||
|
||||
Investigate backtest failures: incomplete markers, missing deals.csv, errors.
|
||||
Investigate backtest failures: incomplete markers, missing metrics.json, Wine/MT5 errors.
|
||||
|
||||
**When to call:** When a backtest fails unexpectedly.
|
||||
|
||||
@@ -3057,6 +3057,55 @@ Find comparable reports (same EA/symbol/timeframe).
|
||||
|
||||
---
|
||||
|
||||
## `export_deals_csv`
|
||||
|
||||
Export deals for a report to a CSV file on demand. Deals are stored in the database — use this when you need a CSV file for external tools (Excel, pandas, etc.).
|
||||
|
||||
**When to call:** When you need a `deals.csv` file. CSV is not written automatically after backtests anymore.
|
||||
|
||||
### Input schema
|
||||
|
||||
```typescript
|
||||
{
|
||||
report_id?: string; // Report ID to export (default: latest report)
|
||||
output_path?: string; // File path for CSV output (default: <report_dir>/deals.csv)
|
||||
}
|
||||
```
|
||||
|
||||
### Output schema
|
||||
|
||||
```typescript
|
||||
{
|
||||
success: boolean;
|
||||
report_id: string;
|
||||
deals_count: number;
|
||||
output_path: string; // Absolute path to the written CSV file
|
||||
}
|
||||
```
|
||||
|
||||
### Example
|
||||
|
||||
```json
|
||||
// Input — export latest report to default path
|
||||
{}
|
||||
|
||||
// Input — export specific report to custom path
|
||||
{
|
||||
"report_id": "20260422_051041_DPS21_XAUUSDc_M5_1",
|
||||
"output_path": "/tmp/dps21_deals.csv"
|
||||
}
|
||||
|
||||
// Output
|
||||
{
|
||||
"success": true,
|
||||
"report_id": "20260422_051041_DPS21_XAUUSDc_M5_1",
|
||||
"deals_count": 891,
|
||||
"output_path": "/Users/…/reports/20260422_051041_DPS21_XAUUSDc_M5_1/deals.csv"
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Granular Analytics — Common Input Pattern
|
||||
|
||||
All granular analytics tools below (`analyze_monthly_pnl` through `analyze_efficiency`, plus `list_deals` and `search_deals_*`) share the same report resolution logic:
|
||||
|
||||
Reference in New Issue
Block a user