For AI Agents

The PhaseFolio MCP Server

PhaseFolio exposes a Model Context Protocol server, so any MCP-compatible client — Claude Code, Codex, Cursor, Claude Desktop, or your own agent — can call the same engine outputs, methodology, evidence, and signed-export verification your analysts use. Eleven read-only tools; three are public and need no authentication.

Endpointhttps://app.phasefolio.com/api/mcp

HTTP transport · read-only · bearer-token auth for org-scoped tools.

Connect

Add It to Your Client

One command for HTTP-native clients; an npm stdio bridge for everything else. Copy, paste, and the public tools are live in your session immediately.

Claude Code

HTTP-native, one CLI command

claude mcp add --scope user --transport http phasefolio https://app.phasefolio.com/api/mcp

Codex CLI

OpenAI Codex; HTTP-native

codex mcp add phasefolio --http https://app.phasefolio.com/api/mcp

Claude Desktop / Cursor

Stdio bridge via the npm wrapper

npx -y @phasefolio/mcp

Add to claude_desktop_config.json (or your client’s MCP config) under mcpServers.phasefolio with command "npx" and args ["-y", "@phasefolio/mcp"].

Reference

Eleven Read-Only Tools

Every tool is read-only and returns a structured payload. The three public tools work with no credentials; the rest return your own workspace data once a bearer token is attached.

Public · no authentication

query_benchmarksAnonymized network benchmarks — PoS, cost, and duration distributions by indication × modality. The headline tier is open; granular, biomarker-stratified slices unlock with a token.

verify_exportConfirm a signed dossier is authentic by its content hash. Returns valid / tampered / unknown, the issued timestamp, and the methodology version.

get_methodologyFull text of any methodology section, with a citation-stable URL and a version identifier you can reference directly in analysis output.

Org-scoped · bearer token

get_projectA project's clinical context: indication, sub-indication, modality, biomarker, and stage at entry.

list_scenariosEvery scenario in a project, with its top-line eNPV and rNPV.

get_scenarioA scenario’s full inputs and computed outputs — the authoritative engine payload every signed export ties back to.

get_evidenceThe evidence-register entries — citations and sources — backing a scenario’s assumptions.

get_dossierMachine-readable IC dossier: verdict, drivers, assumptions, evidence summary, and signed-export hashes.

query_landscapeAsset-anchored competitive landscape from CT.gov, FDA, and PhaseFolio’s curated enrichment.

query_drug_riskHuman-reviewed drug-specific clinical-risk signals, with provenance and extractor versions.

query_sec_deal_termsSEC EDGAR deal-term comparables, with source quotes and accession URLs for verification.

Access

Authentication

Public tier

query_benchmarks, verify_export, and get_methodology need no credentials. Benchmarks return a lagged, low-granularity headline tier without a token.

Bearer tier

Org-scoped tools return only your workspace data, enforced under row-level security. Attach a PhaseFolio bearer token in the Authorization header. Request access.

Discovery

Endpoints & Discovery

The server is self-describing. Point an agent at the discovery manifest, or verify signed exports against the public key.

MCP endpoint: /api/mcp
Discovery manifest: /.well-known/mcp.json
Signing public key: /.well-known/phasefolio-pubkey.pem
npm stdio wrapper: @phasefolio/mcp

Listed in

npm Official MCP Registry