lookup_symbol

Pack: ensembl · Endpoint: https://gateway.pipeworx.io/ensembl/mcp

Gene by symbol within a species.

Parameters

NameTypeRequiredDescription
speciesstringyese.g. “human”, “mus_musculus”
symbolstringyes
expandbooleanno

Example call

curl -X POST https://gateway.pipeworx.io/ensembl/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"lookup_symbol","arguments":{}}}'

Response shape

FieldTypeDescription
idstringStable gene ID
object_typestringType of object
speciesstringSpecies name
assembly_namestringAssembly name
startintegerStart coordinate
endintegerEnd coordinate
strandintegerStrand
seq_region_namestringChromosome
display_namestringDisplay name
biotypestringBiotype
descriptionstringGene description
TranscriptarrayTranscripts (if expand=true)
Full JSON Schema
{
  "type": "object",
  "description": "Gene lookup by symbol result",
  "properties": {
    "id": {
      "type": "string",
      "description": "Stable gene ID"
    },
    "object_type": {
      "type": "string",
      "description": "Type of object"
    },
    "species": {
      "type": "string",
      "description": "Species name"
    },
    "assembly_name": {
      "type": "string",
      "description": "Assembly name"
    },
    "start": {
      "type": "integer",
      "description": "Start coordinate"
    },
    "end": {
      "type": "integer",
      "description": "End coordinate"
    },
    "strand": {
      "type": "integer",
      "description": "Strand"
    },
    "seq_region_name": {
      "type": "string",
      "description": "Chromosome"
    },
    "display_name": {
      "type": "string",
      "description": "Display name"
    },
    "biotype": {
      "type": "string",
      "description": "Biotype"
    },
    "description": {
      "type": "string",
      "description": "Gene description"
    },
    "Transcript": {
      "type": "array",
      "description": "Transcripts (if expand=true)",
      "items": {
        "type": "object"
      }
    }
  }
}

Connect

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

{
  "mcpServers": {
    "ensembl": {
      "url": "https://gateway.pipeworx.io/ensembl/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build May 21, 2026