offnadir-delta-mcp 1.3.8 → 1.3.10

package/dist/catalog.js

@@ -78,8 +78,10 @@ export const TOOLS = [
                 updatedSince: { type: 'string', description: 'Differential fetch: only signals (re)enriched at/after this ISO 8601 timestamp. Ignores the date window. Response signals carry last_updated_at.' },
                 createdSince: { type: 'string', description: 'Differential fetch: only signals first enriched at/after this ISO 8601 timestamp.' },
                 observability: { type: 'string', enum: ['observable', 'not-observable'], description: 'Keep only signals with this satellite observability — whether a physical mark is imageable at all (intelligence.satellite_observability).' },
+                observabilityStatus: { type: 'string', enum: ['observable', 'not_observable', 'insufficient_detail'], description: '3-state observability filter. Unlike `observability` (binary), this exposes `insufficient_detail` — signals where imageability is unknown (no RS enrichment yet, unresolved location, or an Impossible verdict rescued because the event reads kinetic). `not_observable` = a considered "nothing to image"; neither bucket leaks insufficient_detail.' },
                 openData: { type: 'string', enum: ['sufficient', 'commercial-recommended', 'not-applicable'], description: 'Keep only signals with this open-data sufficiency — free imagery is enough vs commercial tasking recommended (intelligence.open_data_sufficiency).' },
                 minInformationGain: { type: 'number', minimum: 0, maximum: 1, description: 'Keep only signals whose intelligence.expected_information_gain >= this (0-1).' },
+                taskableOnly: { type: 'boolean', description: 'Keep only signals whose coordinate is search_ready (taskable) — drops country centroids, ADM1 mismatches, reporting-dateline fallbacks and unresolved fixes (intelligence.geo_validation.search_ready). Use when the results feed automated imagery tasking.' },
                 responseFormat: { type: 'string', enum: ['concise', 'detailed'], description: 'Per-signal field detail. "concise" (default) returns key decision + GEOINT fields (incl. collection_priority, the corrected 0-100 ranking value); "detailed" returns the full Signal object.' },
             },
         },
@@ -89,7 +91,9 @@ export const TOOLS = [
         annotations: { readOnlyHint: true },
         description: 'Aggregate statistics over the signal corpus — total event count plus per-category and per-day ' +
             'breakdown (trend) for a bounding box and date window. Cheaper than query_signals (returns ' +
-            'roll-ups, not rows). Costs 1 token(s) per call.',
+            'roll-ups, not rows). NOTE the unit: `total` counts article-deduped events (meta.population = ' +
+            'article_deduped_events), which is NOT cluster-collapsed, so it is >= the query_signals count ' +
+            'for the same window. Costs 1 token(s) per call.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -104,8 +108,11 @@ export const TOOLS = [
         name: 'query_hotspots',
         annotations: { readOnlyHint: true },
         description: 'Geographic hotspots — signal density grid-binned into cells, ranked by event count, each with ' +
-            'peak severity and the categories present. Use to find WHERE activity is concentrating. ' +
-            'Costs 1 token(s) per call.',
+            'peak severity, the categories present, and up to 5 representative event_ids (trace a cell back ' +
+            'to its signals). Use to find WHERE activity is concentrating. NOTE the unit: cells count ' +
+            'satellite-observable points (meta.population = rs_observable_points); meta reports ' +
+            'source_point_count and dropped_by_geo_count / dropped_by_severity_count so point_count is fully ' +
+            'accountable. Costs 1 token(s) per call.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -146,8 +153,9 @@ export const TOOLS = [
         annotations: { readOnlyHint: true },
         description: 'Search the satellite imagery catalog (Sentinel-1/2, OPERA RTC-S1) for scenes over an area and ' +
             'date window — the natural follow-up to a signal (find imagery over the event location). Returns ' +
-            'minimal scene metadata (id, datetime, footprint, cloud cover, platform, preview) — no imagery ' +
-            'bytes. Costs 2 token(s) per call.',
+            'scene metadata (id, datetime, footprint, cloud cover, platform, orbit geometry, coverage, catalog ' +
+            'link) — no imagery bytes. Pass eventDate to classify each scene pre/post/same-day and get ' +
+            'pre/post bracketing + SAR change-pair readiness in meta. Costs 2 token(s) per call.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -155,9 +163,10 @@ export const TOOLS = [
                 collection: { type: 'string', enum: [...IMAGERY_COLLECTIONS], description: 'Catalog collection. Defaults to sentinel-2-l2a.' },
                 date: { type: 'string', description: 'Window end date, YYYY-MM-DD (UTC). Defaults to today.' },
                 days: { type: 'integer', minimum: 1, maximum: SIGNALS_MAX_DAYS, description: 'Window length in days. Defaults to 7.' },
+                eventDate: { type: 'string', description: 'Event date, YYYY-MM-DD (UTC). When set, each scene is tagged timing=pre/post/same_day and meta reports has_pre_baseline / has_post / bracketing_available; for sentinel-1-grd it also reports sar_change_pair_ready + orbit_note (a valid change pair needs a pre and post scene on the same relative orbit).' },
                 cloudCoverMax: { type: 'number', minimum: 0, maximum: 100, description: 'Sentinel-2 only: max cloud cover %.' },
                 limit: { type: 'integer', minimum: 1, maximum: 100, description: 'Max scenes to return. Defaults to 25.' },
-                responseFormat: { type: 'string', enum: ['concise', 'detailed'], description: 'Per-scene field detail. "concise" (default) or "detailed" (adds footprint, constellation, polarizations).' },
+                responseFormat: { type: 'string', enum: ['concise', 'detailed'], description: 'Per-scene field detail. "concise" (default) returns id, collection, datetime, timing, cloud_cover, platform, orbit_state, relative_orbit, instrument_mode, product_type, coverage_ratio, stac_item_url, preview. "detailed" adds footprint bbox/geometry, constellation, polarizations, absolute_orbit, incidence_angle, and non-signed asset hrefs.' },
             },
             required: ['bbox'],
         },
@@ -167,6 +176,10 @@ export const TOOLS = [
         annotations: { readOnlyHint: true, idempotentHint: true },
         description: 'Run an AI RS (remote-sensing) deep-dive assessment for a specific signal: what to observe, ' +
             'recommended sensors, and a collection window. `eventId` is the `id` from query_signals. ' +
+            'The result also carries a deterministic `context` block (event id/date, normalized target, AOI ' +
+            'bbox, observability + quality verdict, and an `imagery_handoff` giving the exact bbox + event_date ' +
+            'to pass to search_imagery for REAL pre/post scene candidates) — turning the assessment into an ' +
+            'actionable collection plan. ' +
             "Costs 5 (quick) or 15 (deep) tokens, charged to the key owner's balance. A prior assessment for " +
             'the same signal is cached (no re-charge). The exact charge and remaining balance are in meta.tokens. ' +
             'Signals that are not satellite-observable (observability:"not-observable" — e.g. political statements ' +

package/dist/index.js

@@ -21,7 +21,7 @@ import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
 import { CallToolRequestSchema, GetPromptRequestSchema, ListPromptsRequestSchema, ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
 import { PROMPTS, RESOURCES, RESOURCE_TEMPLATES, TOOLS } from './catalog.js';
-const VERSION = '1.3.8';
+const VERSION = '1.3.10';
 const REMOTE_URL = new URL(process.env.OFFNADIR_DELTA_MCP_URL ?? 'https://offnadir-delta.com/api/v1/mcp');
 /** Lazily-connected client to the hosted remote MCP server. */
 let remote = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "offnadir-delta-mcp",
-  "version": "1.3.8",
+  "version": "1.3.10",
   "description": "Local (stdio) MCP server for Off-Nadir Delta — live, geolocated world-event intelligence, a Daily World Brief, satellite-imagery search, and an OSINT/GEOINT analyst. Forwards to the hosted server with your API key.",
   "type": "module",
   "bin": {