Skip to content
Eden Engine

Gene Lookup by Symbol: Ensembl Gene ID, Coordinates, Canonical Transcript (Ensembl)

ensembl/gene-lookup

Looks up a gene by its symbol (for example BRCA2) in a species and returns the Ensembl gene record: stable gene id (ENSG...), chromosome, start and end coordinates, strand, biotype, canonical transcript, genome assembly and a description. Human by default. An unknown symbol returns a validation error. Ensembl data, passed through unmodified and served by Eden Engine; not an official Ensembl product.

activeper callv1

Price

$0.0026 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.

Data source

Ensembl

Source: Ensembl (EMBL-EBI), https://www.ensembl.org, retrieved through the Ensembl REST API. Served by Eden Engine; not an official Ensembl product.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

Connect once and your AI can find and run this tool, and any other it needs.

agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "ensembl/gene-lookup" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "ensembl/gene-lookup" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "ensembl/gene-lookup", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "ensembl/gene-lookup", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

ChargePrice
Per call
$0.0026
Updated
Oct 20, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "symbol"
  ],
  "properties": {
    "symbol": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,39}$",
      "description": "Gene symbol, for example BRCA2 or TP53."
    },
    "species": {
      "type": "string",
      "default": "homo_sapiens",
      "pattern": "^[a-z][a-z0-9_]{1,59}$",
      "description": "Ensembl species name, lowercase with underscores, for example homo_sapiens or mus_musculus. Defaults to homo_sapiens."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "required": [
    "id",
    "display_name",
    "object_type",
    "species"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Ensembl stable gene id, for example ENSG00000139618."
    },
    "end": {
      "type": "integer",
      "description": "End coordinate on the assembly."
    },
    "start": {
      "type": "integer",
      "description": "Start coordinate on the assembly."
    },
    "source": {
      "type": "string"
    },
    "strand": {
      "type": "integer",
      "description": "1 for the forward strand, -1 for the reverse."
    },
    "biotype": {
      "type": "string",
      "description": "For example protein_coding."
    },
    "db_type": {
      "type": "string"
    },
    "species": {
      "type": "string"
    },
    "version": {
      "type": "integer"
    },
    "logic_name": {
      "type": "string"
    },
    "description": {
      "type": "string",
      "description": "Gene name with its source and accession."
    },
    "object_type": {
      "type": "string",
      "description": "Gene."
    },
    "display_name": {
      "type": "string",
      "description": "The gene symbol."
    },
    "assembly_name": {
      "type": "string",
      "description": "Genome assembly the coordinates are on."
    },
    "seq_region_name": {
      "type": "string",
      "description": "Chromosome or sequence region name."
    },
    "canonical_transcript": {
      "type": "string",
      "description": "Canonical transcript id with version."
    }
  },
  "description": "The Ensembl gene record for the symbol.",
  "additionalProperties": true
}