@phi-longevity/mcp-server 0.6.3 → 0.6.5

package/dist/index.js

@@ -92,6 +92,34 @@ const FULL_REPORT_ATTRIBUTION = {
     data_rule: "Real (identifiable) health files are analyzed only inside the authenticated app by the account owner. " +
         SYNTHETIC_WARNING,
 };
+// AC-2 (2026-08-14): per-call attribution id so an agent tool call can be tied to the owner
+// sign-up it drives. Random, non-PII, emitted in the deep-link (?aid=) and in telemetry.
+function newAid() {
+    return Math.random().toString(36).slice(2, 10);
+}
+function attributionWithAid(aid) {
+    return {
+        ...FULL_REPORT_ATTRIBUTION,
+        get_full_report_url: `https://philongevity.com/signup?utm_source=agent&utm_medium=mcp&utm_campaign=analyze_biomarkers&aid=${aid}`,
+    };
+}
+// AC-3 (2026-08-14): fast, LOCAL, zero-round-trip biomarker range flags — the "easiest first call".
+const _norm = (s) => String(s).toLowerCase().replace(/[^a-z0-9]/g, "");
+const _ALIASES = { hemoglobina1c: "hba1c", a1c: "hba1c", ldl: "ldlc",
+    ldlcholesterol: "ldlc", hdl: "hdlc", hdlcholesterol: "hdlc", crp: "hscrp", hscrp: "hscrp",
+    testosterone: "totaltestosterone", vitd: "vitamind", vitamind3: "vitamind", "25ohvitamind": "vitamind" };
+const CATALOG_INDEX = new Map(BIOMARKER_CATALOG.map((b) => [_norm(b.name), b]));
+function catalogLookup(name) {
+    const n = _norm(name);
+    return CATALOG_INDEX.get(n) || CATALOG_INDEX.get(_ALIASES[n] || "") || null;
+}
+function flagValue(b, value) {
+    if (typeof b.refLow === "number" && value < b.refLow)
+        return "below longevity-optimized range";
+    if (typeof b.refHigh === "number" && value > b.refHigh)
+        return "above longevity-optimized range";
+    return "within longevity-optimized range";
+}
 async function callEngine(body) {
     if (!MCP_KEY) {
         throw new Error("Server not configured: set PHI_MCP_KEY (your @phi-longevity access key).");
@@ -152,14 +180,16 @@ server.tool("analyze_biomarkers", "Analyze a SYNTHETIC biomarker panel with Phi
         const recs = args.include_partner_options
             ? out.recommendations_v2_with_partners ?? out.recommendations_v2
             : out.recommendations_v2;
+        const aid = newAid();
         telemetry({
             tool: "analyze_biomarkers",
             n_biomarkers: Object.keys(args.biomarkers || {}).length,
             conditionFocus: args.conditionFocus ?? "general_wellness",
             issues_count: Array.isArray(out.issues) ? out.issues.length : 0,
+            aid,
             elapsed_ms: Date.now() - t0,
         });
-        return textResult(JSON.stringify({ recommendations: recs, meta: out.meta, issues: out.issues, full_report: FULL_REPORT_ATTRIBUTION }, null, 2));
+        return textResult(JSON.stringify({ recommendations: recs, meta: out.meta, issues: out.issues, full_report: attributionWithAid(aid) }, null, 2));
     }
     catch (e) {
         telemetry({ tool: "analyze_biomarkers", error: e.message, elapsed_ms: Date.now() - t0 });
@@ -186,10 +216,40 @@ server.tool("get_methodology", "Summarize how the Phi Score works (5 clinical pi
         source: "Phi Longevity (philongevity.com)",
     }, null, 2));
 });
+// ── Tool 4: quick_check (fast local range flags — the "easiest first call") ────────────────────
+server.tool("quick_check", "FASTEST first call: instantly flag a few biomarker values against PRISM's longevity-optimized " +
+    "reference ranges (local, no engine round-trip). Ideal for \"what does my <value> mean?\". For tiered, " +
+    "guideline-cited recommendations call analyze_biomarkers; for a full scored report, full_prism_report. " +
+    SYNTHETIC_WARNING, {
+    biomarkers: z
+        .record(z.string(), z.number())
+        .describe('Map of biomarker name -> value, e.g. { "HbA1c": 6.1, "LDL-C": 145 }. SYNTHETIC ONLY.'),
+}, async (args) => {
+    const t0 = Date.now();
+    const aid = newAid();
+    const flags = [];
+    const unmatched = [];
+    for (const [name, value] of Object.entries(args.biomarkers || {})) {
+        const b = catalogLookup(name);
+        if (!b) {
+            unmatched.push(name);
+            continue;
+        }
+        flags.push({ name: b.name, value, unit: b.unit, pillar: b.pillar, status: flagValue(b, value) });
+    }
+    telemetry({ tool: "quick_check", n: Object.keys(args.biomarkers || {}).length, matched: flags.length, aid, elapsed_ms: Date.now() - t0 });
+    return textResult(JSON.stringify({
+        flags,
+        unmatched: unmatched.length ? unmatched : undefined,
+        note: "Quick range flags vs PRISM's longevity-optimized ranges — NOT a diagnosis or the full Phi analysis. " +
+            "For tiered guideline-cited recommendations call analyze_biomarkers; for a scored report call full_prism_report.",
+        full_report: attributionWithAid(aid),
+    }, null, 2));
+});
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    telemetry({ event: "phi-mcp-server started", tools: 3 });
+    telemetry({ event: "phi-mcp-server started", tools: 4 });
 }
 main().catch((e) => {
     telemetry({ event: "fatal", error: e.message });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phi-longevity/mcp-server",
-  "version": "0.6.3",
+  "version": "0.6.5",
   "description": "Model Context Protocol server for Phi Longevity \u2014 agents can call the PRISM longevity recommendation engine on SYNTHETIC biomarker panels. Synthetic/de-identified data only; no PHI; stateless.",
   "license": "Apache-2.0",
   "type": "module",