# phi-longevity-prism [Health: Active]

**Category:** 🧬 Biology & Bioinformatics  
**Repository:** https://github.com/Philongevity/phi-mcp-server  
**GitHub Stars:** 0  
**npm Downloads (last month):** 1541  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/phi-longevity-prism-2

## Description
Analyze biomarker panels with an MD-led clinical engine. Guideline-cited. Synthetic data only.

## Tools
Capabilities this server exposes over MCP:

- **analyze_biomarkers** — Analyze a SYNTHETIC biomarker panel with Phi Longevity's PRISM engine. Returns 3-tier, evidence-cited recommendations (THIS WEEK / CONSIDER / ASK YOUR CLINICIAN). For research/education with SYNTHETIC or de-identified data only. Do NOT submit protected health information (PHI). This endpoint is stateless and does not store inputs.
- **list_supported_biomarkers** — List the biomarkers PRISM scores, with units and reference ranges, grouped by clinical pillar. Reference data only — no patient data.
- **get_methodology** — Summarize how the Phi Score works (5 clinical pillars + weights) and link to the full methodology.
- **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. For research/education with SYNTHETIC or de-identified data only. Do NOT submit protected health information (PHI). This endpoint is stateless and does not store inputs.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "phi-longevity-prism": {
    "command": "npx",
    "args": ["-y","@phi-longevity/mcp-server"],
    "env": {
      "PHI_MCP_KEY": "",
      "PHI_ENGINE_URL": ""
    }
  }
}
```

**Requires environment variables:** `PHI_MCP_KEY`, `PHI_ENGINE_URL` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## 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:

```bash
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.

_Full upstream README: https://allmcps.com/mcp/phi-longevity-prism-2/readme_

