`lookup`

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

“Ensembl gene info for [ENSG…]” / “look up [Ensembl ID]” / “fetch [ENST…/ENSE…/ENSP…]” — fetch metadata for an Ensembl stable ID (gene / transcript / exon / translation). Returns name, biotype, chromosomal position, strand, description. Pass expand=true to include child features (transcripts of a gene, exons of a transcript). Example: ENSG00000157764 (BRAF).

Parameters

Name	Type	Required	Description
`id`	string	yes	e.g. “ENSG00000157764” (BRAF)
`expand`	boolean	no	Include child features.

Example call

Arguments

{
  "id": "ENSG00000157764"
}

curl

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":{"id":"ENSG00000157764"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('lookup', {
  "id": "ENSG00000157764"
});

More examples

{
  "id": "ENST00000288602",
  "expand": true
}

Response shape

Field	Type	Description
`id`	string	Stable ID
`object_type`	string	Type of object (Gene, Transcript, Exon, Translation)
`species`	string	Species name
`assembly_name`	string	Assembly name
`start`	integer	Start coordinate
`end`	integer	End coordinate
`strand`	integer	Strand (1 or -1)
`seq_region_name`	string	Chromosome or sequence region
`description`	string	Object description
`display_name`	string	Display name
`biotype`	string	Biotype classification
`Transcript`	array	Child transcripts (if expand=true)
`Exon`	array	Child 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.

lookup