@neat.is/mcp 0.9.2-dev.20260821 → 0.9.2

package/dist/index.js

@@ -667,6 +667,36 @@ async function relate(client2, input) {
     return formatErrorResponse(`Error talking to neat-core: ${err.message}`);
   }
 }
+async function ask(client2, input) {
+  const question = input.question.trim();
+  if (!question) return formatEmptyResponse("ask: the question was empty.");
+  return withMissingNodeFallback(async () => {
+    const result = await client2.get(
+      projectPath(input.project, `/graph/ask?q=${encodeURIComponent(question)}`)
+    );
+    const blockLines = [];
+    if (result.matched.length > 0) {
+      blockLines.push(
+        `Matched (${result.intent}): ` + result.matched.map((m) => `${m.nodeId} [${m.via} ${m.score.toFixed(2)}]`).join(", ")
+      );
+    } else if (result.scope === "global") {
+      blockLines.push(`Graph-wide answer (${result.intent}) \u2014 no entity named.`);
+    }
+    for (const section of result.sections) {
+      blockLines.push("", `${section.heading}:`);
+      for (const fact of section.facts) {
+        const tag = fact.provenance ? ` [${fact.provenance}${fact.confidence !== void 0 ? ` ${fact.confidence.toFixed(2)}` : ""}]` : fact.confidence !== void 0 ? ` [confidence ${fact.confidence.toFixed(2)}]` : "";
+        blockLines.push(`  \u2022 ${fact.text}${tag}`);
+      }
+    }
+    return formatToolResponse({
+      summary: result.answer,
+      block: blockLines.join("\n").trim(),
+      ...result.confidence !== void 0 ? { confidence: result.confidence } : {},
+      ...result.provenance.length > 0 ? { provenance: result.provenance } : {}
+    });
+  }, `ask: nothing in "${question}" resolved to a node in the graph.`);
+}
 async function getIncidentHistory(client2, input) {
   return withMissingNodeFallback(async () => {
     const body = await client2.get(
@@ -1153,6 +1183,15 @@ var server = new McpServer(
   { instructions: serverInstructions }
 );
 var registerTool = (name, description, paramsSchema, cb) => server.tool(name, description, paramsSchema, cb);
+registerTool(
+  "ask",
+  "Ask the graph a question in plain language \u2014 the front door to NEAT. Reach for this FIRST, before Read/Grep/Bash, for any question about this system's behaviour, dependencies, failures, root cause, or blast radius. You do NOT need to know which tool or the exact node id: `ask` resolves the entities in your question to graph nodes and routes it to the right traversal (root cause, dependencies, observed runtime calls, incidents, divergences, blast radius), returning one compact answer with every fact provenance-tagged (EXTRACTED/OBSERVED/INFERRED/STALE) and confidence-scored. Use the structured tools (get_root_cause, get_dependencies, \u2026) when you already have a node id and want just that one traversal.",
+  {
+    question: z.string().describe('A natural-language question, e.g. "why is checkout failing?" or "what breaks if I change the orders table?"'),
+    project: projectField
+  },
+  async (input) => ask(client, { ...input, project: projectFor(input) })
+);
 registerTool(
   "get_root_cause",
   "Trace a failing node up its dependency graph to find the underlying cause. Use this when something is breaking and you want to know which upstream component is the actual culprit.",