@recomention/mcp 0.1.0 → 0.1.1

package/dist/report.js

@@ -0,0 +1,46 @@
+const usable = (a) => !a.failed && !a.noAnswer && (a.mentioned === true || a.mentioned === false);
+export function questionSummary(q) {
+    const answers = Array.isArray(q.answers) ? q.answers : [];
+    const byEngine = new Map();
+    for (const a of answers) {
+        const e = byEngine.get(String(a.engine)) ?? { named: 0, usable: 0, notUsable: 0 };
+        if (usable(a)) {
+            e.usable++;
+            if (a.mentioned === true)
+                e.named++;
+        }
+        else
+            e.notUsable++;
+        byEngine.set(String(a.engine), e);
+    }
+    const named = [...byEngine.values()].reduce((n, e) => n + e.named, 0);
+    const of = [...byEngine.values()].reduce((n, e) => n + e.usable, 0);
+    return {
+        order: q.order, text: q.text, intent: q.intent, stage: q.stage,
+        named: `${named} of ${of} usable answers`,
+        engines: Object.fromEntries([...byEngine].map(([engine, e]) => [engine, { named: `${e.named} of ${e.usable}`, notUsable: e.notUsable }])),
+    };
+}
+export function compactReport(body, question) {
+    const report = body?.report;
+    if (!report || !Array.isArray(report.questions))
+        return body;
+    const questions = report.questions;
+    if (question !== undefined) {
+        // By the question's own order (real reports number from 0), never by list position.
+        const match = questions.find((q) => q.order === question);
+        if (!match) {
+            const orders = questions.map((q) => Number(q.order)).filter(Number.isFinite);
+            return { error: orders.length ? `No question with order ${question}; orders run ${Math.min(...orders)} to ${Math.max(...orders)}.` : `No question with order ${question}.` };
+        }
+        return { report: { slug: report.slug, brand: report.brand, domain: report.domain, simulated: report.simulated, enginesSkipped: report.enginesSkipped, question: match } };
+    }
+    return {
+        ...body,
+        report: {
+            ...report,
+            questions: questions.map(questionSummary),
+            answersOmitted: `Answer texts, brands and citations are left out to fit an agent's context. Call again with question set to a question's order (from 0) for its answers. Engines in enginesSkipped did not run.`,
+        },
+    };
+}

package/dist/server.js

@@ -3,6 +3,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 import { ApiError, PROVIDERS, providerKeysFromEnv } from "./api.js";
 import { suggestPrompts } from "./suggest.js";
+import { compactReport } from "./report.js";
 export const SERVER_NAME = "recomention";
 /**
  * package.json's version, read at startup: one number for npm, the MCP handshake and the
@@ -91,11 +92,12 @@ export function createServer(api, env = process.env) {
     }, ({ slug }) => run(() => api.status(slug)));
     server.registerTool("recomention_report_get", {
         title: "Get a report",
-        description: "A report as JSON: the overall score, each engine's runs mentioned of runs total, competitors named instead, cited sources, the fix list and every question with every answer. " +
+        description: "A report as JSON: the overall score, each engine's runs mentioned of runs total, competitors named instead, cited sources, the fix list and, per question, how many usable answers named the product. " +
+            "Answer texts are left out to fit your context: pass question (its order, from 0) to read that question's answers and citations. " +
             "Engines in enginesSkipped did not run; never describe them as not mentioning the product. simulated: true means test data. Free.",
-        inputSchema: { slug },
+        inputSchema: { slug, question: z.number().int().min(0).max(200).optional().describe("A question's order number, to read its answers.") },
         annotations: { readOnlyHint: true, openWorldHint: true },
-    }, ({ slug }) => run(() => api.report(slug)));
+    }, ({ slug, question }) => run(async () => compactReport((await api.report(slug)), question)));
     server.registerTool("recomention_distribution_kit", {
         title: "Get the distribution kit",
         description: "Markdown files built from a finished report, for planning distribution: product.md, competitors.md, ai-visibility.md, where-to-get-mentioned.md (third-party pages, subreddits and videos the engines cite for a rival and not for this product) and channel-plan.md (channels ranked by those citations, each with a first task). " +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@recomention/mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "MCP server for recomention: ask whether AI engines recommend a product, from Claude Code, Cursor or Codex.",
   "type": "module",
   "license": "MIT",