Skip to main content
Glama

AGR MCP Server

MCP server for querying Alliance of Genome Resources - genomics data across model organisms.

Installation

No installation required. Add to your MCP client config:

{
  "mcpServers": {
    "agr-genomics": {
      "command": "npx",
      "args": ["-y", "agr-mcp-server"]
    }
  }
}

Option 2: Global install

npm install -g agr-mcp-server

Then use in your config:

{
  "mcpServers": {
    "agr-genomics": {
      "command": "agr-mcp-server"
    }
  }
}

Config file locations

Client

Config path

Claude Desktop (macOS)

~/Library/Application Support/Claude/claude_desktop_config.json

Claude Desktop (Windows)

%APPDATA%\Claude\claude_desktop_config.json

Claude Code

~/.claude/settings.json

Cursor

Settings > MCP Servers

Windsurf

~/.codeium/windsurf/mcp_config.json

Related MCP server: gwas-mcp

Usage

Ask questions naturally:

  • "Search for BRCA1 genes in human"

  • "What genes are involved in DNA repair?"

  • "Get information about HGNC:1100"

  • "Find orthologs of insulin gene"

  • "What diseases are associated with TP53?"

  • "Show me expression data for daf-2 in worm"

  • "Find all human genes with kinase activity"

  • "Query AllianceMine for mouse genes on chromosome 11"

Supported Species

Human, mouse, rat, zebrafish, fly, worm, yeast, xenopus

Tools

AGR API Tools

Tool

Description

search_genes

Search genes with optional species filter

get_gene_info

Detailed gene information (symbol, location, synonyms)

get_gene_diseases

Disease associations for a gene

search_diseases

Search diseases by name

get_gene_expression

Expression data across tissues/stages

find_orthologs

Cross-species homologs

get_gene_phenotypes

Phenotype annotations

get_gene_interactions

Molecular and genetic interactions

get_gene_alleles

Alleles/variants for a gene

search_alleles

Search alleles by name

get_species_list

List supported model organisms

AllianceMine Tools

Tool

Description

mine_search

Search AllianceMine for genes, proteins, diseases

mine_query

Run raw PathQuery XML queries

mine_query_builder

Build queries using JSON DSL

mine_natural_query

Natural language query (returns schema for LLM)

mine_list_templates

List available query templates

mine_run_template

Run a pre-built query template

mine_get_lists

Get available gene/protein lists

mine_get_list

Get contents of a specific list

mine_create_list

Create a new list (requires auth)

mine_add_to_list

Add items to a list (requires auth)

mine_delete_list

Delete a list (requires auth)

AllianceMine Query Examples

Using query builder:

Find human genes with BRCA in symbol:
- from: Gene
- select: primaryIdentifier, symbol, name
- where: organism.shortName = "H. sapiens", symbol CONTAINS "BRCA"

Using templates:

Gene_Alleles - Find alleles for a gene
Gene_DOTerm - Disease annotations for a gene
Gene_GOTerms - GO annotations for a gene
GOTerm_Genes - Find genes by GO term

Authentication

List management operations (mine_create_list, mine_add_to_list, mine_delete_list) require an AllianceMine API token:

{
  "mcpServers": {
    "agr-genomics": {
      "command": "npx",
      "args": ["-y", "agr-mcp-server"],
      "env": {
        "ALLIANCEMINE_TOKEN": "your-token-here"
      }
    }
  }
}

Gene ID Formats

Species

Format

Example

Human

HGNC:*

HGNC:1100

Mouse

MGI:*

MGI:95892

Rat

RGD:*

RGD:3889

Zebrafish

ZFIN:ZDB-GENE-*

ZFIN:ZDB-GENE-990415-72

Fly

FB:FBgn*

FB:FBgn0000017

Worm

WB:WBGene*

WB:WBGene00000898

Yeast

SGD:S*

SGD:S000002536

Xenopus

Xenbase:XB-GENE-*

Xenbase:XB-GENE-485905

Data Sources

License

MIT

Available Tools

22 tools
find_orthologsB

Find orthologous genes across species. Returns homologs from all Alliance model organisms.

Inputs: gene_id (required).

get_gene_allelesB

Get alleles/variants associated with a gene.

Inputs: gene_id (required), limit.

get_gene_diseasesA

Get disease associations for a gene, including human disease models and annotations.

Inputs: gene_id (required), limit.

get_gene_expressionC

Get expression data for a gene including tissue/cell type expression and developmental stages.

Inputs: gene_id (required), limit.

get_gene_infoA

Get detailed information about a specific gene including symbol, name, location, species, and cross-references.

Inputs: gene_id (required).

get_gene_interactionsC

Get molecular and genetic interactions for a gene.

Inputs: gene_id (required), limit.

get_gene_phenotypesC

Get phenotype annotations for a gene.

Inputs: gene_id (required), limit.

get_species_listB

Get list of model organisms supported by Alliance of Genome Resources.

Inputs: no named parameters.

mine_add_to_listC

Add items to an existing list. Requires ALLIANCEMINE_TOKEN environment variable.

Inputs: name (required), identifiers (required).

mine_create_listC

Create a new list in AllianceMine. Requires ALLIANCEMINE_TOKEN environment variable.

Inputs: name (required), type (required), identifiers (required), description.

mine_delete_listC

Delete a list from AllianceMine. Requires ALLIANCEMINE_TOKEN environment variable.

Inputs: name (required).

mine_get_listC

Get the contents of a specific list.

Inputs: name (required).

mine_get_listsC

Get all available gene/protein lists in AllianceMine.

Inputs: type.

mine_list_templatesB

List available query templates in AllianceMine. Templates are pre-built queries for common use cases.

Inputs: no named parameters.

mine_natural_queryB

Process a natural language query and return schema information to construct a structured AllianceMine query.

This tool returns the AllianceMine schema so you can convert the user's natural language into a mine_query_builder call.

Inputs: query (required), limit.

mine_queryA

Run a raw PathQuery XML query against AllianceMine. For power users who know InterMine PathQuery syntax.

Inputs: xml (required).

mine_query_builderA

Build and run structured queries against AllianceMine using a JSON DSL.

Example query - find human genes in DNA repair pathway: { "from": "Gene", "select": ["symbol", "name", "organism.name", "pathways.name"], "where": { "organism.name": "Homo sapiens", "pathways.name": { "op": "CONTAINS", "value": "DNA repair" } }, "limit": 50 }

Supported operators: =, !=, CONTAINS, LIKE, <, >, <=, >=, ONE OF, NONE OF, IS NULL, IS NOT NULL

Inputs: from (required), select (required), where, joins, +2 more.

mine_run_templateA

Run a pre-built query template with parameters.

Parameter format: Use numeric keys ("1", "2", etc.) matching constraint positions.

  • Simple: {"1": "BRCA1"} - just the value

  • Full: {"1": {"path": "Gene", "op": "LOOKUP", "value": "BRCA1"}}

Common templates:

  • Gene_Orthologs: Find orthologs (params: {"1": {"path": "Gene", "op": "LOOKUP", "value": "HGNC:1100"}})

  • Gene_GOTerms: GO annotations for a gene

  • Gene_DOTerm: Disease annotations for a gene

  • GOTerm_Genes: Find genes by GO term

Use mine_list_templates to discover all available templates and their constraints.

Inputs: name (required), params (required), limit.

search_allelesC

Search for alleles/variants in the Alliance database.

Inputs: query (required), limit.

search_diseasesC

Search for diseases in the Alliance database.

Inputs: query (required), limit.

search_genesC

Search for genes across all Alliance of Genome Resources model organisms. Supports species filtering.

Inputs: query (required), species, limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 22 tools

    Disambiguation4/5

    Most tools have distinct purposes, but there is some overlap between search_genes and find_orthologs (both involve gene-related queries across species), and between mine_query, mine_query_builder, and mine_natural_query (all for querying AllianceMine, though they differ in input format). The descriptions help clarify these distinctions, but an agent might occasionally misselect between them.

    Naming Consistency4/5

    The naming is mostly consistent with a verb_noun pattern (e.g., get_gene_info, search_genes, mine_create_list), but there are minor deviations like mine_natural_query (which uses 'natural' as an adjective) and the mix of 'get' vs. 'search' prefixes for similar actions. Overall, the pattern is predictable and readable.

    Tool Count3/5

    With 22 tools, the count feels borderline heavy for a genomics server, though it covers both gene data retrieval and AllianceMine operations. It might overwhelm agents with too many options, but the scope is broad enough to justify a larger set, making it reasonable but not ideal.

    Completeness5/5

    The tool set provides comprehensive coverage for the domain of genomic data and AllianceMine interactions. It includes CRUD operations for lists (create, get, delete, add), extensive gene data retrieval (info, expression, diseases, etc.), and multiple query methods (search, templates, natural language, structured), leaving no obvious gaps for agent workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      Provides AI-powered access to major biological databases for GWAS and bioinformatics research. Enables natural language queries for protein, gene, variant, pathway, and drug discovery analysis.
      44
      1
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      Enables AI assistants to query gene annotations, expression, pathways, variants, and more via the MyGene.info API, supporting batch operations and multiple biological data sources.
      26
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables querying of the Monarch Initiative biomedical knowledge graph for genes, diseases, phenotypes, and their associations through natural language or direct tool calls.
      308 npm
      MIT