Phi Longevity Prism

What phi-longevity-prism does

phi-longevity-prism gives MCP-compatible agents access to Phi Longevity's PRISM engine for interpreting synthetic or de-identified laboratory values. The engine organizes findings through five clinical pillars and can apply a condition focus such as type 2 diabetes, lupus, cancer survivorship, or general wellness.

The main analysis response uses three action tiers: items to address this week, topics to consider, and questions to ask a clinician. Recommendations include guideline citations. The server is intended for research and educational use at the protocol boundary, not for submitting protected health information.

How it works

The npm package runs as a local stdio MCP server. An agent sends biomarker values to the analysis tool, or uses the local quick check for a rapid comparison against PRISM's longevity-oriented reference ranges. The quick check is stateless and avoids an engine round trip. Reference and methodology tools provide context for interpreting the available scores.

A separate hosted endpoint at https://philongevity.com/mcp supports Streamable HTTP. It exposes the package tools plus remote-only workflows. The sample report requires no input and demonstrates the report format. Remote care-gap and appointment-preparation tools use condition, medication-class, and test-status selections rather than lab values or health records.

Setup and configuration

The zero-install option uses the hosted Streamable HTTP endpoint in an MCP client that supports that transport. For local stdio use, configure the client to run npx -y @phi-longevity/mcp-server.

The package can also be built and started locally with:

npm install && npm run build
node dist/index.js

No environment variable is required for the standard setup. PHI_MCP_KEY overrides the built-in published access key, while PHI_ENGINE_URL can replace the default Phi MCP gateway URL. Access is rate-limited, and the package's built-in key can be replaced with a dedicated key.

Tools and capabilities

The npm stdio surface includes:

• quick_check: Quickly flags selected biomarker values against PRISM reference ranges.
• analyze_biomarkers: Produces tiered, guideline-cited recommendations from a synthetic panel and condition focus.
• list_supported_biomarkers: Lists 51 scored biomarkers, their units, reference ranges, and clinical pillars.
• get_methodology: Describes the five Phi Score pillars, their weights, and the full methodology link.

The hosted endpoint also provides sample_prism_report, check_care_gaps, start_job, get_job_result, how_to_get_started_for_my_owner, and full_prism_report. The care-gap tool returns prioritized routine checks and clinician questions. start_job prepares an appointment checklist for a selected clinician, while get_job_result retrieves it by job reference. full_prism_report is a paid remote tool priced per call through x402.

Limitations and notes

Submit only synthetic or de-identified values to the public MCP boundary. The npm package does not store inputs and emits aggregate telemetry such as counts and timing to stderr without values or recommendation text. The package does not access user accounts, Firestore, or the HIPAA datastore.

The local package exposes four tools; the hosted endpoint exposes ten. A full report for an individual belongs in the authenticated Phi Longevity application rather than this public synthetic-data interface. PRISM output is intended to support research, education, and conversations with clinicians, not replace clinical care.