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:
Devid HW
2026-04-23 00:53:51 +07:00
co-authored by Claude Sonnet 4.6
parent ccc9e7e4d8
commit bce0323469
2 changed files with 52 additions and 3 deletions
+50 -1
View File
@@ -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: