lookup

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

Lookup by stable id (gene/transcript/exon/translation).

Parameters

NameTypeRequiredDescription
idstringyese.g. “ENSG00000157764” (BRAF)
expandbooleannoInclude child features.

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","arguments":{}}}'

Response shape

FieldTypeDescription
idstringStable ID
object_typestringType of object (Gene, Transcript, Exon, Translation)
speciesstringSpecies name
assembly_namestringAssembly name
startintegerStart coordinate
endintegerEnd coordinate
strandintegerStrand (1 or -1)
seq_region_namestringChromosome or sequence region
descriptionstringObject description
display_namestringDisplay name
biotypestringBiotype classification
TranscriptarrayChild transcripts (if expand=true)
ExonarrayChild exons (if expand=true)
Full JSON Schema
{
  "type": "object",
  "description": "Stable ID lookup result (gene/transcript/exon/translation)",
  "properties": {
    "id": {
      "type": "string",
      "description": "Stable ID"
    },
    "object_type": {
      "type": "string",
      "description": "Type of object (Gene, Transcript, Exon, Translation)"
    },
    "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 (1 or -1)"
    },
    "seq_region_name": {
      "type": "string",
      "description": "Chromosome or sequence region"
    },
    "description": {
      "type": "string",
      "description": "Object description"
    },
    "display_name": {
      "type": "string",
      "description": "Display name"
    },
    "biotype": {
      "type": "string",
      "description": "Biotype classification"
    },
    "Transcript": {
      "type": "array",
      "description": "Child transcripts (if expand=true)",
      "items": {
        "type": "object"
      }
    },
    "Exon": {
      "type": "array",
      "description": "Child exons (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