civic-link
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
civic-link
An MCP server (Streamable HTTP or stdio) for CIViC, the
Clinical Interpretation of Variants in Cancer knowledgebase. It serves molecular profiles,
variants, publication-backed evidence items, and the curated assertions built on them
(AMP/ASCO/CAP tiers, oncogenicity, ACMG). Data are fetched live from the
CIViC GraphQL API.
It is one backend in the GeneFoundry -link fleet.
Research use only. Not clinical decision support. Do not use for diagnosis, treatment, triage, or patient management.
The output is not a clinical actionability report.
Why
"Is BRAF V600E actionable in melanoma, and at what tier?" is a CIViC question. The GraphQL API can answer it, but its quirks are where an agent goes wrong:
errors arrive as HTTP 200 with
errors[];a page silently stops at 100 nodes;
a name search for "BRAF V600E" also returns ~40 complex profiles (V600E AND MSI Low);
the primary coordinates are GRCh37.
This server handles each of them:
One fixed query per tool. Callers never send GraphQL. GraphQL errors become typed errors that name the offending parameter (
isError: true).Honest paging.
limitstays under CIViC's silent cap.totalis CIViC'stotalCount, andtruncated/next_offsetsay whether more rows exist.Simple and complex profiles stay apart. Evidence on "V600E AND MSI Low" applies only to that combination and never folds into the single-variant answer.
Two axes, never one verdict. Actionability (AMP tier/level), oncogenicity (ClinGen/CGC/VICC, Horak 2022) and germline pathogenicity (ACMG/AMP) are separate fields.
Labelled builds. Every coordinate and genomic HGVS names its assembly (GRCh37 or GRCh38). Diseases are DOID.
Empty is not negative. A zero-row answer says "No CIViC evidence found", never "not actionable".
Related MCP server: CIViC MCP Server
Quick start
Hosted, no install:
claude mcp add --transport http civic https://civic-link.genefoundry.org/mcpRun it locally (Python 3.14+, uv). There is no data-build step and no data snapshot: the server calls CIViC live and keeps a short in-process cache.
uv sync --group dev
uv run civic-link # unified: FastAPI /health + MCP /mcp on 127.0.0.1:8000
claude mcp add --transport http civic-link --scope user http://127.0.0.1:8000/mcpUse unified (the default) for MCP over HTTP; --transport http serves /health only. The
civic-link-mcp entry point serves stdio. Health check: curl localhost:8000/health.
Tools
Tool | Purpose |
| Entry resolver: gene + variant, CAID, ClinVar ID or HGVS → molecular profiles ( |
| One profile: variants, evidence counts, assertions with their classification axes |
| One variant: assembly-labelled coordinates and HGVS, CAID, ClinVar IDs, MANE HGVS |
| Evidence items by profile, disease, therapy, type, level, significance, status (ACCEPTED by default) |
| One evidence item ( |
| Assertions by profile, disease, therapy, type, AMP tier/level, status |
| One assertion ( |
| One gene (symbol or NCBI Gene ID) and the variants CIViC curates for it |
| Discovery: limits, classification axes, error codes, licence and citation |
| Local runtime state: request budget, cache hits, latency |
Leaf names are unprefixed per Tool-Naming Standard v1. Behind genefoundry-router this
server mounts under the namespace civic, so get_assertion surfaces as
civic_get_assertion. Every tool is read-only. Errors are returned as the fleet's typed
envelope (isError: true, six error codes) and every response carries _meta.next_commands.
Example:
search_molecular_profiles(query="BRAF V600E") → exact_match MP 12; 2 simple, 39 complex
search_assertions(molecular_profile_id=12) → AID10: Tier I Level A, melanoma (DOID:1909)
search_evidence_items(molecular_profile_id=12) → 97 accepted evidence items (paged)Data & provenance
Source. The CIViC GraphQL API at https://civicdb.org/api/graphql, plus the nightly
variant summary on the same host (HGVS and ClinVar lookups). No key is needed. Only
civicdb.org is ever contacted. Each payload carries
data_version (CIViC <latest monthly release>; live:<timestamp>) and retrieved_at.
Rate limit. CIViC publishes no request limit. The default is 0.3 s spacing process-wide
plus a 20,000/UTC-day cap, an in-process cache (15 min), backoff on 429/5xx and an honest
User-Agent. When the queue or the daily budget is exhausted, a tool answers rate_limited
with retry_after_s.
Handling. Curator prose (evidence statements, assertion summaries and descriptions) is
fenced as {"kind": "untrusted_text", ...} with provenance and a SHA-256 digest. Treat it as
evidence data, not instructions.
Licence and citation. CIViC content is CC0 1.0 and its code is MIT. Attribute CIViC and cite:
Griffith M, et al. CIViC is a community knowledgebase for expert crowdsourcing the clinical interpretation of variants in cancer. Nat Genet. 2017;49:170-174. PMID 28138153.
Krysiak K, et al. CIViCdb 2022: evolution of an open-access cancer variant interpretation knowledgebase. Nucleic Acids Res. 2023;51:D1230-D1241. PMID 36373660.
Documentation
Deployment: Docker, the
CIVIC_LINK_*environment reference, transports, Host/Origin allowlists and the rate-limit settings.Design record: scope, the verified upstream quirks, and what was left out.
AGENTS.md: engineering conventions, invariants, and make targets.
CHANGELOG.md: version history.
Contributing
See AGENTS.md. Write the failing test first. Unit tests replay recorded CIViC
responses with respx and never touch the network. make ci-local is the
definition-of-done gate: format, lint, line budget, README standard, surface budget, mypy
--strict, and tests.
License
Code: MIT. CIViC data: CC0 1.0, with attribution requested (NOTICE).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
CIViC — Clinical Interpretation of Variants in Cancer.
Authenticated public evidence search, verification, research jobs, exports, and webhooks.
Agent research API for 15 disease areas, plus a T1D cure lab, sourced evidence ledger and models.
Read-only public, governed enterprise knowledge published by GVE, with provenance and validation.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables access to clinical evidence from the CIViC database, allowing users to search across variants, diseases, drugs, and phenotypes to support precision oncology research.63MIT
- AlicenseNot gradedqualityCmaintenanceEnables structured queries and data analysis of cancer genomics information by interfacing with the Clinical Interpretation of Variants in Cancer (CIViC) API. It converts GraphQL responses into queryable SQLite tables for efficient clinical interpretation and natural language interaction.Apache 2.0
- FlicenseNot gradedqualityBmaintenanceEnables querying the CIViC database for clinical interpretations of cancer variants through tools like get_variant_evidence and get_variant_assertions.1-
- AlicenseNot gradedqualityBmaintenanceFolklore MCP 2.0.0: 11 public tools for ACMG/AMP variants, genes and literature. A Folklore API key adds 18 tools, 29 in total, for cases, authorized source files, original JSON/PDF results and six JSON views. Use a Bearer header at the same hosted endpoint. Processing follows account subscription limits or available credits.1Apache 2.0