Skip to main content
Glama
Lucas-Servi

kegg-mcp-server

by Lucas-Servi

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
render_pathway_asciiA

Render a KEGG pathway as ASCII text optimized for LLM consumption.

Two styles available:

  • 'chain': Linear reaction flow text showing substrate->enzyme->product chains. Robust and compact. Best for understanding reaction sequences.

  • 'grid': 2D spatial layout using KGML coordinates. Shows the pathway topology with box-and-arrow rendering. Best for seeing spatial relationships.

Args: pathway_id: KEGG pathway ID (e.g. 'hsa00010' for human glycolysis). Must be organism-specific; reference pathways (map*) have limited KGML. style: 'chain' (default, linear text) or 'grid' (2D spatial layout). max_width: Maximum line width in characters (40-200, default 100). max_height: Grid mode only: maximum height in lines (20-80, default 40).

search_briteA

Search KEGG BRITE functional hierarchy databases.

Args: query: Hierarchy name (e.g. 'KEGG pathway', 'transporter', 'ribosome'). max_results: Maximum number of results to return (capped at 100).

get_brite_infoA

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).

search_compoundsA

Search KEGG compounds by name or chemical property.

Args: query: Search term (compound name, formula, or mass). search_type: 'name' (default), 'formula', 'exact_mass', 'mol_weight', or 'nop'. max_results: Maximum number of results to return (capped at 100).

get_compound_infoA

Get detailed information for a KEGG compound entry.

Args: compound_id: KEGG compound ID (e.g. 'C00002' for ATP, 'C00031' for D-Glucose). detail_level: 'summary' (default, compact) or 'full' (complete flat-file parse).

get_compound_reactionsA

Get all reactions involving a KEGG compound.

Args: compound_id: KEGG compound ID (e.g. 'C00002').

batch_entry_lookupA

Fetch multiple KEGG entries in bulk (max 50 IDs).

Automatically chunks requests into groups of 10 to respect KEGG's API limit.

Args: entry_ids: List of KEGG entry IDs (e.g. ['C00002', 'C00031', 'C00033']). Can mix databases. Max 50 entries.

convert_identifiersA

Convert KEGG IDs to/from external database identifiers.

Converts within one kind only, KEGG side <-> outside side: genes (organism code 'hsa' or T-number 'T01001') <-> ncbi-geneid / ncbi-proteinid / uniprot; chemistry (compound / drug / glycan) <-> pubchem / chebi. Cross-kind pairs such as compound<->uniprot are rejected by KEGG, and 'kegg' is not a database conv accepts.

Args: source_db: Source database — 'hsa', 'T01001', 'ncbi-geneid', 'ncbi-proteinid', 'uniprot', 'compound', 'drug', 'glycan', 'pubchem' or 'chebi'. target_db: Target database, from the same list and the opposite side of the pair (e.g. source_db='hsa' + target_db='uniprot', or source_db='chebi' + target_db='compound'). entry_ids: Optional list of specific IDs to convert. Bare ids are prefixed with source_db automatically ('1956' -> 'hsa:1956'). KEGG accepts at most 10 per request; only the first 10 are sent. If None, converts the full source database (large: hsa <-> ncbi-geneid is ~700 KB).

find_related_entriesA

Find related entries in another KEGG database for a given entry.

Args: entry_id: Source KEGG entry ID (e.g. 'hsa:1956', 'C00002', 'K00844'). target_db: Target database (e.g. 'pathway', 'disease', 'drug', 'ko', 'compound', 'reaction', 'module', 'genes').

get_database_infoA

Get release information and statistics for a KEGG database.

Args: database: Database name (e.g. 'kegg', 'pathway', 'compound', 'drug', 'genome').

list_organismsA

List organisms available in KEGG with their 3-4 letter codes and names.

KEGG has ~12,000 organisms, so the full list is large. Pass query to filter by organism code or name (e.g. 'Bacillus', 'hsa') instead of paging through everything.

Args: query: Case-insensitive substring filter on the organism code or name. Empty (the default) returns the first max_results organisms. max_results: Maximum number of organisms to return (capped at 100).

search_diseasesA

Search KEGG diseases by name or keyword.

Args: query: Disease name (e.g. 'diabetes', 'cancer', 'Alzheimer'). max_results: Maximum number of results to return (capped at 100).

get_disease_infoA

Get detailed information for a KEGG disease entry.

Args: disease_id: KEGG disease ID (e.g. 'H00004' for colorectal cancer). detail_level: 'summary' (default, compact) or 'full' (complete flat-file parse).

search_drugsA

Search KEGG drugs by name, formula, or molecular weight.

Args: query: Drug name, formula, or mass value. search_type: 'name' (default), 'formula', 'exact_mass', or 'mol_weight'. max_results: Maximum number of results to return (capped at 100).

get_drug_infoA

Get detailed information for a KEGG drug entry.

Args: drug_id: KEGG drug ID (e.g. 'D00001' for aspirin, 'D00564' for ibuprofen). detail_level: 'summary' (default, compact) or 'full' (complete flat-file parse).

get_drug_interactionsA

Get drug-drug interactions for one or more KEGG drugs.

Args: drug_ids: Single drug ID (e.g. 'D00001') or multiple IDs joined with '+' (e.g. 'D00001+D00564'). Max 10 entries.

search_enzymesA

Search KEGG enzymes by EC number or name.

Args: query: EC number (e.g. '1.1.1.1') or enzyme name (e.g. 'kinase', 'oxidase'). max_results: Maximum number of results to return (capped at 100).

get_enzyme_infoA

Get detailed information for a KEGG enzyme (EC number).

Args: enzyme_id: EC number (e.g. '1.1.1.1') or prefixed ID (e.g. 'ec:1.1.1.1'). detail_level: 'summary' (default, compact) or 'full' (complete flat-file parse).

search_genesA

Search for genes in a KEGG organism database.

Args: query: Search term (gene name, symbol, or description). organism_code: KEGG organism code (e.g. 'hsa' human, 'mmu' mouse, 'eco' E. coli). max_results: Maximum number of results to return (capped at 100).

get_gene_infoA

Get detailed information for a KEGG gene entry.

Args: gene_id: KEGG gene ID in format 'organism:gene' (e.g. 'hsa:1956' for EGFR). detail_level: 'summary' (default, compact) or 'full' (complete parse with linked orthologs, pathways, xrefs, and references). include_sequence: If True and detail_level='full', fetches amino acid and nucleotide sequences.

get_gene_orthologsA

Get KO (KEGG Orthology) entries and cross-organism orthologs for a gene.

Args: gene_id: KEGG gene ID (e.g. 'hsa:1956').

search_glycansA

Search KEGG glycan database by keyword or composition.

Args: query: Glycan name or composition (e.g. 'GlcNAc', 'Man5', 'sialic acid'). max_results: Maximum number of results to return (capped at 100).

get_glycan_infoA

Get detailed information for a KEGG glycan entry.

Args: glycan_id: KEGG glycan ID (e.g. 'G00001'). detail_level: 'summary' (default, compact) or 'full' (complete flat-file parse).

search_modulesA

Search KEGG modules by keyword.

Args: query: Module name or pathway block (e.g. 'glycolysis', 'TCA cycle'). max_results: Maximum number of results to return (capped at 100).

get_module_infoA

Get detailed information for a KEGG module.

Args: module_id: KEGG module ID (e.g. 'M00001' for glycolysis core module). detail_level: 'summary' (default, compact) or 'full' (complete flat-file parse).

search_ko_entriesA

Search KEGG Orthology (KO) entries by keyword.

Args: query: Gene function (e.g. 'hexokinase', 'ribosomal protein', 'cytochrome'). max_results: Maximum number of results to return (capped at 100).

get_ko_infoA

Get detailed information for a KEGG Orthology (KO) entry.

Args: ko_id: KEGG KO identifier (e.g. 'K00844' for hexokinase). detail_level: 'summary' (default, compact) or 'full' (complete flat-file parse).

search_pathwaysA

Search KEGG pathways by keyword.

Args: query: Search term (e.g. 'glycolysis', 'TCA', 'insulin signaling'). organism_code: 3-4 letter organism code (e.g. 'hsa' for human, 'mmu' for mouse). Use 'map' for reference pathways. max_results: Maximum number of results to return (capped at 100).

get_pathway_infoA

Get detailed information for a KEGG pathway.

Args: pathway_id: KEGG pathway ID (e.g. 'hsa00010', 'map00010'). detail_level: 'summary' (default, compact) or 'full' (complete flat-file parse with all linked genes, compounds, reactions, references, and xrefs).

get_pathway_genesA

Get all genes associated with a KEGG pathway.

Args: pathway_id: KEGG pathway ID (e.g. 'hsa00010'). Use organism-specific IDs (e.g. 'pae00350' for P. aeruginosa) — reference pathways ('map*') are not supported by the KEGG gene link API.

get_pathway_compoundsA

Get all compounds (metabolites) associated with a KEGG pathway.

Args: pathway_id: KEGG pathway ID (e.g. 'map00010').

get_pathway_reactionsB

Get all reactions in a KEGG pathway.

Args: pathway_id: KEGG pathway ID (e.g. 'hsa00010').

search_reactionsA

Search KEGG reactions by keyword.

Args: query: Search term (reaction name or description). max_results: Maximum number of results to return (capped at 100).

get_reaction_infoA

Get detailed information for a KEGG reaction.

Args: reaction_id: KEGG reaction ID (e.g. 'R00756' for glucose phosphorylation). detail_level: 'summary' (default, compact) or 'full' (complete flat-file parse).

Prompts

Interactive templates invoked by user choice

NameDescription
pathway_enrichment_analysisGuided KEGG pathway enrichment analysis for a list of genes. Walk through mapping a gene list to KEGG IDs, aggregating pathway associations, and identifying over-represented pathways. Args: gene_list: Comma- or newline-separated gene symbols or IDs (e.g. 'EGFR, TP53, BRCA1' or Entrez IDs). organism: KEGG organism code (default 'hsa' for human).
drug_target_investigationComprehensive investigation of a drug's targets, pathways, and interactions. Guides the analysis from drug identification through target mapping, pathway involvement, and drug-drug interaction screening. Args: drug_name: Drug name or synonym (e.g. 'imatinib', 'aspirin', 'metformin').
visualize_pathwayVisualize a KEGG pathway as ASCII art with biological context. Renders the pathway in both chain and grid modes, then annotates key enzymes, branch points, and disease associations. Args: pathway_id: Reference pathway number (e.g. '00010' for glycolysis). organism: KEGG organism code (default 'hsa' for human).
metabolic_pathway_comparisonCross-species comparison of a metabolic pathway. Compares gene content, reactions, and compounds across multiple organisms to reveal conserved and species-specific elements. Args: pathway_id: Reference KEGG pathway ID (e.g. 'map00010' for glycolysis, 'map00020' for TCA cycle). organisms: Comma-separated KEGG organism codes to compare (default: 'hsa,mmu,eco' for human, mouse, E. coli).

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.9/5.0

Scored across 34 tools

Disambiguation4/5

Most tools are clearly distinct by KEGG entity type, with a consistent search/get pattern. A few generic utilities like find_related_entries overlap with specialized functions (e.g., get_gene_orthologs, get_compound_reactions), but descriptions clarify their specific use cases.

Naming Consistency5/5

Tool names follow a consistent verb_noun snake_case pattern, such as search_* and get_*_info. Minor deviations like list_organisms, batch_entry_lookup, and render_pathway_ascii are still intuitive and do not break the overall coherence.

Tool Count2/5

With 34 tools, the server exceeds the 25-tool threshold for 'too many' per the rubric. While each tool serves a distinct function, the high number may overwhelm agents, making the tool set harder to navigate.

Completeness5/5

The tool set comprehensively covers all major KEGG databases (compounds, drugs, diseases, genes, enzymes, glycans, modules, orthology, pathways, reactions, BRITE, organisms) with search and detail retrieval, plus batch and conversion utilities. No significant gaps are apparent for a read-only KEGG server.

Maintenance

ActivityMaintained
ResponsivenessNo issues