feat: adapt list_instruments to instrument coverage (sdk-java 0.6.1)

Bump com.qtsurfer:sdk-java to 0.6.1 (API spec 0.97.0). InstrumentDetail
replaced its flat dataFrom/dataTo fields with a per-data-type coverage
object, so list_instruments now derives each data window from coverage
(preferring the tickers window, falling back to klines) via the new
appendCoverage helper. No change to the tool input or output contract.

Author: mrmx

CHANGELOG.md

@@ -6,6 +6,12 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [Unreleased]
 
+## [0.5.0] — 2026-07-10
+
+### Changed 🔄
+
+- Bumped `com.qtsurfer:sdk-java` to `0.6.1` (API spec 0.97.0). `InstrumentDetail` replaced its flat `dataFrom`/`dataTo` fields with per-data-type `coverage`, so the **`list_instruments`** tool now derives each instrument's `data: <from> → <to>` window from `coverage` (preferring the `tickers` window, falling back to `klines`, and omitting the suffix when unavailable). No change to the tool's input or output contract.
+
 ## [0.4.0] — 2026-06-16
 
 ### Added ✨

README.md

@@ -158,7 +158,7 @@ MCP transport: stdio (stdin/stdout JSON-RPC 2.0)
 | Tool | Description |
 |------|-------------|
 | `list_exchanges` | List available exchanges (e.g. `binance`, `binancefutures`) |
-| `list_instruments` | List instruments for an exchange with data-availability windows and market info |
+| `list_instruments` | List instruments for an exchange with per-data-type coverage windows and market info |
 | `submit_backtest` | Compile a Java strategy and submit a backtesting run; returns a job ID |
 | `get_job_status` | Get status and full execution metrics for a submitted job |
 | `list_jobs` | List jobs from the current session, optionally filtered by status |

pom.xml

@@ -5,7 +5,7 @@
 
     <groupId>com.qtsurfer</groupId>
     <artifactId>mcp-java</artifactId>
-    <version>0.4.0</version>
+    <version>0.5.0</version>
     <packaging>jar</packaging>
     <name>qtsurfer-mcp-java</name>
 
@@ -34,7 +34,7 @@
         <maven.compiler.release>${java.version}</maven.compiler.release>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <mcp.version>1.1.2</mcp.version>
-        <sdk.version>0.5.0</sdk.version>
+        <sdk.version>0.6.1</sdk.version>
         <slf4j.version>2.0.16</slf4j.version>
         <logback.version>1.5.11</logback.version>
         <junit.version>5.11.4</junit.version>

src/main/java/com/qtsurfer/mcp/tool/McpTools.java

@@ -12,6 +12,7 @@
 import com.qtsurfer.mcp.model.JobStatus;
 import com.qtsurfer.mcp.service.BacktestingService;
 
+import java.time.OffsetDateTime;
 import java.util.ArrayList;
 import java.util.List;
 import java.util.Map;
@@ -114,10 +115,7 @@ private static SyncToolSpecification listInstruments(BacktestingService service)
               if (i.getLastPrice() != null) {
                 sb.append(" (last: ").append(i.getLastPrice()).append(')');
               }
-              if (i.getDataFrom() != null && i.getDataTo() != null) {
-                sb.append(" data: ").append(i.getDataFrom().toLocalDate())
-                  .append(" → ").append(i.getDataTo().toLocalDate());
-              }
+              appendCoverage(sb, i);
               sb.append('\n');
             });
             return text(sb.toString().stripTrailing());
@@ -129,6 +127,28 @@ private static SyncToolSpecification listInstruments(BacktestingService service)
         });
   }
 
+  /**
+   * Appends a {@code " data: <from> → <to>"} suffix derived from the instrument's
+   * coverage, preferring the {@code tickers} window and falling back to
+   * {@code klines}. Appends nothing when coverage, both windows, or either
+   * endpoint of the chosen window is unavailable.
+   */
+  private static void appendCoverage(StringBuilder sb, InstrumentDetail instrument) {
+    if (instrument.getCoverage() == null) return;
+    var coverage = instrument.getCoverage();
+    OffsetDateTime from = null;
+    OffsetDateTime to = null;
+    if (coverage.getTickers() != null) {
+      from = coverage.getTickers().getFrom();
+      to = coverage.getTickers().getTo();
+    } else if (coverage.getKlines() != null) {
+      from = coverage.getKlines().getFrom();
+      to = coverage.getKlines().getTo();
+    }
+    if (from == null || to == null) return;
+    sb.append(" data: ").append(from.toLocalDate()).append(" → ").append(to.toLocalDate());
+  }
+
   // ---- submit_backtest ----------------------------------------------------
 
   private static SyncToolSpecification submitBacktest(BacktestingService service) {