NCBI Gene Record Field by Gene ID (TogoWS)

togows/gene-field

One field of the NCBI Gene record for one or more Entrez gene ids, through DBCLS TogoWS: for example the summary, the official gene reference (symbol, description, map location), chromosome and location, aliases, organism, lineage, links to other databases, RefSeq records, or the Gene Ontology function, process and component annotations. One field per call keeps the answer small. An unknown id returns an empty entry.

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 $0.50.

Data source

DBCLS TogoWS

Records from NCBI Gene and NCBI RefSeq, served through TogoWS (togows.dbcls.jp) of the Database Center for Life Science (DBCLS). Served by Eden Engine; not an official DBCLS or NCBI 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.

Install it Create an account

agent

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

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

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

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "togows/gene-field", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "togows/gene-field", 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.

Charge	Price
Per call	$0.0026

Updated: Oct 21, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "gene_ids",
    "field"
  ],
  "properties": {
    "field": {
      "enum": [
        "geneid",
        "status",
        "create_date",
        "update_date",
        "genetype",
        "source",
        "gene_source",
        "gene_ref",
        "prot_ref",
        "summary",
        "prefered_symbol",
        "descriptive_name",
        "prefered_names",
        "refseq_state",
        "species",
        "organism",
        "lineage",
        "also_known_as",
        "primary_source",
        "see_related",
        "chromosome",
        "location",
        "additional_link",
        "refseq",
        "function",
        "process",
        "component",
        "marker"
      ],
      "type": "string",
      "description": "Which part of the record to return. summary is the prose summary; gene_ref holds the symbol, description and map location; function, process and component are Gene Ontology annotations; refseq lists the linked RefSeq records."
    },
    "gene_ids": {
      "type": "string",
      "pattern": "^[0-9]{1,9}(,[0-9]{1,9}){0,4}$",
      "description": "One Entrez gene id, or up to five separated by commas (7157 or 7157,672). Digits only."
    }
  },
  "description": "Which gene or genes, and which part of the record.",
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "required": [
    "results"
  ],
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "description": "The requested field of one gene's record: its shape depends on `field` (a string, a list, or an object)."
      },
      "description": "One entry per gene id asked, in the order asked. The shape of each entry depends on the requested field."
    }
  },
  "description": "The requested field for each gene id, in the order asked; the entry is an empty list for an id that does not exist.",
  "additionalProperties": false
}