Skip to main content
Glama
QuentinCody

allele-registry-mcp-server

by QuentinCody
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

allele-registry-mcp-server

MCP server wrapping the ClinGen Allele Registry (https://reg.clinicalgenome.org) — canonical allele identity for genetic variants. Resolves any HGVS / dbSNP / ClinVar / gnomAD reference to a stable ClinGen Allele Registry ID (CA#) and its cross-references, so a variant keeps one identity across genome builds and transcript versions.

Cloudflare Worker built on McpAgent (agents/mcp), REST + Code Mode via @bio-mcp/shared. Read endpoints only; no auth. Dev port 8905.

Why it exists

tmVar3's ~550 GB of chromosome-sharded SQLite exists to turn an HGVS string into a canonical allele. The Allele Registry does the same thing over a free public REST API — so we wrap the API instead of re-hosting the index. Every allele_registry_execute result carries a verifiable _meta.citation, and a CA# is a content-addressed allele identifier that drops straight into the fleet's attestation story.

Related MCP server: clingen-link

Tools (Code Mode)

  • allele_registry_search — discover endpoints in the curated catalog

  • allele_registry_execute — run JS against the API in a V8 isolate (api.get/api.post, searchSpec, no network/keys); results carry _meta.citation

  • allele_registry_get_schema / allele_registry_query_data — inspect + SQL-query staged results

Develop

./scripts/dev-servers.sh allele-registry   # wrangler dev on :8905
pnpm --filter allele-registry-mcp-server run test

Upstream

  • Base: https://reg.clinicalgenome.org — GET /allele?hgvs=…, GET /allele/{CAid}, resolution by dbSNP / ClinVar / gnomAD / MyVariantInfo.

  • Source descriptor: ClinGen Allele Registry (ClinGen / NIH, freely available).

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessUnresponsive

Resources

Related MCP Connectors

Related MCP Servers

  • OpenCRAVAT by KarchinLab

    OpenCRAVATofficial

    KarchinLab
    F
    license
    Not graded
    quality
    C
    maintenance
    Annotate variants by with a deep and rich set of data. Can annotate: genetic change, rsID, CAid, HGVS (g./c./p.), protein change.
    5
    -

  • clingen-link

    berntpopp
    A
    license
    Not graded
    quality
    A
    maintenance
    Enables querying ClinGen curated evidence for gene-disease validity, dosage, actionability, and variant pathogenicity via MCP tools.
    MIT

  • Folklore Clinical Variant

    helena-bioinformatics
    A
    license
    Not graded
    quality
    B
    maintenance
    Bioinformatics MCP for genomic variant interpretation, gene-disease evidence and literature. Folklore 1.5.0 adds read-only ClinGen gene-to-disease and disease-to-gene lookups alongside GRCh38 germline variant interpretation and biomedical literature. Seven tools; public information only; qualified professional review required.
    1
    Apache 2.0

  • civic

    pipeworx-io
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables searching cancer genes and curated variants from CIViC, retrieving associated diseases, therapies, and graded evidence items and assertions for clinical interpretation.
    301 npm
    MIT