gnomAD MCP Server logo

gnomAD MCP Server

by koido

This MCP server provides a programmatic interface to the Genome Aggregation Database (gnomAD) API, supporting multiple API versions. It abstracts version-specific field and schema differences, exposing a unified API for downstream tools and users.

View on GitHub

Last updated: N/A

What is gnomAD MCP Server?

The gnomAD MCP Server is a programmatic interface to the gnomAD API, providing a unified API for accessing different gnomAD versions (v2.1.1, v3.1.2, v4.1.0). It abstracts away version-specific differences, allowing users and tools to interact with gnomAD data more easily.

How to use gnomAD MCP Server?

To use the server, install the dependencies, activate the virtual environment, and test the server. Then, add the MCP server to your MCP server list with the provided configuration. The server exposes endpoints documented with detailed parameter and output descriptions.

Key features of gnomAD MCP Server

  • Supports multiple gnomAD API versions (v2.1.1, v3.1.2, v4.1.0)

  • Provides a unified API, abstracting version-specific differences

  • Uses QueryTemplateEngine pattern to manage version-specific GraphQL queries

  • Offers various queries for retrieving gene, region, and variant information

  • Includes liftover mapping for variants between genomes

Use cases of gnomAD MCP Server

  • Retrieving gene metadata and constraint metrics

  • Retrieving variant and summary information for a genomic region

  • Retrieving variant metadata and population frequency data

  • Retrieving ClinVar variant data and clinical significance

  • Searching for genes and variants

FAQ from gnomAD MCP Server

What gnomAD API versions are supported?

The server supports gnomAD API versions v4.1.0, v3.1.2, and v2.1.1.

What types of queries are supported?

The server supports queries for retrieving gene info, region info, variant info, ClinVar variant info, mitochondrial variant info, structural variant info, copy number variant info, STR info, and metadata. It also supports searching for genes and variants.

What are the dependencies for running the server?

The server requires Python >= 3.13 and several Python packages, including aiohttp, fastmcp, gql, httpx, mcp[cli], nest-asyncio, pytest, and pytest-asyncio.

How do I add the server to my MCP server list?

You can add the server to your MCP server list by adding a configuration like the one provided in the README, specifying the command, arguments, and environment variables.

Is the server under active development?

Yes, the project is under active development, and APIs and features may change without notice.