offnadir-delta-mcp 1.3.1 → 1.3.3

package/dist/catalog.js

@@ -75,10 +75,10 @@ export const TOOLS = [
                 minSeverity: { type: 'number', minimum: 0, maximum: 10, description: 'Keep only signals with severity_score >= this (0-10).' },
                 escalating: { type: 'boolean', description: 'Keep only signals whose escalation_trend is "escalating".' },
                 sort: { type: 'string', enum: ['severity', 'recent', 'sources'], description: "Result ordering. Omit for the feed's default ranking." },
-                updatedSince: { type: 'string', description: 'Differential fetch: only signals (re)enriched at/after this ISO 8601 timestamp. Ignores the date window.' },
+                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 (intelligence.satellite_observability).' },
-                openData: { type: 'string', enum: ['sufficient', 'commercial-recommended', 'not-applicable'], description: 'Keep only signals with this open-data sufficiency (intelligence.open_data_sufficiency).' },
+                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).' },
+                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).' },
                 responseFormat: { type: 'string', enum: ['concise', 'detailed'], description: 'Per-signal field detail. "concise" (default) returns key decision + GEOINT fields; "detailed" returns the full Signal object.' },
             },
@@ -115,7 +115,7 @@ export const TOOLS = [
                 categories: { type: 'array', items: { type: 'string', enum: [...DELTA_CATEGORIES] }, description: 'Restrict to these categories. Omit for all.' },
                 precision: { type: 'number', minimum: 0.1, maximum: 5, description: 'Grid cell size in decimal degrees. Defaults to 1.' },
                 minSeverity: { type: 'number', minimum: 0, maximum: 10, description: 'Keep only points with severity_score >= this.' },
-                limit: { type: 'integer', minimum: 1, maximum: SIGNALS_MAX_LIMIT, description: 'Max source points to bin. Defaults to 500.' },
+                limit: { type: 'integer', minimum: 1, maximum: SIGNALS_MAX_LIMIT, description: 'Max source points sampled before grid-binning — NOT the number of cells returned. Defaults to 500 (the max). Lower values sample fewer events and fragment clusters (each cell trends toward count 1), so leave at the default for a representative density map.' },
             },
         },
     },
@@ -137,7 +137,8 @@ export const TOOLS = [
         annotations: { readOnlyHint: true },
         description: "Check the calling key's remaining token balance and plan capabilities — monthly allocation, " +
             'tokens used this period, tokens remaining, and whether the plan includes AI tools over the API ' +
-            '(assess_signal / ask_analyst). Use this to pre-flight a metered call. Free of token charges.',
+            '(assess_signal / ask_analyst). Use this to pre-flight a metered call: decide whether enough ' +
+            'balance is left before spending. Free of token charges.',
         inputSchema: { type: 'object', properties: {} },
     },
     {
@@ -167,7 +168,10 @@ export const TOOLS = [
         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. ' +
             "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.',
+            '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 ' +
+            'or broad-area events with no imageable physical mark) are rejected BEFORE any charge, so pre-filter ' +
+            'with query_signals observability:"observable" to spend only where imagery helps.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -182,14 +186,17 @@ export const TOOLS = [
         annotations: { readOnlyHint: true },
         description: 'Ask the Delta Analyst an OSINT/GEOINT question. Runs an agentic multi-step analysis over the ' +
             'signal corpus and returns a structured brief (summary, findings with collection recommendations, ' +
-            'assessment, citations). Costs 5–45 tokens (usage-based; the exact charge and remaining balance are ' +
-            'in meta.tokens). Synchronous — may take up to ~120s. Not cached — each call is charged.',
+            'assessment, citations). Costs 5–45 tokens (usage-based, metered by the compute the question actually ' +
+            'uses; charged ONCE, when the run completes; the exact charge and remaining balance are in meta.tokens). ' +
+            'Hybrid async: waits up to ~95s and returns the brief; a longer run returns {status:"processing", job_id} ' +
+            'while finishing in the background — call again with the SAME idempotencyKey to fetch the finished brief ' +
+            'without a second charge.',
         inputSchema: {
             type: 'object',
             properties: {
                 question: { type: 'string', description: 'The analytic question (≤ 500 chars).' },
                 bbox: { ...BBOX, description: 'Optional focus bounding box [minLon, minLat, maxLon, maxLat] (WGS84).' },
-                idempotencyKey: { type: 'string', description: 'Optional at-most-once key. Retry with the SAME key after a timeout to avoid a second charge; use a fresh key to ask again.' },
+                idempotencyKey: { type: 'string', description: 'Optional at-most-once key. Re-sending the SAME key resolves to the SAME run: if it finished you get the brief with NO second charge; if it is still running you get its processing status. Strongly recommended — it makes a timeout recoverable. Use a fresh key to ask again.' },
             },
             required: ['question'],
         },
@@ -197,9 +204,10 @@ export const TOOLS = [
 ];
 export const RESOURCES = [
     { uri: 'brief://latest', name: 'Daily World Brief (latest)', description: 'The most recent AI-synthesized Daily World Brief (JSON). Free.', mimeType: 'application/json' },
-    { uri: 'signals://schema', name: 'Signal object schema', description: 'JSON Schema of the public Signal shape returned by query_signals.', mimeType: 'application/json' },
+    { uri: 'signals://schema', name: 'Signal object schema', description: 'JSON Schema of the public Signal shape returned by query_signals / /api/v1/signals.', mimeType: 'application/json' },
     { uri: 'usage://current', name: 'API usage & quota', description: 'Remaining token balance and plan capabilities for the calling key. Free.', mimeType: 'application/json' },
     { uri: 'imagery://collections', name: 'Imagery collections', description: 'The satellite catalog collections searchable via search_imagery. Free.', mimeType: 'application/json' },
+    { uri: 'status://current', name: 'Data freshness & pipeline status', description: 'How current the data is (ingestion/enrichment frontier), the Daily World Brief status, and an Operational/Delayed/Degraded roll-up. Free.', mimeType: 'application/json' },
 ];
 export const RESOURCE_TEMPLATES = [
     { uriTemplate: 'brief://{date}', name: 'Daily World Brief by date', description: 'The Daily World Brief for a specific UTC date (YYYY-MM-DD). Free.', mimeType: 'application/json' },
@@ -212,7 +220,7 @@ export const PROMPTS = [
     },
     {
         name: 'assess-top-signal',
-        description: 'Find the highest-severity recent signal in an area/category and run an RS assessment (Pro).',
+        description: 'Find the highest-severity recent signal in an area/category and run an RS assessment.',
         arguments: [
             { name: 'bbox', description: 'Bounding box "minLon,minLat,maxLon,maxLat" (optional).', required: false },
             { name: 'category', description: 'Category filter (optional).', required: false },

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.1';
+const VERSION = '1.3.3';
 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;
@@ -54,7 +54,7 @@ async function getRemote() {
         throw err;
     }
 }
-const server = new Server({ name: 'off-nadir-delta', version: VERSION }, { capabilities: { tools: {}, resources: {}, prompts: {} } });
+const server = new Server({ name: 'off-nadir-delta', title: 'Off-Nadir Delta', version: VERSION }, { capabilities: { tools: {}, resources: {}, prompts: {} } });
 // --- Introspection: answered locally, no network, no credentials. ---
 server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
 server.setRequestHandler(ListResourcesRequestSchema, async () => ({ resources: RESOURCES }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "offnadir-delta-mcp",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "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": {