Skip to main content
Glama
Lucas-Servi

kegg-mcp-server

by Lucas-Servi

get_brite_info

Read-onlyIdempotent

Retrieve the structural summary of a KEGG BRITE functional hierarchy, including line counts, leaf column names, and top-level labels. Use optional full detail to access truncated raw hierarchy text for deeper analysis.

Instructions

Get the structure of a KEGG BRITE functional hierarchy.

BRITE entries are large A/B/C/D trees, not flat-file entries, so the result is a bounded summary: the level line counts, the leaf column names, and the labels of the top two levels.

Args: brite_id: KEGG BRITE hierarchy ID. Any form KEGG hands out works — 'br:ko00001' (canonical), 'ko00001' / 'br08303' (as listed by list_databases), or the bare '00001' / '08303' returned by search_brite. detail_level: 'summary' (default) or 'full' (adds raw_content, the raw hierarchy text — TRUNCATED, since the largest hierarchies are several megabytes).

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
brite_idYes
detail_levelNosummary

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. Changed4 schema fields changedv0.4.0
    • addedOutput schema / $defs / BriteHierarchy
      Added value: +{
      +  "description": "Bounded projection of a KEGG BRITE ``A``/``B``/``C``/… tree.\n\nBRITE entries are hierarchies, not flat-file entries: ``/get/br:ko00001`` is\n4.3 MB / 65,337 lines and ``/get/br:hsa00001`` is 6.8 MB. Returning the raw\ntext would overflow the context window of the model this feeds, so the\ndefault projection keeps the navigational skeleton (per-level line counts +\nthe top two levels' labels) and drops the leaves. ``raw_content`` is\npopulated only for ``detail_level=\"full\"``, and is itself capped.",
      +  "properties": {
      +    "columns": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "title": "Columns",
      +      "type": "array"
      +    },
      +    "deepest_level": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "default": null,
      +      "title": "Deepest Level"
      +    },
      +    "detail_level": {
      +      "default": "summary",
      +      "title": "Detail Level",
      +      "type": "string"
      +    },
      +    "entry": {
      +      "title": "Entry",
      +      "type": "string"
      +    },
      +    "labels": {
      +      "additionalProperties": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "title": "Labels",
      +      "type": "object"
      +    },
      +    "labels_truncated": {
      +      "items": {
      +        "type": "string"
      +      },
      +      "title": "Labels Truncated",
      +      "type": "array"
      +    },
      +    "last_updated": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "default": null,
      +      "title": "Last Updated"
      +    },
      +    "level_counts": {
      +      "additionalProperties": {
      +        "type": "integer"
      +      },
      +      "title": "Level Counts",
      +      "type": "object"
      +    },
      +    "raw_content": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "default": null,
      +      "title": "Raw Content"
      +    },
      +    "raw_truncated": {
      +      "default": false,
      +      "title": "Raw Truncated",
      +      "type": "boolean"
      +    },
      +    "total_lines": {
      +      "default": 0,
      +      "title": "Total Lines",
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "entry"
      +  ],
      +  "title": "BriteHierarchy",
      +  "type": "object"
      +}
    • removedOutput schema / $defs / BriteInfo
      Removed value: -{
      -  "properties": {
      -    "dblinks": {
      -      "anyOf": [
      -        {
      -          "additionalProperties": {
      -            "items": {
      -              "type": "string"
      -            },
      -            "type": "array"
      -          },
      -          "type": "object"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ],
      -      "default": null,
      -      "title": "Dblinks"
      -    },
      -    "definition": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ],
      -      "default": null,
      -      "title": "Definition"
      -    },
      -    "entry": {
      -      "title": "Entry",
      -      "type": "string"
      -    },
      -    "name": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "items": {
      -            "type": "string"
      -          },
      -          "type": "array"
      -        }
      -      ],
      -      "title": "Name"
      -    },
      -    "raw_content": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ],
      -      "default": null,
      -      "title": "Raw Content"
      -    }
      -  },
      -  "required": [
      -    "entry",
      -    "name"
      -  ],
      -  "title": "BriteInfo",
      -  "type": "object"
      -}
    • removedOutput schema / $defs / EntrySummary
      Removed value: -{
      -  "description": "Compact projection of a KEGG flat-file entry.\n\nReturned from `get_*_info` tools when `detail_level=\"summary\"` (the default) to\nkeep response size small. Counts replace long linked-entity lists; long text\nblocks (sequences, comments, raw content) and per-entry xref/reference dumps\nare omitted. Request `detail_level=\"full\"` for the complete entry.",
      -  "properties": {
      -    "cls": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ],
      -      "default": null,
      -      "title": "Cls"
      -    },
      -    "counts": {
      -      "additionalProperties": {
      -        "type": "integer"
      -      },
      -      "title": "Counts",
      -      "type": "object"
      -    },
      -    "dblinks_sample": {
      -      "additionalProperties": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "title": "Dblinks Sample",
      -      "type": "object"
      -    },
      -    "definition": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ],
      -      "default": null,
      -      "title": "Definition"
      -    },
      -    "description": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ],
      -      "default": null,
      -      "title": "Description"
      -    },
      -    "detail_level": {
      -      "default": "summary",
      -      "title": "Detail Level",
      -      "type": "string"
      -    },
      -    "entry": {
      -      "title": "Entry",
      -      "type": "string"
      -    },
      -    "entry_type": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ],
      -      "default": null,
      -      "title": "Entry Type"
      -    },
      -    "equation": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ],
      -      "default": null,
      -      "title": "Equation"
      -    },
      -    "exact_mass": {
      -      "anyOf": [
      -        {
      -          "type": "number"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ],
      -      "default": null,
      -      "title": "Exact Mass"
      -    },
      -    "formula": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ],
      -      "default": null,
      -      "title": "Formula"
      -    },
      -    "mol_weight": {
      -      "anyOf": [
      -        {
      -          "type": "number"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ],
      -      "default": null,
      -      "title": "Mol Weight"
      -    },
      -    "name": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "items": {
      -            "type": "string"
      -          },
      -          "type": "array"
      -        }
      -      ],
      -      "default": "",
      -      "title": "Name"
      -    },
      -    "organism": {
      -      "anyOf": [
      -        {
      -          "type": "string"
      -        },
      -        {
      -          "type": "null"
      -        }
      -      ],
      -      "default": null,
      -      "title": "Organism"
      -    }
      -  },
      -  "required": [
      -    "entry"
      -  ],
      -  "title": "EntrySummary",
      -  "type": "object"
      -}
    • changedOutput schema / properties / result / anyOf
      Previous value: -[
      -  {
      -    "$ref": "#/$defs/BriteInfo"
      -  },
      -  {
      -    "$ref": "#/$defs/EntrySummary"
      -  },
      -  {
      -    "$ref": "#/$defs/ErrorResult"
      -  }
      -]New value: +[
      +  {
      +    "$ref": "#/$defs/BriteHierarchy"
      +  },
      +  {
      +    "$ref": "#/$defs/ErrorResult"
      +  }
      +]
  2. First observedv0.1.0

TDQS

A4.8/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond annotations, describes output as a bounded summary, warns about truncation for full detail, and explains the difference between summary and full.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Well-structured, each sentence provides necessary context, no redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Covers key aspects: purpose, input, output behavior, and limitations. Sufficient for a tool of this complexity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Adds meaning for brite_id formats and detail_level semantics, including default and truncation.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Clear verb 'get' with specific resource 'KEGG BRITE functional hierarchy', distinguishes from other get_* siblings.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Implicitly indicates usage by explaining input requirements (brite_id) and mention of search_brite returning IDs, but lacks explicit comparison to alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Lucas-Servi/kegg-mcp-server-python'

If you have feedback or need assistance with the MCP directory API, please join our Discord server