Agr Js MCP Server

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

Local serverstdioGo

What is the Agr Js MCP server?

Agr Js MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. MCP server for Alliance of Genome Resources - access genomics data across model organisms.

Setting it up

Installation goes through your MCP client rather than a global install: point it at agr-mcp-server on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

What the assistant can call

Once Agr Js is connected, these are the calls the assistant has available:

  • 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
  • mine_search — Search AllianceMine for genes, proteins, diseases

Configuration and credentials

You will need one environment variable: ALLIANCEMINE_TOKEN. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Agr Js.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the agr js mcp server does with a few real requests.

Choosing this one

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Agr Js's toolset — search_genes, get_gene_info, get_gene_diseases and 11 more — is a fair guide to whether it matches your workflow. It is maintained by nuin; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Agr Js's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Available tools

ToolWhat it does
search_genesSearch genes with optional species filter
get_gene_infoDetailed gene information (symbol, location, synonyms)
get_gene_diseasesDisease associations for a gene
search_diseasesSearch diseases by name
get_gene_expressionExpression data across tissues/stages
find_orthologsCross-species homologs
get_gene_phenotypesPhenotype annotations
get_gene_interactionsMolecular and genetic interactions
get_gene_allelesAlleles/variants for a gene
search_allelesSearch alleles by name
get_species_listList supported model organisms
mine_searchSearch AllianceMine for genes, proteins, diseases
mine_queryRun raw PathQuery XML queries
mine_query_builderBuild queries using JSON DSL

How to install the Agr Js MCP server

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

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
ALLIANCEMINE_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • Use Agr Js to search genes.
  • Use Agr Js to get gene info.
  • Use Agr Js to get gene diseases.

Frequently asked questions

It connects Agr Js to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (search_genes, get_gene_info, get_gene_diseases, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Agr Js directly.