just-prs-mcp

Compute evidence-aware polygenic risk scores from local VCF files via a pinned just-prs MCP server.

1.1k|257|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/ClawBio/ClawBio --skill just-prs-mcp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: just-prs-mcp
Source: https://github.com/ClawBio/ClawBio/tree/main/skills/just-prs-mcp
Command: npx skills add https://github.com/ClawBio/ClawBio --skill just-prs-mcp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires fastmcp, typer.

What problem does it solve?

Computing polygenic risk scores from a personal VCF or WGS file normally requires manually finding PGS Catalog models, normalizing data, running scores, checking variant coverage, and interpreting percentiles against the right ancestry panel. This Skill automates that entire workflow through a validated, version-pinned local just-prs MCP server while keeping the genome file on the user's machine.

Core Features & Use Cases

  • VCF/WGS PRS scoring: Score a single PGS Catalog ID or a curated set of models for a trait (by term or EFO/MONDO ontology ID) from a local VCF, VCF.GZ, or VCF.BGZ file.
  • Honest interpretation: Reports preserve weight-mass coverage (C_wt), percentile reliability verdicts, reference-panel ancestry, quality labels, failed models, and filtering provenance instead of hiding uncertainty.
  • Absolute risk with guardrails: Absolute risk is requested only for reliable percentiles and is withheld on genome-build mismatch; EUR-default ancestry assumptions trigger visible warnings.
  • Use Case: A user with a GRCh38 WGS VCF asks for a type 2 diabetes polygenic risk report; the Skill resolves the trait, scores curated PGS models, compares reliable-model percentile spread, and writes report.md, result.json, scores.csv, and reproducibility files.

Quick Start

Ask the agent to compute an evidence-aware PRS report for type 2 diabetes from your local VCF file using the EUR reference panel, or run the offline demo with "clawbio run just-prs --demo".

Frequently Asked Questions about just-prs-mcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I compute a polygenic risk score from a VCF file?

Provide a local single-sample VCF (or VCF.GZ/BGZ) plus one selector: a trait term, an EFO/MONDO trait ID, or a PGS Catalog ID. The bridge launches a pinned just-prs-mcp server over local stdio, scores the models, and writes a report with percentiles, coverage, and quality labels.

What is the difference between just-prs-mcp and gwas-prs for PRS scoring?

just-prs-mcp accepts already-called VCF or WGS files, while gwas-prs handles 23andMe or AncestryDNA text exports. If your input is raw FASTQ or BAM, run variant calling with wgs-prs first before using this skill.

Does PRS computation upload my genome to a remote server?

No upload is performed by the bridge. The VCF stays on your machine and only its resolved local path is passed to a local stdio child process; live runs fetch only public PGS Catalog metadata, scoring files, and reference distributions, and the offline demo makes no network calls.

Why is absolute risk missing from my PRS report?

Absolute risk is computed only when the percentile is marked reliable and upstream prevalence or effect-size evidence exists. It is also withheld when a genome-build mismatch is detected, because the underlying score is not interpretable across assemblies.

What does the EUR default warning mean for PRS percentiles?

When --superpopulation is omitted, percentiles default to the EUR 1000 Genomes reference panel and a warning is emitted. Pass AFR, AMR, EAS, EUR, SAS, or AUTO explicitly so percentiles match the appropriate reference ancestry.

Why did my trait search fail with an ambiguity error?

A free-text trait term can match multiple PGS Catalog ontology records, and the bridge refuses to guess. Re-run with --trait-id using one of the listed EFO or MONDO identifiers to get a deterministic result.