query_many

Pack: mygene-info · Endpoint: https://gateway.pipeworx.io/mygene-info/mcp

Batch-resolve a list of gene symbols, Entrez IDs, or Ensembl IDs (up to 1000) via a single POST to mygene.info, searching across specified scopes (default: symbol) and returning annotations for each matched gene.

Parameters

NameTypeRequiredDescription
idsarrayyes
itemsstringno
scopesstringnoComma-sep fields to search in (default symbol).
speciesstringno
fieldsstringno

Example call

Arguments

{
  "ids": [
    "BRCA1",
    "TP53",
    "EGFR"
  ]
}

curl

curl -X POST https://gateway.pipeworx.io/mygene-info/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"query_many","arguments":{"ids":["BRCA1","TP53","EGFR"]}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('query_many', {
  "ids": [
    "BRCA1",
    "TP53",
    "EGFR"
  ]
});

More examples

{
  "ids": [
    "1017",
    "7157"
  ],
  "scopes": "entrezgene",
  "species": "9606"
}

Response shape

Always returns: items, count

FieldTypeDescription
itemsarrayArray of batch lookup results
countintegerNumber of items returned.
Full JSON Schema
{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "description": "Array of batch lookup results",
      "items": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "Input query string"
          },
          "_id": {
            "type": "string",
            "description": "Gene ID"
          },
          "found": {
            "type": "boolean",
            "description": "Whether a match was found"
          },
          "_score": {
            "type": "number",
            "description": "Match score"
          },
          "symbol": {
            "type": "string",
            "description": "Gene symbol"
          },
          "name": {
            "type": "string",
            "description": "Gene name"
          }
        }
      }
    },
    "count": {
      "type": "integer",
      "description": "Number of items returned."
    }
  },
  "required": [
    "items",
    "count"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "mygene-info": {
      "url": "https://gateway.pipeworx.io/mygene-info/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build July 6, 2026