offnadir-delta-mcp 1.31.0 → 1.34.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +3 -4
  2. package/dist/catalog.js +95 -184
  3. package/dist/index.js +1 -1
  4. package/package.json +1 -1
package/README.md CHANGED
@@ -16,7 +16,7 @@ satellite can actually resolve it, and produce a collection-ready plan.
16
16
  Real-time event and geospatial intelligence for OSINT, geopolitical risk, and GEOINT work —
17
17
  source-linked, geolocated, and current, not a training snapshot.
18
18
 
19
- `42` tools · MCP server version `1.31.0` · [full reference](https://offnadir-delta.com/docs/mcp)
19
+ `41` tools · MCP server version `1.34.0` · [full reference](https://offnadir-delta.com/docs/mcp)
20
20
 
21
21
  ## What it does
22
22
 
@@ -77,7 +77,7 @@ locally from a generated catalog, so registries can introspect it without creden
77
77
 
78
78
  ### First call — free
79
79
 
80
- 23 of the 42 tools cost nothing, so the first thing you run is free:
80
+ 23 of the 41 tools cost nothing, so the first thing you run is free:
81
81
 
82
82
  > Give me the latest Daily World Brief. Lead with the three most significant developments,
83
83
  > explain why each matters, and cite the supporting signals.
@@ -116,7 +116,6 @@ Whether a satellite can resolve it, which one, and when it next passes.
116
116
  | `rank_imaging_priority` | WHERE, and with what class of satellite, observation is most worthwhile now: composite IMPORTANCE crossed with the SPEC CLASS the required resolution demands — coarse, hr (free Sentinel-class) or vhr. | 1 tok |
117
117
  | `survey_observable_events` | Which events a sensor can actually RESOLVE, over the FULL set. | 1 tok |
118
118
  | `predict_satellite_passes` | WHEN a place can next be imaged and by WHAT: 13 free-systematic and commercial-taskable families. | 2 tok |
119
- | `test_hypotheses` | Given competing statements, the observation that would REFUTE the most — and those that would refute none. | 3 tok |
120
119
  | `lookup_elevation` | Terrain height from the Copernicus DEM GLO-30 for a point, bbox or polygon, with relief — the number that governs SAR layover and shadow. | free |
121
120
  | `analyze_terrain` | Compute FROM the terrain. | free |
122
121
 
@@ -150,7 +149,7 @@ Stand up continuous coverage and be told only when the answer changes. Creating
150
149
  | `get_watch` | One watch end to end: target, state, latest change, measurements with recent series, standing-order questions, and for an event watch its verification state, developments and thread, plus this account's notes. | free |
151
150
  | `get_decision_package` | Everything needed to decide what to collect next about one watch, in one object. | 5 tok |
152
151
  | `create_watch` | Add a target to the Watchlist. | free |
153
- | `update_watch` | Rename, pause or resume a watch. | free |
152
+ | `update_watch` | Rename, pause, resume or close a watch. | free |
154
153
  | `delete_watch` | Delete a watch and its underlying resources — bound monitored areas with their history, and standing orders. | free |
155
154
  | `add_note` | Add a note to a watch, start a thread, or reply. | free |
156
155
  | `delete_note` | Delete one note from a watch. | free |
package/dist/catalog.js CHANGED
@@ -13,7 +13,7 @@
13
13
  * Actual `tools/call` / `resources/read` / `prompts/get` requests are forwarded
14
14
  * to the remote server with the caller's OFFNADIR_DELTA_API_KEY (see index.ts).
15
15
  */
16
- // Generated for Off-Nadir Delta MCP 1.31.0.
16
+ // Generated for Off-Nadir Delta MCP 1.34.0.
17
17
  export const TOOLS = [
18
18
  {
19
19
  "name": "query_signals",
@@ -105,55 +105,57 @@ export const TOOLS = [
105
105
  "sources",
106
106
  "geoint"
107
107
  ],
108
- "description": "\"geoint\" = collection_priority, NOT the saturated geoint_score."
108
+ "description": "Default \"severity\". \"geoint\" = collection relevance: satellite-visible first, then geoint_score, then stage."
109
109
  },
110
110
  "updatedSince": {
111
111
  "type": "string",
112
- "description": "Only signals (re)enriched at/after this ISO 8601 time. Ignores the date window."
112
+ "description": "Only signals refolded at/after this ISO 8601 time. Narrows the date window rather than replacing it."
113
113
  },
114
114
  "createdSince": {
115
115
  "type": "string",
116
- "description": "Only signals FIRST enriched at/after this ISO 8601 time."
116
+ "description": "Only signals FIRST seen at/after this ISO 8601 time."
117
117
  },
118
- "observability": {
119
- "type": "string",
120
- "enum": [
121
- "observable",
122
- "not-observable"
123
- ],
124
- "description": "Is a physical mark imageable at all."
125
- },
126
- "observabilityStatus": {
127
- "type": "string",
128
- "enum": [
129
- "observable",
130
- "not_observable",
131
- "insufficient_detail"
132
- ],
133
- "description": "3-state `observability`, adding `insufficient_detail`; neither bucket leaks it."
118
+ "stages": {
119
+ "type": "array",
120
+ "items": {
121
+ "type": "string",
122
+ "enum": [
123
+ "reported",
124
+ "localized",
125
+ "pinpointed"
126
+ ]
127
+ },
128
+ "description": "Place precision: reported (country/province), localized (town), pinpointed (block/facility)."
134
129
  },
135
- "openData": {
136
- "type": "string",
137
- "enum": [
138
- "sufficient",
139
- "commercial-recommended",
140
- "not-applicable"
141
- ],
142
- "description": "Free imagery enough vs commercial tasking recommended."
130
+ "sensors": {
131
+ "type": "array",
132
+ "items": {
133
+ "type": "string",
134
+ "enum": [
135
+ "sentinel-2",
136
+ "sentinel-1-sar",
137
+ "viirs-thermal",
138
+ "planet",
139
+ "vhr-optical",
140
+ "multi-sensor",
141
+ "none"
142
+ ]
143
+ },
144
+ "description": "Keep only signals whose recommended sensor is one of these."
143
145
  },
144
- "minInformationGain": {
146
+ "minGeoint": {
145
147
  "type": "number",
146
148
  "minimum": 0,
147
- "maximum": 1,
148
- "description": "expected_information_gain >= this (0-1)."
149
+ "maximum": 10,
150
+ "description": "geoint_score >= this (0-10) — how much a satellite look would add."
149
151
  },
150
- "taskableOnly": {
152
+ "plottableOnly": {
151
153
  "type": "boolean",
152
- "description": "Coordinate is search_ready. GEOMETRY ONLY — for tasking use collectionReadyOnly."
154
+ "description": "Coordinate is precise enough to draw as a point, and therefore to point a sensor at."
153
155
  },
154
- "collectionReadyOnly": {
156
+ "observableOnly": {
155
157
  "type": "boolean",
156
- "description": "Strict tasking candidates: search_ready AND observable AND quality!=failed AND a plan AND a coordinate."
158
+ "description": "A satellite could see it (effect large enough, place fine enough). Tasking: with plottableOnly."
157
159
  },
158
160
  "responseFormat": {
159
161
  "type": "string",
@@ -196,7 +198,7 @@ export const TOOLS = [
196
198
  },
197
199
  {
198
200
  "name": "query_stats",
199
- "description": "Roll-ups over the corpus: totals plus per-category and per-day breakdown. NOTE the unit — `total` counts article-deduped events, not clusters, so it is >= the query_signals count.",
201
+ "description": "Roll-ups over the corpus: totals plus per-category and per-day breakdown. `total` counts the same events query_signals returns, so it matches its meta.total_count for the same query.",
200
202
  "inputSchema": {
201
203
  "type": "object",
202
204
  "properties": {
@@ -268,7 +270,7 @@ export const TOOLS = [
268
270
  },
269
271
  {
270
272
  "name": "query_hotspots",
271
- "description": "Where activity concentrates: density grid-binned into ranked cells with peak severity, categories and representative event_ids. Cells count satellite-observable points.",
273
+ "description": "Where activity concentrates: density grid-binned into ranked cells with peak severity, categories and representative event_ids. Events too coarse to place are counted in meta.dropped_by_plottable_count, not spread over the grid.",
272
274
  "inputSchema": {
273
275
  "type": "object",
274
276
  "properties": {
@@ -320,13 +322,13 @@ export const TOOLS = [
320
322
  "type": "number",
321
323
  "minimum": 0,
322
324
  "maximum": 10,
323
- "description": "Keep only points with severity_score >= this."
325
+ "description": "Keep only events with severity_score >= this."
324
326
  },
325
327
  "limit": {
326
328
  "type": "integer",
327
329
  "minimum": 1,
328
330
  "maximum": 500,
329
- "description": "Source points sampled before binning — NOT the cell count. Default/max 500."
331
+ "description": "Max CELLS returned, highest first. The whole window is aggregated either way; meta.total_cell_count is the uncut count. Default/max 500."
330
332
  }
331
333
  }
332
334
  },
@@ -570,8 +572,8 @@ export const TOOLS = [
570
572
  "type": "object",
571
573
  "properties": {
572
574
  "event_id": {
573
- "type": "integer",
574
- "description": "The `id` from query_signals; the server resolves its point and AOI."
575
+ "type": "string",
576
+ "description": "The `id` (UUID) from query_signals; the server resolves its point and AOI."
575
577
  },
576
578
  "analysis_goal": {
577
579
  "type": "string",
@@ -869,8 +871,8 @@ export const TOOLS = [
869
871
  "type": "object",
870
872
  "properties": {
871
873
  "eventId": {
872
- "type": "integer",
873
- "description": "Signal id (global_event_id) from query_signals."
874
+ "type": "string",
875
+ "description": "Signal id (UUID) from query_signals."
874
876
  },
875
877
  "kind": {
876
878
  "type": "string",
@@ -911,7 +913,7 @@ export const TOOLS = [
911
913
  "description": "Deterministic collection context for this signal — not model prose. Use `imagery_handoff` to go straight from the assessment to real scene candidates.",
912
914
  "properties": {
913
915
  "event_id": {
914
- "type": "integer"
916
+ "type": "string"
915
917
  },
916
918
  "event_date": {
917
919
  "type": [
@@ -1117,7 +1119,7 @@ export const TOOLS = [
1117
1119
  "description": "Present ONLY on a pre-charge rejection; `content` and `meta` are then absent."
1118
1120
  },
1119
1121
  "event_id": {
1120
- "type": "integer",
1122
+ "type": "string",
1121
1123
  "description": "Echoed on a rejection so the caller can tell which signal it was."
1122
1124
  },
1123
1125
  "charged": {
@@ -1415,8 +1417,8 @@ export const TOOLS = [
1415
1417
  "description": "Only claims a later answer restated with WEAKER evidence — read these first."
1416
1418
  },
1417
1419
  "event_id": {
1418
- "type": "number",
1419
- "description": "Only claims about this event. If neither anchor resolves, `event_link.linked` says so."
1420
+ "type": "string",
1421
+ "description": "Only claims about this event (the UUID from query_signals). `event_link.linked` says whether any resolved."
1420
1422
  },
1421
1423
  "limit": {
1422
1424
  "type": "number",
@@ -1457,93 +1459,6 @@ export const TOOLS = [
1457
1459
  "destructiveHint": false
1458
1460
  }
1459
1461
  },
1460
- {
1461
- "name": "test_hypotheses",
1462
- "description": "Given competing statements, the observation that would REFUTE the most — and those that would refute none. **The logic runs one way**: an ABSENT observable refutes every statement requiring it; a PRESENT one refutes nothing.",
1463
- "inputSchema": {
1464
- "type": "object",
1465
- "properties": {
1466
- "hypotheses": {
1467
- "type": "array",
1468
- "items": {
1469
- "type": "string"
1470
- },
1471
- "minItems": 2,
1472
- "maxItems": 8,
1473
- "description": "Two to eight competing statements, one assertion each (<=500 chars)."
1474
- },
1475
- "mode": {
1476
- "type": "string",
1477
- "enum": [
1478
- "competing",
1479
- "joint"
1480
- ],
1481
- "description": "`competing` (default): an observable required by ALL is useless. `joint`: one required by all is BEST."
1482
- },
1483
- "event_id": {
1484
- "type": "number",
1485
- "description": "Test the standing claims about this event; restated claims are excluded."
1486
- }
1487
- },
1488
- "required": []
1489
- },
1490
- "outputSchema": {
1491
- "type": "object",
1492
- "properties": {
1493
- "summary": {
1494
- "type": "string",
1495
- "description": "One-line natural-language summary of the result, ready to relay to a user."
1496
- },
1497
- "meta": {
1498
- "type": "object",
1499
- "description": "Query echo, token charge/balance (meta.tokens), and pagination where applicable."
1500
- },
1501
- "hypotheses": {
1502
- "type": "array",
1503
- "items": {
1504
- "type": "object"
1505
- }
1506
- },
1507
- "best": {
1508
- "type": "object"
1509
- },
1510
- "discriminators": {
1511
- "type": "array",
1512
- "items": {
1513
- "type": "object"
1514
- }
1515
- },
1516
- "no_diagnostic_value": {
1517
- "type": "array",
1518
- "items": {
1519
- "type": "object"
1520
- }
1521
- },
1522
- "undecomposable": {
1523
- "type": "array",
1524
- "items": {
1525
- "type": "string"
1526
- }
1527
- },
1528
- "no_discriminator_reason": {
1529
- "type": "string"
1530
- },
1531
- "note": {
1532
- "type": "string"
1533
- }
1534
- },
1535
- "required": [
1536
- "summary",
1537
- "discriminators",
1538
- "note"
1539
- ]
1540
- },
1541
- "annotations": {
1542
- "readOnlyHint": false,
1543
- "openWorldHint": false,
1544
- "destructiveHint": true
1545
- }
1546
- },
1547
1462
  {
1548
1463
  "name": "query_developments",
1549
1464
  "description": "What actually CHANGED about the events in an area, not which articles are new. Each change is labelled `world` (the event's own state moved) or `measurement` (what we can see moved).",
@@ -1576,45 +1491,52 @@ export const TOOLS = [
1576
1491
  },
1577
1492
  "description": "Restrict to these signal categories."
1578
1493
  },
1579
- "development_types": {
1494
+ "axes": {
1580
1495
  "type": "array",
1581
1496
  "items": {
1582
1497
  "type": "string",
1583
1498
  "enum": [
1584
- "new_event",
1585
- "baseline",
1586
- "occurrence_time_established",
1587
- "casualty_count_first_reported",
1588
- "casualty_count_raised",
1589
- "casualty_count_corrected",
1499
+ "attributed_actor",
1590
1500
  "casualties_disputed",
1591
- "attribution_stated",
1592
- "attribution_changed",
1593
- "attribution_disputed",
1594
- "corroboration_increased",
1595
- "severity_escalated",
1596
- "location_resolved",
1597
- "observability_established",
1598
- "collection_ready",
1599
- "imagery_available",
1600
- "sar_pair_ready",
1601
- "observed",
1602
- "confirmed",
1603
- "reporting_disputed",
1604
- "retracted"
1501
+ "casualties_injured",
1502
+ "casualties_killed",
1503
+ "distinct_hosts",
1504
+ "escalation_trend",
1505
+ "geoint_score",
1506
+ "imagery_post_status",
1507
+ "imagery_sar_pair_status",
1508
+ "location_level",
1509
+ "means_reported",
1510
+ "member_count",
1511
+ "occurred_at",
1512
+ "point_plottable",
1513
+ "quality_status",
1514
+ "severity_score",
1515
+ "stage",
1516
+ "target_status",
1517
+ "targets_named"
1605
1518
  ]
1606
1519
  },
1607
- "description": "Restrict to these kinds of change. An unknown value is an error, not an empty result."
1520
+ "description": "Restrict to these axes. An unknown value errors rather than returning nothing."
1608
1521
  },
1609
1522
  "notable_only": {
1610
1523
  "type": "boolean",
1611
1524
  "description": "Default true. False returns every recorded change."
1612
1525
  },
1526
+ "include_member_count": {
1527
+ "type": "boolean",
1528
+ "description": "Default false. \"One more report arrived\" is not news about the event."
1529
+ },
1613
1530
  "limit": {
1614
1531
  "type": "number",
1615
1532
  "minimum": 1,
1616
1533
  "maximum": 200,
1617
1534
  "description": "How many developments to return (default 50)."
1535
+ },
1536
+ "offset": {
1537
+ "type": "number",
1538
+ "minimum": 0,
1539
+ "description": "Skip this many; meta.total_count is the window."
1618
1540
  }
1619
1541
  },
1620
1542
  "required": []
@@ -1654,8 +1576,8 @@ export const TOOLS = [
1654
1576
  "type": "object",
1655
1577
  "properties": {
1656
1578
  "event_id": {
1657
- "type": "number",
1658
- "description": "Any signal id in the event; the canonical event is returned."
1579
+ "type": "string",
1580
+ "description": "Event id (UUID). A folded id resolves to its event; merged_from_request says so."
1659
1581
  }
1660
1582
  },
1661
1583
  "required": [
@@ -2266,27 +2188,6 @@ export const TOOLS = [
2266
2188
  "type": "object"
2267
2189
  }
2268
2190
  },
2269
- "discriminators": {
2270
- "type": "array",
2271
- "items": {
2272
- "type": "object"
2273
- }
2274
- },
2275
- "no_diagnostic_value": {
2276
- "type": "array",
2277
- "items": {
2278
- "type": "object"
2279
- }
2280
- },
2281
- "undecomposable": {
2282
- "type": "array",
2283
- "items": {
2284
- "type": "string"
2285
- }
2286
- },
2287
- "no_discriminator_reason": {
2288
- "type": "string"
2289
- },
2290
2191
  "collection_options": {
2291
2192
  "type": "object"
2292
2193
  },
@@ -2402,7 +2303,7 @@ export const TOOLS = [
2402
2303
  },
2403
2304
  {
2404
2305
  "name": "update_watch",
2405
- "description": "Rename, pause or resume a watch. **Pausing is not a display state**: monitored areas stop being measured and charged, standing orders stop checking.",
2306
+ "description": "Rename, pause, resume or close a watch. **Pausing is not a display state**: monitored areas stop being measured and charged, standing orders stop checking. **Closing states how the question ended** and requires close_reason.",
2406
2307
  "inputSchema": {
2407
2308
  "type": "object",
2408
2309
  "properties": {
@@ -2419,9 +2320,19 @@ export const TOOLS = [
2419
2320
  "enum": [
2420
2321
  "active",
2421
2322
  "paused",
2422
- "saved"
2323
+ "saved",
2324
+ "closed"
2325
+ ],
2326
+ "description": "\"paused\" stops the bound checks; \"active\" resumes them; \"closed\" ends the question and needs close_reason."
2327
+ },
2328
+ "close_reason": {
2329
+ "type": "string",
2330
+ "enum": [
2331
+ "resolved",
2332
+ "lapsed",
2333
+ "false_alarm"
2423
2334
  ],
2424
- "description": "\"paused\" stops the bound checks; \"active\" resumes them."
2335
+ "description": "Required when status is \"closed\". resolved = an answer was reached; lapsed = interest moved on without an answer; false_alarm = never a watchable event. They point at different things to fix, so do not collapse them."
2425
2336
  },
2426
2337
  "notify_email": {
2427
2338
  "type": "boolean",
@@ -2988,8 +2899,8 @@ export const TOOLS = [
2988
2899
  ],
2989
2900
  "properties": {
2990
2901
  "signal_id": {
2991
- "type": "integer",
2992
- "description": "The signal (global_event_id) to research further."
2902
+ "type": "string",
2903
+ "description": "The signal id (UUID from query_signals) to research further."
2993
2904
  }
2994
2905
  }
2995
2906
  },
package/dist/index.js CHANGED
@@ -21,7 +21,7 @@ import { Client } from '@modelcontextprotocol/sdk/client/index.js';
21
21
  import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
22
22
  import { CallToolRequestSchema, GetPromptRequestSchema, ListPromptsRequestSchema, ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
23
23
  import { PROMPTS, RESOURCES, RESOURCE_TEMPLATES, TOOLS } from './catalog.js';
24
- const VERSION = '1.31.0';
24
+ const VERSION = '1.34.0';
25
25
  const REMOTE_URL = new URL(process.env.OFFNADIR_DELTA_MCP_URL ?? 'https://offnadir-delta.com/api/v1/mcp');
26
26
  /** Lazily-connected client to the hosted remote MCP server. */
27
27
  let remote = null;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "offnadir-delta-mcp",
3
- "version": "1.31.0",
3
+ "version": "1.34.0",
4
4
  "description": "Local (stdio) MCP server for Off-Nadir Delta \u2014 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.",
5
5
  "type": "module",
6
6
  "bin": {