Skip to main content
Glama

BioMCP — Bioinformatics MCP Server

English | 汉语

BioMCP is an open-source MCP server that connects any AI assistant directly to 43 open bioinformatics databases — zero config, no API keys. Literature, sequences, BLAST, structures, enrichment, annotations, genomes, interactions, pathways, variants, population frequencies, methylation QTLs, tissue expression, drug targets, compounds, single-cell, glycomics, metabolomics, lipidomics, microbiome, plants, model organisms, proteomics and more.

MCP PyPI Tools Databases Python License Platform


Features

Standard MCP protocol — Based on official MCP SDK with stdio transport, compatible with all MCP clients

83 tools · 43 databases — Covers literature → sequences → structures → functions → interactions → pathways → variants → population frequency → methylation → tissue expression → drug targets → drugs → single-cell → glycomics → metabolomics → lipidomics → microbiome → plants → model organisms → proteomics → intelligent analysis

Zero-configpip install biomcp-server one command, no database setup, no API keys required

Authoritative public data — All from official APIs: NCBI / RCSB / UniProt / Ensembl / EBI / STRING / KEGG / GlyGen / Reactome / OpenAlex, etc.

Smart rate-limiting — Built-in NCBI 3 seconds/request rate limiting with retry backoff, respects academic API standards

Cross-database validationgene_full_profile concurrently queries 4 databases, intelligent_analyze auto-detects data types and recommends optimal analysis plans

Bilingual — Tool descriptions are available in both English and Chinese, and the default endpoints are reachable from mainland China (Enrichr is used in place of g:Profiler)

Intelligent Agent System — Auto-analyzes input data, recommends optimal tools, saves tokens, provides unexpected insights

Honest Agentdb_health_check runs real connectivity tests on all endpoints, tool_inventory reports which tools are end-to-end verified vs best-effort


Related MCP server: BioContextAI Knowledgebase MCP

Install

# Install (Python 3.10+)
pip install biomcp-server

# Run in stdio mode
bio-mcp

Install from source

git clone https://github.com/qgeng1465/bio-mcp.git
cd bio-mcp
pip install .
# or dev mode
pip install -e ".[test]"

Quick Start

Register BioMCP in any MCP-compatible AI assistant / IDE (Cursor / VS Code / MCP clients, etc.):

{
  "mcpServers": {
    "bio-mcp": {
      "command": "bio-mcp"
    }
  }
}

Then just ask in conversation:

Search the latest literature on BRCA1 / highly cited papers on CRISPR
Download the protein sequence for CYP2D6 / fetch nucleotide sequences for E. coli
BLAST this DNA: ATGC...
Look up the structure of PDB 1CRN / AlphaFold prediction for P04637 / EMDB cryo-EM structure EMD-1234
Run enrichment analysis on the gene list BRCA1,TP53,EGFR,ATM,RAD51
Look up the apoptosis pathway / the experimental interaction network of TP53
Look up the structure of glycan G00051MO / glycosylation of P04637 / lipid LMFA01030001
Search gut microbiome studies / E. coli genome assemblies / the pET-28a plasmid
Look up BRCA1 expression across human tissues
Look up the population allele frequency of rs1800562 / gnomAD constraint metrics for HFE
Look up mQTL associations for rs6602381 / epigenetic associations for cg05575921
Look up the liver eQTL for TP53 / TP53 drug-target–disease associations
Look up the Arabidopsis gene AT1G01010 / the C. elegans gene WBGene00000001
Search the human plasma proteomics project PXD000001 / the HGNC symbol for TP53
Search SRA sequencing data for breast cancer / UniChem ID mapping for aspirin
Produce a multi-database combined analysis report for BRCA1
Use intelligent analysis: functional analysis of the TP53 gene
Get an analysis template for gene research
Check which databases are currently reachable (honesty check)

Tools (83)

Intelligent Analysis

Tool

Function

Description

intelligent_analyze

Intelligent data analysis and tool recommendation

Auto-detects the data type, recommends the best analysis plan, saves tokens

get_analysis_template

Get analysis scenario templates

Pre-built analysis pipelines for gene research, drug discovery, and more

Literature

Tool

Function

Source

pubmed_search

literature search

NCBI E-utilities

europepmc_search

full-text + open-access

Europe PMC (EBI)

openalex_work_search

scholarly works search

OpenAlex

Sequence & Alignment

Tool

Function

Source

ncbi_fetch_sequence

fetch sequences

NCBI E-utilities

blast_search

homology search

NCBI BLAST

taxonomy_lookup

species taxonomy

NCBI Taxonomy

geo_dataset_search

expression dataset search

NCBI GEO

uniparc_search

protein archive search

EBI UniParc

uniparc_by_id

record by UPI ID

EBI UniParc

Structure

Tool

Function

Source

pdb_structure_summary

experimental structures

RCSB PDB

alphafold_structure

AI-predicted structures

AlphaFold DB (EBI)

emdb_structure_lookup

cryo-EM structures

EBI EMDB

Protein Function

Tool

Function

Source

uniprot_annotate

protein annotations

UniProt

protein_domains

structural domains

InterPro (EBI)

Gene Nomenclature

Tool

Function

Source

hgnc_search

gene symbol search

HGNC

hgnc_gene_symbol

canonical symbol & aliases

HGNC

Pathways & Interactions

Tool

Function

Source

gene_enrichment

enrichment analysis

Enrichr

kegg_pathway_search

pathway search

KEGG

kegg_pathway_genes

genes in a pathway

KEGG

reactome_pathway_search

pathway search

Reactome

string_interactions

protein interaction network

STRING-db

intact_interactions

experimental interactions

EBI IntAct

ensembl_gene_lookup

gene lookup

Ensembl

ensembl_homologs

homologous genes

Ensembl Compara

biogrid_interactions

interactions

BioGRID

biogrid_gene_interactions

gene interactions

BioGRID

Genome & Assembly

Tool

Function

Source

ucsc_genome_info

genome assemblies

UCSC Genome Browser

genome_assembly_search

genome assemblies

NCBI Assembly

Variants & Clinical

Tool

Function

Source

variant_annotate

variant annotation

MyVariant.info

clinvar_query

clinical variant classification

NCBI ClinVar

dbsnp_search

variant search

NCBI dbSNP

GO & GWAS

Tool

Function

Source

go_term_lookup

GO term details

QuickGO (EBI)

go_term_search

GO term search

QuickGO (EBI)

gene_go_annotation

GO annotations by gene

QuickGO (EBI)

gwas_variant_associations

variant-trait associations

GWAS Catalog (EBI)

gwas_gene_variants

GWAS variants by gene

GWAS Catalog (EBI)

Population Frequency & Constraint

Tool

Function

Source

gnomad_variant_lookup

allele frequency

gnomAD (Broad)

gnomad_gene_constraint

LOEUF)/ gene constraint metrics

gnomAD (Broad)

Methylation QTL & Epigenetics

Tool

Function

Source

mqtl_snp_lookup

SNP-to-CpG mQTL

GoDMC

mqtl_cpg_lookup

CpG-to-SNP mQTL

GoDMC

ewas_probe_lookup

probe EWAS associations

EWAS Atlas (NGDC)

ewas_gene_lookup

gene→probe EWAS

EWAS Atlas (NGDC)

Tissue Expression & Drug Targets

Tool

Function

Source

gtex_tissue_expression

tissue median expression

GTEx Portal

gtex_eqtl

single-tissue eQTL

GTEx Portal

ot_target_info

drug target info

Open Targets

ot_target_disease

target-disease associations

Open Targets

Compounds & Drugs

Tool

Function

Source

compound_info

compound info

PubChem

chembl_drug_search

drug bioactivity & targets

ChEMBL (EBI)

unichem_mapping

ID mapping by InChIKey

UniChem (EBI)

unichem_structure

cross-refs by InChIKey

UniChem (EBI)

chebi_compound

compound details

ChEBI (EBI)

chebi_search

compound search

ChEBI (EBI)

Nucleic Acid & Plasmids

Tool

Function

Source

plasmid_search

plasmid search

NCBI nuccore

ena_sequence_search

nucleotide sequences

EBI ENA

Microbiome

Tool

Function

Source

microbiome_study_search

metagenomics studies

EBI MGnify

Single-Cell

Tool

Function

Source

cellxgene_search

single-cell datasets

CELLxGENE (CZ)

Glycomics

Tool

Function

Source

glycan_lookup

glycan structure

GlyGen (GlyTouCan)

protein_glycosylation

protein glycosylation

GlyGen

Metabolomics

Tool

Function

Source

metabolomics_study

study details

EBI Metabolights

metabolomics_latest

latest studies

EBI Metabolights

Lipidomics

Tool

Function

Source

lipid_lookup

lipid structure

LIPID MAPS

Protein Atlas

Tool

Function

Source

protein_tissue_expression

tissue expression

Human Protein Atlas

Samples & Expression

Tool

Function

Source

biosample_by_id

sample details

NCBI BioSamples

biosample_search

sample search

NCBI BioSamples

expression_atlas_gene

gene-related experiments

EBI Expression Atlas

expression_atlas_experiment

experiment search

EBI Expression Atlas

Proteomics

Tool

Function

Source

pride_project

project details

EBI PRIDE

pride_search

project search

EBI PRIDE

Model Organisms

Tool

Function

Source

flybase_gene

fly gene details

FlyBase

flybase_search

fly gene search

FlyBase

wormbase_gene

worm gene details

WormBase

wormbase_search

worm gene search

WormBase

rgd_gene_symbol

rat gene symbol

Rat Genome DB

rgd_search

rat gene search

Rat Genome DB

Plants

Tool

Function

Source

plant_gene_lookup

plant gene lookup

Ensembl Plants

plant_species_list

supported plant species

Ensembl Plants

Sequencing Archive

Tool

Function

Source

sra_search

sequence read archive

NCBI SRA

bioproject_search

BioProject search

NCBI BioProject

Honesty

Tool

Function

Source

db_health_check

real connectivity test

All databases

tool_inventory

best_effort)/ tool inventory & status

All tools

Combined

Tool

Function

Source

gene_full_profile

combined report

4 databases


Example Output

Intelligent Analysis

Input: "TP53"
Goal: "function"

Output:
{
  "data_analysis": {
    "primary_type": "gene_name",
    "confidence": {"gene_name": 0.85}
  },
  "recommended_plans": [
    {
      "plan_id": "primary",
      "recommended_tools": [
        "uniprot_annotate",
        "protein_domains",
        "gene_enrichment",
        "string_interactions"
      ],
      "expected_results": [
        "Basic protein information",
        "Domains and families",
        "GO enrichment analysis",
        "Protein interaction network"
      ],
      "token_efficiency": "high",
      "insights": [
        "Consider checking the species specificity of the gene",
        "Consider how this gene's expression differs across tissues",
        "You could explore aberrant expression of this gene in disease states"
      ]
    }
  ]
}

gene_full_profile (combined tool)

Combined analysis: TP53 (homo_sapiens)

- Ensembl ENSG00000141510 · chr17:7668402-7687550 · protein_coding · tumor protein p53
- UniProt P04637 · Cellular tumor antigen p53 · Homo sapiens · 393 aa · Multifunctional transcription factor...
- STRING interaction partners: MDM2(0.999), TP53BP1(0.996), EP300(0.986), ...
- PubMed literature: 74,021 papers

Cross-validated across Ensembl / UniProt / STRING / PubMed.

Two Ways to Use: Agent or Direct

Two usage modes are available:

Mode 1 — Intelligent agent + skills (token-saving)

  • Ask intelligent_analyze(input, goal) directly: the agent classifies the data type, recommends databases, states the expected results and insights, and calls only the tools it needs.

  • Or use one of the bundled skills (bio-data-to-database / bio-analysis / bio-mcp-usage), which follow the flow "classify → recommend → cross-validate → report honestly".

  • Best for: when you are not sure what the data can answer, want to save tokens, or need insights.

Mode 2 — Call any tool directly (fully manual)

  • Skip the agent and call any single tool, e.g. pubmed_search(term="BRCA1"), blast_search(...), uniprot_annotate(gene="TP53").

  • Best for: when the data and the goal are clear, you already have a query plan, or you don't want agent judgement in the loop.

  • The tools are the same ones the agent uses: tool_inventory lists all 83 tools with their verification status, and db_health_check confirms current reachability.

The two modes are equivalent and interchangeable: the agent ends up calling the same tools, and manual calls return exactly the same results.


Architecture

Client Layer
┌──────────────────────────────────────────────┐
│                 MCP Client                   │
│   (Any MCP-compatible AI assistant / IDE)     │
└──────────────────────┬───────────────────────┘
                       │  stdio (JSON-RPC 2.0)
Server Layer
┌──────────────────────▼───────────────────────┐
│              bio-mcp server                   │
│  ┌────────────────────────────────────────┐  │
│  │  tools/  (83 MCP tools)                │  │
│  │  intelligent · honesty · pubmed · ncbi │  │
│  │  blast · pdb · uniprot · enrichment ·  │  │
│  │  ensembl · string · kegg · variant ·   │  │
│  │  interpro · pubchem · chembl ·         │  │
│  │  europepmc · alphafold · cellxgene ·   │  │
│  │  ucsc · taxonomy · geo · glygen ·      │  │
│  │  uniparc · metabolights · proteinatlas │  │
│  │  assembly · dbsnp · plasmid · ena ·    │  │
│  │  mgnify · reactome · openalex · lipid  │  │
│  │  emdb · intact · crosscheck · hgnc ·   │  │
│  │  biogrid · biosamples · expression ·   │  │
│  │  unichem · chebi · pride · flybase ·   │  │
│  │  wormbase · rgd · plants · gnomad ·    │  │
│  │  godmc · ewas · gtex · opentargets     │  │
│  └────────────────────┬───────────────────┘  │
│  ┌────────────────────▼───────────────────┐  │
│  │  core/  (42 client modules · 43 DBs)     │  │
│  │  BioHTTP: retry/backoff/rate-limit/      │  │
│  │  LRUCache: thread-safe caching          │  │
│  └────────────────────┬───────────────────┘  │
└───────────────────────┼──────────────────────┘
Database Layer
        ┌───────┬───────┼───────┬───────┬────────────┐
     ┌──▼──┐ ┌──▼──┐ ┌──▼──┐ ┌──▼──┐ ┌──▼──┐ ┌─────▼─────┐
     │NCBI │ │RCSB │ │Uni  │ │Ens  │ │STRING│ │Enrichr   │
     │     │ │PDB  │ │Prot │ │embl │ │     │ │... 43 DBs │
     └─────┘ └─────┘ └─────┘ └─────┘ └─────┘ └───────────┘

Why Enrichr and not g:Profiler?

g:Profiler (Estonia) is frequently unreachable from mainland China; Enrichr (Ma'ayan Lab) is reachable there and provides hundreds of gene-set libraries including GO/KEGG/Reactome/WikiPathways. BioMCP uses Enrichr by default so it works out of the box.

Why OpenGWAS / DisGeNET are excluded

OpenGWAS has required an API token since 2024-05, and DisGeNET also needs an API key; neither can be used zero-config, so neither is included. Of the databases that are included, all 42 are open, keyless APIs except BioGRID, which needs a BIOGRID_ACCESS_KEY environment variable. BioGRID is kept because a key is free on registration and its interaction data is valuable for protein-network analysis.


Project Structure

bio-mcp/
├── src/bio_mcp/
│   ├── server.py            #   MCP server entry point (wires up the 83 tools)
│   ├── core/                #   42 client modules covering 43 databases
│   │   ├── http.py          #   BioHTTP: retry / backoff / rate-limit / timeout
│   │   ├── cache.py         #   LRUCache: thread-safe caching layer
│   │   ├── ncbi.py          #   NCBI E-utilities + BLAST + Assembly + dbSNP + SRA/BioProject/BioSamples
│   │   ├── rcsb.py          #   RCSB PDB
│   │   ├── uniprot.py       #   UniProt REST
│   │   ├── enrichr.py       #   Enrichr enrichment
│   │   ├── ensembl.py       #   Ensembl genes / homologs / plants
│   │   ├── stringdb.py      #   STRING interactions
│   │   ├── kegg.py          #   KEGG pathways
│   │   ├── myvariant.py     #   MyVariant variants
│   │   ├── interpro.py      #   InterPro domains
│   │   ├── pubchem.py       #   PubChem compounds
│   │   ├── europepmc.py     #   Europe PMC literature
│   │   ├── alphafold.py     #   AlphaFold structures
│   │   ├── chembl.py        #   ChEMBL drugs
│   │   ├── cellxgene.py     #   CELLxGENE single-cell
│   │   ├── ucsc.py          #   UCSC genomes
│   │   ├── glygen.py        #   GlyGen glycomics
│   │   ├── uniparc.py       #   UniParc protein sequence archive
│   │   ├── metabolights.py  #   Metabolights metabolomics
│   │   ├── proteinatlas.py  #   Human Protein Atlas
│   │   ├── ena.py           #   EBI ENA nucleotide archive
│   │   ├── mgnify.py        #   EBI MGnify microbiome
│   │   ├── reactome.py      #   Reactome pathways
│   │   ├── openalex.py      #   OpenAlex literature
│   │   ├── lipidmaps.py     #   LIPID MAPS lipids
│   │   ├── emdb.py          #   EBI EMDB cryo-EM structures
│   │   ├── intact.py        #   EBI IntAct experimental interactions
│   │   ├── hgnc.py          #   HGNC gene nomenclature
│   │   ├── biogrid.py       #   BioGRID interactions (API key required)
│   │   ├── expressionatlas.py #   EBI Expression Atlas
│   │   ├── unichem.py       #   UniChem compound ID mapping
│   │   ├── chebi.py         #   ChEBI compound ontology
│   │   ├── pride.py         #   EBI PRIDE proteomics
│   │   ├── flybase.py       #   FlyBase Drosophila
│   │   ├── wormbase.py      #   WormBase C. elegans
│   │   ├── rgd.py           #   Rat Genome DB
│   │   ├── gnomad.py        #   gnomAD population frequency / gene constraint
│   │   ├── godmc.py         #   GoDMC mQTL
│   │   ├── ewas.py          #   EWAS Atlas epigenetics
│   │   ├── gtex.py          #   GTEx tissue expression / eQTL
│   │   └── opentargets.py   #   Open Targets drug targets
│   └── tools/               #   83 MCP tool definitions
│       ├── intelligence.py  #   intelligent analysis system
│       ├── honesty.py       #   honesty agent (connectivity check / tool inventory)
│       ├── plants.py        #   plant gene tools
│       ├── pubmed.py · ncbi.py · blast.py · pdb.py
│       ├── uniprot.py · enrichment.py · ensembl.py
│       ├── stringdb.py · kegg.py · variant.py
│       ├── interpro.py · pubchem.py · europepmc.py
│       ├── alphafold.py · chembl.py · cellxgene.py
│       ├── ucsc.py · ncbi_extra.py · glygen.py
│       ├── uniparc.py · metabolights.py · proteinatlas.py
│       ├── ena.py · mgnify.py · reactome.py · openalex.py
│       ├── lipidmaps.py · emdb.py · intact.py · crosscheck.py
│       ├── hgnc.py · biogrid.py · biosamples.py
│       ├── expressionatlas.py · unichem.py · chebi.py
│       ├── pride.py · flybase.py · wormbase.py · rgd.py
│       ├── gnomad.py · godmc.py · ewas.py · gtex.py
│       └── opentargets.py
├── tests/                   #   unit tests (no network)
├── examples/                #   client configs and quick start
├── .github/workflows/       #   CI (GitHub Actions)
└── pyproject.toml

Testing

# offline unit tests
python -m pytest tests/ -v

Honest note on verification status:**

The original 40 tools (v0.1-0.4) were end-to-end validated against real public databases during development. Most of the 28 tools added in v0.5 (HGNC, BioSamples, UniChem, ChEBI, PRIDE, WormBase, plants, SRA/BioProject, Expression Atlas experiment search, intelligent analysis and the honesty checks) were also validated end-to-end against real data. The 5 tools added in v0.6 (QuickGO ×3, GWAS Catalog ×2) were validated against live APIs. The 10 tools added in v0.7 (gnomAD ×2, GoDMC ×2, EWAS ×2, Open Targets ×2) were validated against live APIs; GTEx ×2 were implemented per the OpenAPI spec with structural checks — the gtexportal endpoints intermittently return 502/SSL errors, so treat db_health_check as the live answer. Restricted tools are disclosed honestly: FlyBase is blocked by CloudFront WAF bot detection; Rat Genome DB timed out on the current network; WormBase search is best-effort; BioGRID needs an API key. expression_atlas_gene is an honest version — the public REST API no longer exposes numeric per-gene expression values, so it returns matching experiments instead. Run db_health_check to confirm what is reachable before relying on a specific database.

The original 40 tools (v0.1-0.4) were end-to-end validated during development. Most of the 28 tools added in v0.5 were validated against real data during development. The 5 tools added in v0.6 (QuickGO ×3, GWAS Catalog ×2) were e2e-validated against live APIs. The 10 tools added in v0.7 (gnomAD ×2, GoDMC ×2, EWAS ×2, Open Targets ×2) were e2e-validated against live APIs; GTEx ×2 were implemented per OpenAPI with structural checks — the gtexportal endpoints intermittently return 502/SSL errors from some networks, so verify with db_health_check. Restricted tools are disclosed honestly: FlyBase is blocked by CloudFront WAF bot detection; Rat Genome DB timed out in the current network; WormBase search is best-effort; BioGRID needs an API key. expression_atlas_gene is an honest version — the public REST no longer exposes numeric per-gene expression values, so it returns matching experiments instead. Run db_health_check to confirm endpoint reachability before relying on a specific database.


License

BioMCP uses a dual licensing model:

  • Academic Use: MIT License for educational, research, and personal non-commercial use

  • Commercial Use: Requires a separate commercial license for business integration, revenue generation, or SaaS deployment

For commercial licensing inquiries: https://github.com/qgeng1465


Roadmap

Batch comparative analysis Virtual cell & organoid data interfaces More database support Advanced intelligent analysis (multi-agent collaboration) Candidate databases: EVA, cBioPortal, GDC, BioMart, SIGNOR, SGD, BioStudies, CTD, WikiPathways, Complex Portal, HCA, MGI/AllianceMine HTTP/2, response caching, concurrent requests to speed up cross-database validation


Disclaimer

For educational research and personal reasonable use only.

Query results come from public database raw data and are not guaranteed to be completely accurate; please verify with professional tools and original data.

Please comply with database usage terms (NCBI requires ≥3 seconds/request with contact info, already built-in).

For clinical/drug/medical decisions, please consult professionals. Users assume all risks and liabilities.


Support

If BioMCP helps you, consider supporting the project to keep it updated.


Citation

If you use BioMCP in your research or publication, please cite:

@software{bio_mcp_2026,
  title={BioMCP: A Zero-Config MCP Server for Bioinformatics Databases},
  author={qgeng1465},
  year={2026},
  url={https://github.com/qgeng1465/bio-mcp}
}

License © 2026 qgeng1465

Available Tools

73 tools
alphafold_structureA

Query AlphaFold DB AI-predicted protein structures. 查询 AlphaFold DB 的 AI 蛋白结构预测:给定 UniProt accession,returns pLDDT confidence, sequence length, PDB download link. 返回 pLDDT 置信度、序列长度、3D 模型(PDB)下载链接。AlphaFold covers 200M+ proteins. AlphaFold 覆盖 2 亿+ 蛋白。

ParametersJSON Schema
NameRequiredDescriptionDefault
uniprot_accYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.1/5.0
Behavior4/5

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

With no annotations provided, the description carries the full behavioral disclosure burden. It clearly presents this as a read-only lookup operation, explicitly stating the return payload and the 200M+ protein coverage. It does not mention error cases or rate limits, but for a simple query tool the disclosed behavior is adequate and useful.

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

Conciseness4/5

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

The description is front-loaded with the main verb and resource, and communicates essential information in a compact bilingual format. The Chinese/English repetition adds mild redundancy, but it does not obscure the meaning or bloat the description excessively.

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

Completeness4/5

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

This is a simple single-parameter query tool with an output schema available, so the description need not detail every return field. It gives the access point, output categories, and data scope, which is largely complete. The main absence is explicit guidance relative to sibling structure tools, but that is a minor gap.

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

Parameters4/5

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

The schema only names the parameter 'Uniprot Acc' with no description, so the description compensates by explaining that the parameter is a UniProt accession. It lacks an explicit format or example, but the required identifier type is clear and sufficient for a knowledgeable agent.

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?

The description clearly specifies the action ('Query'), the resource ('AlphaFold DB'), and the expected result fields (pLDDT confidence, sequence length, PDB download link). This is sufficiently distinct from sibling tools like pdb_structure_summary because it explicitly names AlphaFold DB and the returned confidence metric.

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

Usage Guidelines3/5

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

The description implies the intended use case: given a UniProt accession, retrieve AlphaFold-predicted structure data. However, it does not explicitly state when to prefer this tool over related alternatives such as pdb_structure_summary, nor does it mention when not to use it.

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

biogrid_gene_interactionsA

Get protein interactions for a specific gene symbol from BioGRID. Input: gene symbol (TP53), optional organism ID (9606=human). Output: interaction partners with experimental evidence and detection methods.

ParametersJSON Schema
NameRequiredDescriptionDefault
organismNo
gene_symbolYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.1/5.0
Behavior3/5

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

With no annotations, the description must carry behavioral disclosure. It states the output type (interaction partners with experimental evidence and detection methods) but does not mention read-only nature explicitly, potential for large result sets, rate limits, or error behavior. The 'Get' verb implies a read operation, but more transparency would be ideal.

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?

Two concise sentences deliver the core purpose, input requirements, and output summary with no filler. The key statement is front-loaded and every phrase earns its place.

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

Completeness4/5

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

For a two-parameter tool with an output schema, the description covers purpose, inputs, and output sufficiently. It does not address edge cases or alternative sibling tools, but the essential information needed to invoke it correctly is present.

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?

The schema has 0% description coverage, so the description fully compensates by explaining both parameters: gene_symbol with an example (TP53) and organism with a default/example (9606=human). This goes beyond the raw schema and clarifies parameter meaning and format.

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

Purpose4/5

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

The description states a clear action ('Get') and a specific resource ('protein interactions for a specific gene symbol from BioGRID'), which is more specific than a generic interaction query. It does not explicitly differentiate from the sibling tool 'biogrid_interactions', so it falls short of a 5.

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?

The description gives clear usage context: provide a gene symbol, optionally an organism ID, and receive interaction partners. It does not mention alternatives or when not to use this tool, but the input/output guidance is explicit enough to select it for gene-centric BioGRID queries.

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

biogrid_interactionsB

Search protein interaction data from BioGRID database. Input: gene name or identifier (BRCA1, TP53). Output: protein-protein interactions with experimental evidence and publication references.

ParametersJSON Schema
NameRequiredDescriptionDefault
search_nameYes
search_typeNoGENES

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.3/5.0
Behavior3/5

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

No annotations are provided, so the description carries the behavioral burden. It usefully states that the output includes experimental evidence and publication references, setting expectations beyond just 'interactions'. It does not mention pagination, rate limits, error behavior, or the effect of search_type, but these are minor for a straightforward search tool.

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?

The description is two tight sentences with no filler. It front-loads the core action and scope, then gives useful input and output expectations, so every sentence earns its place.

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

Completeness3/5

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

An output schema is present, so return values do not need explanation, but the description omits search_type behavior and gives no guidance for choosing among close sibling tools. A minimal call can still be constructed from the required search_name guidance, so it is minimally viable but has clear gaps.

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

Parameters2/5

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

Schema description coverage is 0%, so the description must compensate for missing schema documentation. It explains search_name reasonably well with gene examples like BRCA1 and TP53, but it never mentions search_type or what values it accepts. One of the two parameters remains effectively undocumented.

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

Purpose4/5

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

The description uses a specific verb ('Search') and names a specific resource ('protein interaction data from BioGRID database'), and it clarifies the expected output. However, it does not distinguish this tool from the closely named sibling biogrid_gene_interactions, so it misses the top score.

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

Usage Guidelines3/5

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

The phrase 'from BioGRID database' gives clear contextual context and implies this tool is for BioGRID interaction queries. It does not explicitly state when to prefer this tool over alternatives like string_interactions or intact_interactions, nor does it provide exclusionary guidance.

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

biosample_by_idA

Get biological sample metadata by sample ID. Input: sample ID (SAMN00000001, SAMEA123456). Output: sample accession, title, organism, status. 按样本ID获取生物样本元数据(通过 NCBI E-utilities)。

ParametersJSON Schema
NameRequiredDescriptionDefault
sample_idYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.9/5.0
Behavior3/5

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

No annotations are provided, so the description carries the behavioral disclosure burden. It does indicate a read-style operation, identifies the NCBI E-utilities source, and enumerates output fields. However, it does not disclose behavior for invalid IDs, missing records, rate limits, or response error handling.

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

Conciseness4/5

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

The description is compact and front-loaded with the core purpose, followed by input and output details. The Chinese sentence is redundant with the English text aside from naming NCBI E-utilities, but the overall length is still appropriate.

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

Completeness4/5

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

For a one-parameter ID lookup with an output schema available, the description provides enough operational context: lookup mode, input format, output fields, and the underlying data source. It could add guidance for not-found cases, but this is a minor gap for such a simple tool.

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

Parameters4/5

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

The schema only defines sample_id as a string with no description, so 0% schema coverage means the description must compensate. It does so by providing concrete example formats (SAMN00000001, SAMEA123456), which meaningfully clarifies the expected parameter value.

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?

The description clearly identifies a specific action ('Get'), a specific resource ('biological sample metadata'), and the key qualifier ('by sample ID'). Listing the output fields also distinguishes it from broader search tools like biosample_search.

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

Usage Guidelines3/5

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

The phrase 'by sample ID' implies this should be used when an accession is already available, but there is no explicit guidance on when to choose this over biosample_search or other lookup alternatives. No alternative tools are mentioned.

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

chebi_compoundA

Query ChEBI compound by ChEBI ID. 按 ChEBI ID 查询化合物信息:输入 ChEBI 编号(如 CHEBI:15377 ATP),返回化合物名称、定义、化学属性与交叉引用,用于化学生物学研究。

ParametersJSON Schema
NameRequiredDescriptionDefault
chebi_idYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.8/5.0
Behavior3/5

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

With no annotations provided, the description carries the burden. It helpfully states that the operation returns compound names, definitions, chemical properties, and cross-references, and gives an example ID. However, it does not disclose error handling, exact input normalization, or whether the operation is read-only, though 'query' and 'return' imply a read-only lookup.

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

Conciseness4/5

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

The English sentence is concise and front-loaded, with the Chinese sentence adding concrete return fields and use case. There is some redundancy between the two languages, but the overall size is appropriate and every key piece of information is present.

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

Completeness4/5

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

For a simple one-parameter lookup with an output schema available, the description covers the essential information: what input to provide, an example, and what kind of data will be returned. It lacks a reference to the related search tool and edge-case behavior, but the core invocation context is adequately complete.

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

Parameters4/5

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

The input schema provides only 'chebi_id' with no description (0% coverage). The description compensates by explaining that this should be a ChEBI ID and gives the example 'CHEBI:15377 ATP'. This is helpful, though it does not specify whether bare numeric IDs are also accepted or whether the 'ATP' text is part of the identifier.

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

Purpose4/5

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

The description clearly states the action: 'Query ChEBI compound by ChEBI ID' and elaborates with what is returned: compound name, definition, chemical properties, and cross-references. It is specific and understandable, but it does not explicitly contrast itself with the sibling tool chebi_search, so it stops short of full sibling differentiation.

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?

The description gives clear context for use: when you have a ChEBI ID, supply it as input, and the tool returns compound information for chemical biology research. It does not explicitly discuss when not to use it or mention alternatives such as chebi_search, but the intended use case is clear enough to guide selection.

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

clinvar_queryA

Query ClinVar clinical variants (via NCBI E-utilities). 查询 ClinVar 临床变异:输入基因名或变异,返回临床意义分类(致病/良性/意义不明),for clinical variant interpretation. 用于变异临床解读。

ParametersJSON Schema
NameRequiredDescriptionDefault
queryYes
max_resultsNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.6/5.0
Behavior3/5

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

No annotations are provided, so the description must carry the behavioral burden. It does disclose that the tool queries NCBI E-utilities and returns clinical significance categories, which is valuable. However, it does not mention important operational details such as rate limits, whether results are limited by max_results, or the exact output format, leaving some behavior unspecified.

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

Conciseness3/5

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

The description is fairly short and front-loaded, but it repeats the same meaning in English and Chinese, creating redundancy. The bilingual content may serve multilingual users but adds token overhead for an AI agent without adding new information.

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

Completeness4/5

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

For a simple two-parameter query tool with an output schema, the description covers the essential context: what is being queried, what input is expected, what output is returned, and the intended clinical interpretation use case. The main gap is the lack of detail on max_results and potential result-count limits, but the overall context is sufficient for correct usage in most cases.

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

Parameters3/5

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

Schema description coverage is 0%, so the description must compensate. It does explain the main 'query' parameter as accepting a gene name or variant, and 'max_results' is self-explanatory with a default in the schema. However, max_results semantics are not described in the text, and the description does not fully clarify query syntax or accepted variant formats.

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

Purpose4/5

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

The description clearly states the function: querying ClinVar clinical variants via NCBI E-utilities and returning clinical significance classifications. It specifies the resource, the action, and the key output. It does not explicitly contrast itself with sibling tools like dbsnp_search or variant_annotate, but the focus on ClinVar and clinical interpretation makes it reasonably distinguishable.

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?

The description gives a clear use context: 'for clinical variant interpretation' / '用于变异临床解读'. It also states the input type (gene name or variant), which helps an agent decide when to call it. It does not explicitly state when not to use it or name alternative tools, but the context is clear enough for selection.

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

compound_infoB

Query compound/drug basic info (PubChem). 查询化合物/药物基本信息:分子式、分子量、规范 SMILES、IUPAC 名、InChIKey 与 CID,for medicinal chemistry and docking prep. 用于药物化学、分子对接前的化合物确认。

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYes
include_synonymsNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.4/5.0
Behavior3/5

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

With no annotations provided, the description carries the behavioral transparency burden. It does disclose that this is a query/lookup operation against PubChem and enumerates the returned identifiers and properties. However, it does not explain the effect of include_synonyms, possible API limitations, latency, or what happens for invalid or ambiguous compound names.

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

Conciseness4/5

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

The description is compact and front-loads the core action and source. The bilingual repetition adds some redundancy, but both sentences earn their place by also adding use-case context; it is not bloated relative to the information it conveys.

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

Completeness3/5

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

For a simple two-parameter lookup with an output schema, the description gives the essential purpose, source, and intended use. However, it lacks parameter-level guidance for include_synonyms, does not mention how this tool differs from chembl_drug_search or unichem_mapping, and does not describe behavior on missing/ambiguous compounds, making it minimally adequate rather than complete.

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

Parameters2/5

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

Schema description coverage is 0%, so the description must compensate. It clarifies that 'name' refers to a compound/drug name and lists output fields, but it never explains the include_synonyms boolean parameter or how passing it changes the response. This leaves a required parameter reasonably clear but the optional parameter ambiguous.

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

Purpose4/5

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

The description uses a specific verb ('Query') and resource ('compound/drug basic info (PubChem)') and lists concrete fields such as 分子式, 分子量, 规范 SMILES, IUPAC 名, InChIKey and CID. This makes the tool's purpose clear, but it does not explicitly differentiate it from the similar sibling chembl_drug_search beyond naming PubChem as the source.

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?

The description gives clear intended-use context: 'for medicinal chemistry and docking prep' and '用于药物化学、分子对接前的化合物确认'. It does not provide explicit exclusions or alternatives, but the stated use cases are enough to indicate when an agent should reach for this tool.

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

db_health_checkA

Check which bioinformatics databases are currently reachable. 检查各生物数据库端点的连通性:对每个数据库做真实 HTTP 请求,如实报告可达/不可达与状态码,不做乐观假设。返回结果用于确认当前环境下哪些数据库可用。

ParametersJSON Schema
NameRequiredDescriptionDefault
timeoutNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.1/5.0
Behavior4/5

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

With no annotations, the description carries the full burden and does well: it discloses that the tool makes '真实 HTTP 请求' (real HTTP requests) to each endpoint, reports actual reachable/unreachable status and codes, and makes '不做乐观假设' (no optimistic assumptions). This is meaningful behavioral context beyond the name and schema. It does not cover timeout side effects or rate limits, but these are less critical for a health-check tool.

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?

Two sentences, both earning their place. The English sentence is front-loaded with the core purpose, and the Chinese sentence adds essential behavioral detail (real HTTP requests, status codes, no optimistic assumptions). No filler or redundancy.

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

Completeness4/5

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

For a single-optional-parameter tool with an output schema, the description covers what the tool does, how it behaves, and how the results should be used. The output schema handles return-value structure. The only notable gap is the undocumented timeout parameter semantics, which is already penalized under parameter semantics.

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

Parameters2/5

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

Schema description coverage is 0%, and the description does not mention the 'timeout' parameter at all. An agent must infer from the parameter name and default that it controls request timeout. The description provides no units, scope, or behavior advice, so it fails to compensate for the empty schema descriptions.

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?

The description opens with a specific verb and resource: 'Check which bioinformatics databases are currently reachable.' This clearly differentiates the tool from the many search/query siblings, which all fetch domain-specific data. The additional Chinese text reinforces the scope by describing endpoint connectivity checks across database endpoints.

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?

The description provides clear context: '返回结果用于确认当前环境下哪些数据库可用' (results are used to confirm which databases are available in the current environment). This implies using the tool before or while deciding which database-specific tools to invoke. It does not explicitly name alternatives or exclusions, but the health-check purpose is distinct enough to route usage.

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

emdb_structure_lookupA

Look up EBI EMDB cryo-EM structure entry. 查询 EMDB 冷冻电镜结构:输入 EMD 编号(如 EMD-1234),returns title/authors/resolution/macromolecules/dates. 返回标题、作者、分辨率、组分与发布信息,用于电镜结构研究。

ParametersJSON Schema
NameRequiredDescriptionDefault
emdb_idYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.3/5.0
Behavior4/5

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

With no annotations provided, the description carries the full burden. It discloses the tool's core behavior: it returns title, authors, resolution, macromolecules, and dates for a given EMDB entry. It does not cover error handling or edge cases, but for a read-only lookup these is acceptable.

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

Conciseness4/5

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

The description is short and front-loaded with the English purpose. The Chinese sentence repeats the same content, which is somewhat redundant, but it reinforces the input example and intended use case without adding verbiage.

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

Completeness4/5

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

Given a single required parameter, an existing output schema, and no nested objects, the description covers the essential invocation context: what to pass and what to expect. It could mention alternative tools or exact ID format acceptance, but it is adequate for a simple lookup tool.

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

Parameters4/5

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

The schema has no description for emdb_id, so the description compensates by explaining the parameter is an EMDB entry number and providing a concrete example (EMD-1234). This adds the meaning that the bare schema lacks, though format details beyond the example are minimal.

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?

States a specific verb and resource: 'Look up EBI EMDB cryo-EM structure entry'. It clearly identifies the domain (cryo-EM), the database (EMDB), and the expected output fields (title/authors/resolution/macromolecules/dates), making it distinguishable from sibling structure tools like PDB or AlphaFold.

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?

Provides clear context for when to use the tool: when you need EMDB cryo-EM structure information by EMD number, explicitly including an example input (EMD-1234). It does not name alternatives or exclusions, but the context is specific enough that the intended use is clear.

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

ensembl_gene_lookupB

Look up gene by symbol in Ensembl. 按基因符号查询 Ensembl 基因信息:Ensembl ID / chromosome location / biotype / description (GRCh38). Ensembl ID、染色体位置、生物型、描述,用于确认官方 ID 与坐标(GRCh38)。

ParametersJSON Schema
NameRequiredDescriptionDefault
symbolYes
speciesNohomo_sapiens

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.1/5.0
Behavior3/5

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

With no annotations provided, the description carries the full burden of behavioral disclosure. It adds genuinely useful scope context — the GRCh38 assembly and the intended purpose of confirming official IDs/coordinates. It does not, however, reveal behavior on edge cases such as unknown symbols, ambiguous matches, or case sensitivity of the symbol.

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

Conciseness3/5

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

The leading English sentence is appropriately short and front-loaded with the core action, but the two Chinese sentences repeat the same field list (Ensembl ID, chromosome location, biotype, description) verbatim. The second Chinese sentence adds only the purpose phrase, so roughly one sentence is redundant and fails to earn its place.

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

Completeness3/5

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

For a simple two-parameter symbol lookup with an output schema present, the description adequately covers the core operation and return fields. However, the `species` parameter is unexplained, there is no usage guidance relative to siblings, and the absence of annotations leaves the safety profile unstated. The gaps are real but bounded given the tool's low complexity.

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

Parameters2/5

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

Schema description coverage is 0%, so the description must compensate. It clarifies that `symbol` is the gene symbol used as the lookup key, but it says nothing about `species`, whose default of 'homo_sapiens' appears in the schema alone — leaving an agent to guess whether other species are accepted or how to specify them. One of two parameters is effectively undocumented.

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

Purpose4/5

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

The description names a specific operation — 'Look up gene by symbol in Ensembl' — and enumerates the returned fields (Ensembl ID, chromosome location, biotype, description, GRCh38), so an agent knows exactly what the tool does. It does not explicitly contrast itself with sibling lookups such as ensembl_homologs or hgnc_gene_symbol, leaving differentiation implicit rather than explicit.

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

Usage Guidelines3/5

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

The Chinese phrase '用于确认官方 ID 与坐标(GRCh38)' ('for confirming official ID and coordinates (GRCh38)') implies a use case: validating gene identifiers and genomic coordinates. However, it never states when to prefer this tool over siblings (e.g., ensembl_homologs, gene_full_profile, hgnc_gene_symbol) or when not to use it, so guidance remains implied rather than explicit.

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

ensembl_homologsA

Query homologous genes (orthologs/paralogs) from Ensembl Compara. 查询基因的同源基因(直系同源/旁系同源),返回物种、同源基因 ID、序列一致性,for evolutionary analysis and model organisms. 用于进化分析、模式生物研究。

ParametersJSON Schema
NameRequiredDescriptionDefault
symbolYes
speciesNohomo_sapiens
target_speciesNoall

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.7/5.0
Behavior3/5

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

No annotations are provided, so the description carries full responsibility for behavioral disclosure. It states the data source (Ensembl Compara) and the return fields, which gives a basic sense of behavior. However, it does not mention any rate limits, authentication requirements, error handling, or whether the operation is read-only (although that's implied). This is adequate but not rich, hence a 3.

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

Conciseness4/5

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

The description is brief and the key action is front-loaded. However, it redundantly repeats the same information in both English and Chinese, which adds no value for an AI agent and could be seen as unnecessary verbosity. Still, it's compact and sets the scope early, so a 4 is fair.

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

Completeness3/5

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

An output schema exists, so return value details are covered by that. However, the description omits any explanation of the parameters, which is critical given the schema has no descriptions. It also does not differentiate itself from sibling tools. For a simple query tool it's mostly sufficient, but the missing parameter guidance and lack of when-not-to-use leave it incomplete.

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

Parameters2/5

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

The schema provides zero descriptions for the three parameters (symbol, species, target_species), and the description does not compensate. It mentions returning species and homolog IDs, but never explains that 'symbol' is the query gene, 'species' is the source organism, or 'target_species' is the comparison set. Given 0% schema coverage, the description must clarify parameter semantics and fails to do so.

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?

The description clearly states the action ('Query homologous genes (orthologs/paralogs)') and the specific resource ('Ensembl Compara'), and mentions the returned data (species, homolog ID, sequence identity). This unambiguously distinguishes it from other gene-related tools like ensembl_gene_lookup, which focus on gene details rather than homologs.

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?

The description provides clear context on when to use this tool: 'for evolutionary analysis and model organisms.' It does not explicitly state when NOT to use it or name alternative tools, but the intended use case is implicit from the phrasing. Since it lacks explicit exclusions or sibling comparisons, a score of 4 is appropriate.

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

expression_atlas_experimentA

Search Expression Atlas experiments by keyword. Input: search term (cancer, tissue, disease). Output: matching experiments with conditions, species, and data availability. 按关键词搜索表达实验:输入搜索词(cancer/tissue/TP53),返回匹配实验列表,包含物种、实验类型与样本数,用于数据发现。

ParametersJSON Schema
NameRequiredDescriptionDefault
termYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.6/5.0
Behavior3/5

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

No annotations are provided, so the description carries the behavioral disclosure burden. It does describe the output shape (matching experiments with conditions, species, data availability) and implies a safe read-only keyword search. It does not mention result limits, pagination, or behavior when no matches are found. There is also a minor inconsistency between the English output mention ('data availability') and the Chinese output mention ('实验类型与样本数').

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

Conciseness4/5

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

The description is compact and front-loaded: it states the purpose first, then the input/output contract, then repeats the same information in Chinese. The bilingual repetition adds minor redundancy but is not bloated. Each section earns its place for a multilingual tool interface.

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

Completeness4/5

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

For a single-parameter keyword search tool, the description is largely complete: it tells the agent what to input, what to expect as output, and gives example terms. The presence of an output schema reduces the need to document return values in detail. Missing context is limited to behavior like result limits or sorting, which is not critical for basic invocation.

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

Parameters4/5

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

The schema provides no description for the 'term' parameter (0% coverage), so the description must compensate. It does so by explaining that the term is a free-text keyword and supplying concrete examples ('cancer', 'tissue', 'disease', 'TP53'), which is genuinely useful for an agent deciding what to pass. It does not define exact syntax, but for a simple keyword parameter this is reasonably sufficient.

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

Purpose4/5

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

The description states the specific action ('Search Expression Atlas experiments by keyword') and identifies the resource ('Expression Atlas experiments'). It distinguishes itself from likely sibling tools by focusing on 'experiments' rather than genes, though it does not explicitly name the alternative expression_atlas_gene.

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

Usage Guidelines3/5

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

The description gives clear examples of appropriate search terms (cancer, tissue, disease, TP53) and indicates the tool is for data discovery. However, it does not explicitly state when to choose this tool over siblings like expression_atlas_gene, and there are no exclusion criteria or alternative routing guidance.

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

expression_atlas_geneA

Find Expression Atlas experiments relevant to a gene. Public REST no longer exposes numeric per-gene expression values; this returns experiments whose description/species match the gene (e.g. TP53, ENSG00000141510), where expression can be viewed. 查找与基因相关的表达实验:输入基因 ID 或符号(TP53/ENSG00000141510)与可选物种,返回匹配的表达实验列表。公开 REST 已不提供单基因数值表达量端点,此处诚实返回相关实验供进一步查看。

ParametersJSON Schema
NameRequiredDescriptionDefault
gene_idYes
speciesNohomo sapiens

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.7/5.0
Behavior4/5

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

With no annotations provided, the description carries the full behavioral disclosure burden. It transparently says the public REST API no longer exposes numeric per-gene values and that results are experiments matching the gene's description/species. This is a substantive, honest limitation disclosure that goes well beyond the schema.

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

Conciseness3/5

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

The English portion is concise and front-loaded, but the Chinese section repeats much of the same information without adding new guidance. Phrases like '此处诚实返回相关实验' are more rhetorical than operational, adding noise for an agent deciding when to call the tool.

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

Completeness4/5

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

Given that an output schema exists and there are only two simple parameters, the description is largely complete for invocation: it identifies inputs, the matching behavior, and the key limitation. It could be stronger with an explicit pointer to expression_atlas_experiment or matching semantics, but nothing essential for a basic call is missing.

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

Parameters4/5

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

Schema coverage is 0%, so the description must compensate for the two undocumented parameters. It adds real meaning to gene_id by specifying that it accepts a gene ID or symbol with concrete examples TP53 and ENSG00000141510. It also notes species is optional, though it does not describe acceptable species values beyond relying on the schema default.

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

Purpose4/5

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

The description states a specific action and resource: 'Find Expression Atlas experiments relevant to a gene.' It clearly names gene identifiers and species as inputs, and differentiates this from numeric expression retrieval by explaining the REST limitation. It does not explicitly name or contrast the sibling expression_atlas_experiment tool, so it stops short of full sibling differentiation.

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

Usage Guidelines3/5

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

The description gives useful usage context: it is for finding experiments where a gene's expression can be viewed, and it notes that numeric per-gene expression values are not returned. However, it does not name any alternative tool for numeric values or experiment metadata, nor does it say when not to use this tool beyond the numeric limitation.

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

flybase_geneA

Get Drosophila gene by FlyBase ID. 按 FlyBase ID 获取果蝇基因信息:输入果蝇基因编号(如 FBgn0000015),返回基因名称、符号、染色体位置、功能注释与别名,用于果蝇遗传学研究。

ParametersJSON Schema
NameRequiredDescriptionDefault
gene_idYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.2/5.0
Behavior4/5

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

No annotations are provided, so the description carries the behavioral disclosure burden. It clearly frames this as a read-only lookup and enumerates the returned fields, which is sufficient for a simple retrieval tool. It stops short of discussing ID validation or error behavior, but those are minor given the tool's straightforward nature.

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

Conciseness4/5

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

The description is short and front-loaded with the core action. The bilingual expansion adds useful detail rather than pure repetition, though the closing phrase about intended research use is somewhat non-essential.

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?

For a single-parameter lookup tool with an output schema, the description covers the key details: data source, required input format, and expected return fields. An agent has enough information to invoke the tool correctly for a Drosophila gene ID lookup.

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

Parameters4/5

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

The schema has no parameter description and 0% coverage, so the description must compensate. It does so by naming the parameter's role and providing a concrete example ID (FBgn0000015), giving the agent enough context to format the input correctly.

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?

States a specific action ('Get Drosophila gene by FlyBase ID') and names the resource. The description also lists the returned data fields and gives an example ID, making the tool's purpose unmistakable and distinct from search-oriented siblings.

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

Usage Guidelines3/5

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

The instruction to provide a FlyBase ID implies the tool is for use when the user already has a stable gene identifier. It does not explicitly mention alternatives like flybase_search or say when not to use this tool, so usage guidance is implied rather than explicit.

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

gene_enrichmentB

Gene ontology / pathway enrichment analysis (Enrichr engine). 对基因列表做 GO/KEGG/Reactome 通路富集分析,返回显著富集项(通路名/p值/校正p值/重叠基因)。For functional interpretation of omics / single-cell DEGs. 用于转录组/蛋白组/单细胞差异基因功能解读。

ParametersJSON Schema
NameRequiredDescriptionDefault
genesYes
libraryNoGO_Biological_Process_2021
max_termsNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.1/5.0
Behavior3/5

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

With no annotations provided, the description must disclose behavioral traits itself. It mentions the Enrichr engine and that it returns significant enrichment items, giving some insight into expected behavior. But it omits details like whether it requires network access, rate limits, or if the operation is read-only. Since the description says 'analysis,' it implies non-mutating, but that is not explicit.

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

Conciseness3/5

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

The description is bilingual, and the English and Chinese portions repeat the same information. This redundancy means not every sentence earns its place. The main purpose is front-loaded, but the repeated content makes it less concise than it could be.

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

Completeness2/5

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

Although an output schema exists (which covers return values), the description fails to explain the parameters' meanings, especially 'library' and 'max_terms.' Given that annotations are absent and schema coverage is nil for parameter descriptions, the definition is incomplete for an agent to confidently construct calls with non-default values.

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

Parameters1/5

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

Schema description coverage is 0%, so the description must explain parameters. It mentions 'genes' implicitly as 'gene list' and hints at 'library' via GO/KEGG/Reactome, but it does not clarify the 'library' parameter's role or the 'max_terms' parameter at all. The defaults are only in the schema. This is a significant gap for a tool with three parameters.

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

Purpose4/5

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

The description clearly states it performs gene ontology and pathway enrichment analysis using the Enrichr engine, and lists what it returns (significant enrichment terms with p-values and overlapping genes). However, it does not explicitly distinguish itself from sibling tools like kegg_pathway_search, reactome_pathway_search, or gene_go_annotation, all of which might overlap in purpose.

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?

The description provides a clear use case: 'For functional interpretation of omics / single-cell DEGs,' which tells the agent when this tool is appropriate. It does not, however, mention alternatives or conditions when NOT to use this tool, which would be needed for a perfect score.

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

gene_full_profileA

Combined multi-database gene analysis (cross-validation). 基因综合分析(多数据库交叉验证):给定基因符号,一次并发返回Ensembl 定位 + UniProt 蛋白注释 + STRING 互作伙伴 + PubMed 文献数,for project kickoff and functional overview. 适合开题调研、蛋白功能概述。

ParametersJSON Schema
NameRequiredDescriptionDefault
symbolYes
speciesNohomo_sapiens

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.9/5.0
Behavior3/5

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

No annotations are provided, so the description carries the behavioral disclosure burden. It discloses that the tool queries multiple databases concurrently ('一次并发返回') and frames itself as cross-validation, which is useful. However, it does not mention partial-failure behavior, rate limits, network dependence, or data freshness across the four external sources.

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

Conciseness4/5

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

The description is front-loaded with the core purpose and immediately lists the concrete output components. The bilingual repetition of the same idea is slightly redundant but does not introduce noise or obscure meaning.

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

Completeness4/5

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

For an aggregator with two parameters and an output schema, the description covers the core purpose, the output sources, and the intended scenario. The main gap is the under-documented `species` parameter and lack of caveats about external-database failure behavior, but an agent can still select and invoke it correctly.

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

Parameters3/5

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

Schema description coverage is 0%, so the description must compensate. It does clarify that `symbol` means a gene symbol, but it leaves `species` undocumented except for the schema default `homo_sapiens`. No guidance is given on valid species values or formatting.

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?

The description clearly states the tool performs combined multi-database gene analysis, enumerates the exact data sources (Ensembl, UniProt, STRING, PubMed), and says it returns several output categories concurrently. This distinguishes it from single-source siblings like ensembl_gene_lookup and uniprot_annotate.

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?

The description explicitly targets 'project kickoff and functional overview' / '开题调研、蛋白功能概述', which gives an agent a clear when-to-use context. It does not explicitly mention when not to use it or recommend alternative single-database tools for deeper analysis.

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

gene_go_annotationB

Get GO annotations for a gene product. 按基因产品 ID 查询其基因本体(GO)注释:输入如 UniProtKB:P04637(TP53),返回该基因的 GO 注释列表(GO ID、方面、限定词与证据),用于功能理解与富集分析。

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNo
aspectNo
gene_product_idYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.2/5.0
Behavior3/5

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

No annotations are provided, so the description carries the behavioral burden. It does disclose the return shape (GO annotations list with GO ID, aspect, qualifier, evidence), which is useful. However, it omits behavior around limits, aspect filtering, missing IDs, or error cases.

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

Conciseness4/5

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

The description is compact and front-loaded with the core action. The bilingual second sentence adds the concrete example and output detail, though it partially restates the first sentence. Overall it is efficient and not bloated.

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

Completeness3/5

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

The description provides a usable calling example and output summary, and an output schema exists to cover return details. However, it leaves parameter semantics for limit and aspect undocumented and lacks guidance relative to closely related tools, making it minimally adequate rather than fully complete.

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

Parameters2/5

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

Schema description coverage is 0%, and the description only clarifies gene_product_id with an example. The limit and aspect parameters are not explained at all, leaving the agent to infer their meaning from names and defaults alone.

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

Purpose4/5

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

The description uses a specific verb and resource ('Get GO annotations for a gene product'), provides a concrete input example (UniProtKB:P04637/TP53), and lists returned fields. It is clear and informative, though it does not explicitly distinguish itself from sibling tools like go_term_lookup or gene_enrichment.

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

Usage Guidelines3/5

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

The description implies usage for functional understanding and enrichment analysis, which gives some context. However, it does not state when to prefer this tool over related siblings, nor does it provide exclusions or alternative recommendations.

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

get_analysis_templateA

获取常见分析场景的模板方案。输入:场景类型(基因研究/药物发现/疾病分析等)。输出:模板化的分析流程和工具列表。

ParametersJSON Schema
NameRequiredDescriptionDefault
scenarioYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.6/5.0
Behavior3/5

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

No annotations are provided, so the description carries the full burden. It does disclose the read-like nature (“获取”) and the output shape (template analysis workflow and tool list), which is useful. It does not mention limitations, behavior on unsupported scenario values, or how the template is generated, so the disclosure is adequate but not rich.

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?

The description is two concise sentences with the main purpose front-loaded. The structured “输入/输出” breakdown adds clarity without repetition or fluff. Every sentence earns its place.

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

Completeness4/5

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

The tool has one required parameter, an output schema exists, and the description covers the main purpose, input, and output nature. The main missing piece is a definitive list of accepted scenario values, but the examples and output schema mitigate this gap for a tool of this simplicity.

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

Parameters3/5

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

The schema provides only a string parameter “scenario” with 0% description coverage, so the description must compensate. It gives examples of valid scenario types (gene research, drug discovery, disease analysis), giving the agent a general sense of valid input. It does not provide exact machine-readable keys or behavior for arbitrary values, so compensation is partial.

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

Purpose4/5

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

The description states a specific verb and resource: “获取常见分析场景的模板方案” (obtain template solutions for common analysis scenarios). It defines the output as a templated workflow and tool list, which clearly differentiates it from the sibling search/lookup tools even without naming one explicitly. It does not explicitly contrast with a sibling, keeping it short of a 5.

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

Usage Guidelines3/5

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

The “输入:场景类型(基因研究/药物发现/疾病分析等)” line implies when to use the tool: when the agent is faced with a common analysis scenario such as gene research or drug discovery. However, it does not explicitly state when not to use it, nor does it name alternative tools or describe a decision process between this and other tools.

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

glycan_lookupA

Look up a glycan structure by GlyTouCan accession. 按 GlyTouCan 编号查询糖苷结构:输入编号(如 G00051MO),returns composition/mass/monosaccharide count/sequence info. 返回糖苷组成、质量、单糖数与结构信息,用于糖组学研究。

ParametersJSON Schema
NameRequiredDescriptionDefault
glytoucan_acYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.9/5.0
Behavior3/5

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

There are no annotations, so the description carries the full burden. It discloses the core read-only nature ('look up') and the key returned fields. However, it does not mention what happens with invalid/unknown accessions, whether the accession format is validated, or any source/version details. This is adequate but not rich.

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

Conciseness3/5

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

The description is front-loaded with the English purpose and is not overly long, but it repeats the same information in Chinese, which adds redundancy for an AI agent. The structure is a single run-on sentence rather than cleanly separated clauses.

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

Completeness3/5

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

For a single-parameter lookup tool with an output schema, the description covers purpose, input format, and returned fields. It omits error behavior, identifier normalization, and relationship to similar glycan-related tools, leaving some gaps in operational context.

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

Parameters4/5

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

The input schema provides only a parameter name with 0% description coverage. The description compensates by explaining that the parameter is a GlyTouCan accession and gives a concrete example ('G00051MO'). It does not provide a full pattern or edge-case guidance, but the example makes the parameter usable.

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?

The description states a specific verb ('look up'), a specific resource ('glycan structure by GlyTouCan accession'), and enumerates the returned data (composition, mass, monosaccharide count, sequence info). This clearly distinguishes it from sibling lookup tools like lipid_lookup or protein_glycosylation.

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?

The description makes the intended context explicit: look up a glycan by its GlyTouCan accession, for glycomics research. It does not explicitly discuss when not to use this tool or mention alternative tools, but the input requirement and purpose are clear enough for an agent to select it appropriately.

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

go_term_lookupA

Look up a Gene Ontology term by GO ID. 按 GO 编号查询基因本体(GO)术语详情:输入 GO ID(如 GO:0006915),返回术语名称、所属方面(生物学过程/分子功能/细胞组分)、定义与同义词,用于理解基因功能注释含义。

ParametersJSON Schema
NameRequiredDescriptionDefault
go_idYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.9/5.0
Behavior4/5

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

With no annotations provided, the description carries the behavioral disclosure burden. It transparently states that this is a lookup operation and enumerates what will be returned, including the GO aspect categories. It does not discuss invalid ID handling, but for a simple read-only lookup the disclosed behavior is sufficient.

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?

The description is compact and front-loaded with the core action, followed by a useful expanded explanation with input example and output details. Every sentence contributes value, and the bilingual phrasing is not redundant.

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

Completeness4/5

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

For a single-parameter lookup tool with an output schema, the description is nearly complete: it gives the input format, the purpose, and the expected return fields. It could be slightly stronger by explicitly distinguishing from GO search tools, but this is a minor gap given the simplicity of the tool.

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

Parameters4/5

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

The schema has 0% parameter description coverage, so the description must compensate. It explicitly identifies the parameter as a GO ID and provides a concrete example (GO:0006915), which adds meaningful format guidance beyond the bare schema field name 'go_id'.

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

Purpose4/5

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

The description clearly states a specific action (look up) and resource (Gene Ontology term by GO ID), and even enumerates the returned fields (name, aspect, definition, synonyms). It does not explicitly differentiate from sibling tools like go_term_search, but the 'by GO ID' scoping makes the purpose clear.

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

Usage Guidelines3/5

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

The description implies the intended use case: when you have a GO ID and want details to understand gene function annotations. It does not explicitly say when to use this tool versus alternatives such as go_term_search or gene_go_annotation, nor does it provide exclusions.

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

gwas_gene_variantsA

Get GWAS variants associated with a gene. 按基因查询全基因组关联(GWAS)研究中与该基因关联的变异:输入基因符号(如 TP53),返回关联变异 rsID 列表,用于基因-变异-疾病关联研究。

ParametersJSON Schema
NameRequiredDescriptionDefault
geneYes
limitNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.1/5.0
Behavior4/5

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

Although no annotations are provided, the description frames the operation as a 'Get' lookup and explicitly states that it returns an rsID list, making the read-only nature and output shape clear. It does not describe default limit effects or no-result behavior, but those are minor for this simple query tool.

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

Conciseness4/5

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

The description is short and front-loaded with the main operation, while the Chinese expansion adds a concrete example, the output format, and an intended research use. The two sentences have some bilingual overlap but each contributes useful detail.

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

Completeness4/5

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

For a simple two-parameter lookup with an output schema, this description covers the tool's purpose, required input format, expected output type, and use case. It does not mention sibling alternatives or explain the limit parameter in depth, but the tool is simple enough that the description is reasonably complete.

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

Parameters3/5

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

Schema description coverage is 0%, so the description must compensate. It explains the `gene` parameter with a concrete example (TP53) but provides no added meaning for `limit`, which is only represented by its title and default value in the schema. The partial compensation is adequate but incomplete.

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?

The description clearly states the operation: 'Get GWAS variants associated with a gene,' then specifies the input as a gene symbol and the output as a list of associated variant rsIDs. This gene-centric framing distinguishes it from sibling tools like gwas_variant_associations, which appears variant-centric.

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?

The Chinese portion gives explicit usage context: query by gene symbol such as TP53 and use for gene-variant-disease association research. It does not explicitly mention when not to use the tool or name alternatives, stopping short of a 5.

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

gwas_variant_associationsA

Get GWAS associations for a variant by rsID. 按 rsID 查询变异的全基因组关联(GWAS)关联:输入 dbSNP 编号(如 rs73229090),返回该变体的关联性状、p 值、风险等位基因频率与效应量,用于遗传关联解读与孟德尔随机化(MR)研究。

ParametersJSON Schema
NameRequiredDescriptionDefault
rsidYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.2/5.0
Behavior3/5

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

With no annotations provided, the description carries the full burden of behavioral disclosure. It does reveal what the tool returns (associated traits, p-values, risk allele frequency, effect sizes), but it does not mention behavior for invalid or missing variants, evolutionary/population scope, or limitations of the source data. This is adequate but not thorough.

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

Conciseness4/5

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

The description is short and front-loaded with the core action. The bilingual repetition adds some length but the Chinese portion also contributes meaning by adding the output fields and use cases. No filler or off-topic content is present.

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?

This is a simple one-parameter lookup tool with an output schema available. The description covers purpose, lookup key, example input, output content, and intended applications. For the tool's complexity, this is complete enough for an agent to invoke it correctly.

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

Parameters4/5

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

The schema has only 'rsid' with no property description, and schema coverage is 0%. The description compensates by explaining that the input is a dbSNP number and provides a concrete example ('rs73229090'), which is sufficient for a single well-known identifier type. It could additionally specify strict format rules, but the example makes the intended input clear.

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?

The description states a specific verb ('Get'), a concrete resource ('GWAS associations for a variant'), and a precise lookup key ('by rsID'). It also gives an example rsID and names the returned data fields, making the tool's role unmistakable and distinguishing it from related tools like gwas_gene_variants.

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?

The description clearly frames when this tool is relevant: querying variant-level GWAS results for genetic association interpretation and Mendelian randomization studies. It does not explicitly name alternative tools for other use cases such as gene-level GWAS, so it falls just short of full exclusion guidance.

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

hgnc_gene_symbolA

Get detailed human gene information by HGNC approved symbol. Input: gene symbol (BRCA1, TP53). Output: Complete gene nomenclature data including aliases, chromosomal location, and previous symbols.

ParametersJSON Schema
NameRequiredDescriptionDefault
symbolYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.2/5.0
Behavior3/5

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

With no annotations provided, the description carries the full burden of behavioral disclosure. It describes the input format and the broad output categories (aliases, chromosomal location, previous symbols), which gives basic transparency, but it does not mention what happens for invalid or deprecated symbols, case sensitivity, or whether only current approved symbols are accepted.

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?

The description is three short sentences with no wasted words. It front-loads the core purpose, then cleanly separates input requirements and output contents, making it easy for an agent to parse quickly.

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

Completeness4/5

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

For a simple single-parameter lookup with an output schema available, the description is largely complete: it states the entity type, the required input format, and the nature of the returned data. It could be slightly stronger by pointing to hgnc_search for cases where the user only has a partial symbol or gene name, but this is a minor gap given the low complexity.

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

Parameters4/5

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

The input schema only provides a field named 'symbol' with 0% description coverage, so the description must compensate. It does so effectively by giving explicit examples ('BRCA1, TP53') and clarifying that the symbol must be an HGNC approved symbol, adding meaning beyond the bare schema.

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?

The description names a specific verb ('Get'), a specific resource ('detailed human gene information'), and the exact key ('HGNC approved symbol'). It also distinguishes itself from sibling tools like hgnc_search by emphasizing exact-symbol lookup rather than searching, and from rgd_gene_symbol by being human-specific.

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?

The description clearly establishes when to use the tool: when you already have an HGNC approved gene symbol such as BRCA1 or TP53. It does not explicitly mention alternatives or exclusion criteria, but the input requirement is specific enough that an agent can infer this is for exact approved-symbol lookup rather than fuzzy or cross-species searching.

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

intact_interactionsA

Search EBI IntAct experimentally-validated molecular interactions. 检索 IntAct 实验分子互作:输入基因或蛋白(如 TP53、P04637),returns interacting partners/detection method/evidence. 返回互作伙伴、检测方法与文献证据,用于验证蛋白互作网络。

ParametersJSON Schema
NameRequiredDescriptionDefault
queryYes
max_resultsNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.2/5.0
Behavior4/5

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

No annotations are provided, so the description carries the full behavioral burden. It discloses that this is a search operation and specifies the returned content types: interaction partners, detection method, and evidence. It also gives concrete identifier examples. It does not mention pagination or rate limits, but for a read-only search tool the core behavior is adequately disclosed.

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?

The description is compact, front-loaded with the core action and resource, and includes a bilingual restatement that also adds the validation use case. Every part contributes useful information, and no filler or redundant schema details appear.

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

Completeness4/5

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

For a simple two-parameter search tool with an output schema present, the description covers the query semantics, output contents, and an intended use scenario. It does not explicitly explain max_results or differentiate from other interaction-database siblings, but these are minor gaps given the output schema and simple nature of the tool.

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

Parameters3/5

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

Schema description coverage is 0%, so the description must compensate. It does clarify the query parameter with examples ('TP53', 'P04637') and maps it to gene or protein identifiers. However, max_results is not described at all; only its name and default value in the schema hint at its meaning. Thus the description partially compensates but leaves one parameter semantically under-specified.

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?

The description opens with a specific verb and resource: 'Search EBI IntAct experimentally-validated molecular interactions.' It clearly states what is returned—interacting partners, detection method, and evidence—and the qualifier 'experimentally-validated' helps distinguish it from predicted-interaction tools like string_interactions. The bilingual text reinforces the same precise purpose without ambiguity.

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?

The description gives a clear use case: '用于验证蛋白互作网络' (for validating protein interaction networks), and specifies acceptable inputs such as gene symbols or UniProt IDs. It does not explicitly state when to prefer this over sibling tools like string_interactions or biogrid_interactions, but the context is clear enough for basic tool selection.

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

intelligent_analyzeB

智能分析生物数据并推荐最佳分析方案,节省token使用。输入:数据字符串,可选分析目标。输出:数据类型识别、推荐工具、预期结果、insights等。

ParametersJSON Schema
NameRequiredDescriptionDefault
user_inputYes
analysis_goalNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.4/5.0
Behavior3/5

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

With no annotations, the description must carry behavioral weight. It does reveal that the tool is a recommender/planner rather than an executor: output includes 'recommended tool, expected results, insights,' and it advertises token savings. It stops short of disclosing limitations, accepted data formats, or whether any external queries are made.

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

Conciseness4/5

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

Very compact: one purpose sentence plus labeled input/output lists. No redundant content; key information is front-loaded. Minor markdown-like labels are structurally acceptable.

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

Completeness3/5

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

For a two-parameter router with an output schema, the core contract is present: input semantics, optional goal, and output categories. But in a 70-tool ecosystem, the description is thin on selection context and examples, so an agent might misuse it for direct analysis rather than planning.

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

Parameters3/5

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

Schema description coverage is 0%, but the description maps user_input to a 'data string' and analysis_goal to an 'optional analysis goal.' This adds moderate meaning beyond generic property titles, but it gives no format, example, length, or constraints.

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

Purpose4/5

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

The description identifies a clear verb-object pair: 'intelligently analyze biological data' and 'recommend the best analysis plan.' The output list (data type identification, recommended tool, expected results, insights) distinguishes it as an advisor/router from data-access siblings, though it never names a sibling or explicit exclusion.

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

Usage Guidelines3/5

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

The description implies the use case: when a user provides a biological data string and optionally a goal, and the agent wants to save tokens by getting a recommended plan. However, it does not state when not to use it, nor does it compare it to dedicated analysis tools or get_analysis_template.

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

kegg_pathway_genesA

List genes in a KEGG pathway. 查询 KEGG 通路包含的基因列表(如 hsa05224=Breast cancer),returns the genes in the pathway. 返回该通路下的基因,用于了解通路的分子组成。

ParametersJSON Schema
NameRequiredDescriptionDefault
pathway_idYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.7/5.0
Behavior3/5

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

No annotations are provided, so the description carries the burden. It clearly states the operation is a read-like list operation returning genes, which is the core behavior. It does not disclose potential limitations, such as whether the gene list contains symbols, Entrez IDs, or both, though the presence of an output schema mitigates this. There is no contradiction with annotations since none exist.

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

Conciseness2/5

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

The description repeats the same core statement in English and Chinese: 'List genes in a KEGG pathway', 'returns the genes in the pathway', and '返回该通路下的基因' all say essentially the same thing. The example and purpose are valuable, but the redundancy bloats an otherwise simple definition.

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

Completeness4/5

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

For a low-complexity tool with one required parameter and an output schema, the description is mostly complete. It names the resource type, gives an example pathway ID, and states the purpose. It could be improved with explicit guidance about pathway ID construction, but an agent can likely invoke the tool correctly with the information provided.

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

Parameters4/5

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

Schema description coverage is 0%, so the description must compensate for the undocumented pathway_id parameter. It does so by providing the example 'hsa05224=Breast cancer', which conveys both the format (organism-prefixed KEGG ID) and an example value. It could go further by explicitly stating the required format, but the example is enough for a single obvious parameter.

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?

The description uses a specific verb and resource: 'List genes in a KEGG pathway.' It clearly states the output as the gene list for that pathway and even gives an example pathway ID (hsa05224=Breast cancer), making the purpose unambiguous. This also distinguishes it from the sibling kegg_pathway_search, which searches for pathways rather than retrieving genes.

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

Usage Guidelines3/5

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

The description implies when to use the tool—when you need the genes belonging to a KEGG pathway, e.g., to understand the molecular composition of the pathway. However, it never explicitly addresses alternatives or when not to use this tool, such as preferring kegg_pathway_search when the goal is finding pathways.

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

lipid_lookupA

Look up LIPID MAPS lipid structure by LM ID. 按 LIPID MAPS 编号查询脂质结构:输入 LM 编号(如 LMFA01030001 花生四烯酸、LMGP01010001 磷脂酰胆碱),returns name/formula/SMILES/InChIKey/DB cross-refs. 返回名称、分子式、SMILES 与数据库交叉引用,用于脂质组学研究。

ParametersJSON Schema
NameRequiredDescriptionDefault
lm_idYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.9/5.0
Behavior3/5

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

With no annotations, the description carries the burden of behavior, and it discloses the lookup action and the returned fields (name/formula/SMILES/InChIKey/DB cross-refs). It does not mention behaviors such as exact-match requirement, case sensitivity, availability, rate limits, or error handling, but for a simple read lookup the core behavior is reasonably transparent.

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

Conciseness4/5

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

The description is compact and front-loaded, with the key action in the first phrase. The bilingual repetition adds length but is purposeful for the apparent Chinese-speaking user base; there is no filler.

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

Completeness4/5

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

For a single-parameter lookup with an output schema, the description covers what the tool does, what to provide, and what comes back (name/formula/SMILES/InChIKey/DB cross-refs). Minor omissions, such as exact matching behavior or acceptable LM ID formats beyond two examples, keep it from a 5.

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

Parameters4/5

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

The schema's lm_id parameter has no description (0% coverage), so the description is the only source of semantic meaning. It provides the identifier type (LM ID), concrete examples (LMFA01030001 arachidonic acid, LMGP01010001 phosphatidylcholine), and states the expected input pattern, which adequately compensates for the empty schema.

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?

The description names a specific operation ('Look up LIPID MAPS lipid structure'), the resource (LIPID MAPS), and the key identifier (LM ID), and enumerates returned fields (name/formula/SMILES/InChIKey/DB cross-refs). This is specific enough to distinguish it from sibling compound/metabolite tools like compound_info or chebi_compound.

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

Usage Guidelines3/5

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

The use case is implied through the examples and '用于脂质组学研究' (for lipidomics research), but no explicit guidance says when to prefer this tool over alternative compound/glycan/metabolite lookups. It gives clear context but no exclusions or alternative routing.

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

metabolomics_latestB

List latest EBI Metabolights metabolomics studies. 列出 Metabolights 最新的代谢组学研究编号,returns MTBLS accession list for browsing. 返回最新研究编号列表,便于浏览代谢组学数据。

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.1/5.0
Behavior3/5

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

With no annotations, the description carries the behavioral disclosure burden. It does convey that the tool returns only an accession list for browsing, which implies a read-only, summary-level operation. It does not mention ordering, pagination, or potential absence of results, but for a simple list tool these omissions are moderate rather than severe.

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

Conciseness2/5

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

The description repeats every core English clause in Chinese, so the same information is presented twice without adding anything. It front-loads the main action but uses roughly twice as many words as necessary, and the key output detail 'MTBLS accession list' is mixed into duplicated phrasing.

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

Completeness4/5

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

For a one-optional-parameter listing tool, the description identifies the data source, the type of identifiers returned, and the intended browsing purpose. An output schema exists, so return-structure details are covered outside the description. The main gaps are the lack of explicit sibling differentiation and limit semantics, but these are not crippling for this simple tool.

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

Parameters2/5

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

The input schema has a single `limit` parameter with zero description coverage, and the tool description does not mention it at all. The parameter name and default of 8 provide some meaning, but because schema coverage is low the description should have compensated by explaining how `limit` controls the returned list. It does not.

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

Purpose4/5

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

The description states a specific verb and resource: 'List latest EBI Metabolights metabolomics studies' and specifies the output as an 'MTBLS accession list.' The word 'latest' differentiates it from more detail-oriented metabolomics tools, though it does not explicitly name a sibling alternative.

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

Usage Guidelines3/5

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

The phrase 'for browsing metabolomics data' gives an implicit use context: this is a lightweight browsing/list tool for recent studies. However, it provides no explicit guidance about when to use it versus metabolomics_study or other study-detail alternatives, and no 'when not to use' conditions.

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

metabolomics_studyA

Get EBI Metabolights metabolomics study details. 查询 Metabolights 代谢组学研究:按 MTBLS 编号(如 MTBLS1),returns title/description/technology/design/factors. 返回研究标题、描述、检测技术(NMR/质谱)、实验设计与因子。

ParametersJSON Schema
NameRequiredDescriptionDefault
study_idYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.2/5.0
Behavior3/5

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

With no annotations provided, the description carries the full burden of behavioral disclosure. It does state the output fields and the query mechanism, which is reasonable transparency for a simple retrieval tool; however, it does not mention behavior for invalid IDs, missing studies, or any potential rate limits. This is a moderate disclosure, not a severe gap.

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

Conciseness4/5

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

The essential information is front-loaded: the source, the resource type, the identifier format, and the returned fields appear early. The bilingual repetition adds some redundancy, but it remains compact and does not obscure the key facts, so it is still reasonably concise.

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

Completeness4/5

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

For a low-complexity retrieval tool with one parameter and an output schema, the description covers the query mechanism, the source database, and the main returned content. It does not discuss edge cases like invalid accessions, but the presence of an output schema and the simple nature of the tool make this a minor omission.

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?

The input schema only provides a raw 'study_id' string with no description, so the description's explanation that it should be an MTBLS accession number (e.g., MTBLS1) is essential and highly valuable. It fully compensates for the 0% schema description coverage by defining the parameter format and giving a concrete example.

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?

The description clearly identifies the tool as retrieving EBI Metabolights metabolomics study details by MTBLS accession number, and explicitly lists the returned fields (title, description, technology, design, factors). This makes its purpose distinct from sibling tools like metabolomics_latest, which are not about retrieving a specific study by ID.

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?

The description states that the tool is used by supplying an MTBLS number such as MTBLS1, which is clear usage guidance for the intended scenario. It does not explicitly name alternative tools or state when not to use it, but the accession-based lookup instruction provides adequate context.

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

ncbi_fetch_sequenceB

Download nucleotide/protein sequences (FASTA) from NCBI. 从 NCBI 下载核酸/蛋白序列(FASTA),支持 accession、gene symbol、关键词。DB options: nucleotide/gene/protein. 数据库可选 nucleotide/gene/protein,for getting reference sequences for downstream analysis. 用于获取参考序列做下游分析。

ParametersJSON Schema
NameRequiredDescriptionDefault
dbNonucleotide
queryYes
max_idsNo
rettypeNofasta

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.2/5.0
Behavior3/5

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

No annotations are provided, so the description carries the full burden. It does disclose the core behavior: downloading FASTA sequences and supporting accession/gene symbol/keyword queries, with selectable databases. However, it omits details such as result count limits, rate limits, or what happens for ambiguous queries across the different database options.

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

Conciseness2/5

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

The description is front-loaded with the key action, but it repeats nearly every statement in both English and Chinese, adding redundant text without additional information. This bilingual duplication makes it less concise than it should be for an AI agent consuming the definition.

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

Completeness2/5

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

An output schema exists, so return-value documentation is not required, but the tool is otherwise under-specified. The description does not explain max_ids behavior, rettype semantics, or provide when-to-use guidance relative to sibling tools. An agent would still need to infer or probe several invocation details.

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

Parameters2/5

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

Schema description coverage is 0%, so the description must compensate. It partially explains 'query' (supports accession, gene symbol, keyword) and 'db' (nucleotide/gene/protein), but it does not explain 'max_ids' or 'rettype'. An agent cannot fully understand the effect of changing these parameters from the description alone.

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?

The description clearly states the action ('Download'), the resource ('nucleotide/protein sequences (FASTA) from NCBI'), and the supported query types. It is distinct enough from siblings like pubmed_search or blast_search because it uniquely identifies NCBI sequence retrieval with FASTA output.

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

Usage Guidelines3/5

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

The description gives contextual purpose ('for getting reference sequences for downstream analysis') and mentions database options, but it does not explicitly state when to use this tool versus alternatives like ENA sequence search or BLAST. There are no exclusion criteria or alternative tool references.

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

pdb_structure_summaryC

Get protein structure summary from PDB. 按 PDB ID 获取蛋白质结构摘要:title/resolution/method/organism/deposition date and chain sequence. 标题/分辨率/实验方法/物种/沉积日期及指定链序列,for structural biology and drug design. 用于结构生物学、药物设计的结构查询。

ParametersJSON Schema
NameRequiredDescriptionDefault
pdb_idYes
chain_idNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.9/5.0
Behavior3/5

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

With no annotations, the description carries the burden of explaining behavior. It does disclose what the tool returns (title, resolution, method, organism, deposition date, chain sequence), which is useful. However, it does not describe error behavior, input validation, rate limits, or explicitly confirm read-only semantics beyond the verb 'Get'.

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

Conciseness2/5

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

The description is front-loaded with the main purpose, but it repeats nearly the same content in English and Chinese across multiple clauses. The field list and intended use case each appear twice, so not every sentence earns its place.

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

Completeness3/5

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

The tool is simple, has an output schema, and the description covers both parameters at a basic level. An agent could likely call it correctly, but the lack of usage guidance, input format specifics, and behavioral details leaves moderate gaps for a tool with no annotations.

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

Parameters3/5

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

Schema description coverage is 0%, so the description must compensate. It does explain pdb_id as a PDB identifier and hints at chain_id through 'specified chain sequence' / '指定链序列', but it does not clarify format constraints or what 'default chain' means. The schema provides the default but not the underlying semantics.

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

Purpose4/5

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

The description opens with a specific verb and resource ('Get protein structure summary from PDB') and enumerates the returned fields: title, resolution, method, organism, deposition date, and chain sequence. It is clear and unambiguous, but it does not explicitly distinguish itself from sibling tools like alphafold_structure or emdb_structure_lookup.

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

Usage Guidelines2/5

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

The description gives a domain context ('for structural biology and drug design') but provides no guidance on when to choose this tool over alternatives. There are no exclusions, no mention of when another PDB-related or structure tool would be more appropriate, and no prerequisites are stated.

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

plant_gene_lookupA

Look up plant gene information via Ensembl Plants. Input: gene symbol (e.g. AT1G01010, AGL1), plant species (e.g. arabidopsis/rice/maize/wheat/soybean). Output: gene ID, description, biotype, genomic location. 植物基因查询:通过 Ensembl Plants 查询植物基因信息(拟南芥/水稻/玉米/小麦/大豆等)。

ParametersJSON Schema
NameRequiredDescriptionDefault
symbolYes
speciesNoarabidopsis_thaliana

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.1/5.0
Behavior3/5

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

With no annotations, the description carries the behavioral disclosure burden. It discloses the data source (Ensembl Plants), the read-only nature ('Look up'), and the returned output fields. However, it does not address exact-match behavior, ambiguity, error handling, or access/rate limits.

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

Conciseness4/5

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

The English description is compact, front-loaded, and well-structured with clear input/output labeling. The trailing Chinese sentence repeats most of the English content, adding mild redundancy for an English-reading agent.

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

Completeness4/5

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

For a simple two-parameter lookup with an output schema available, the description covers purpose, source, input examples, and output fields. Missing exact species identifier formats and explicit sibling routing are minor gaps but do not make the tool unusable.

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

Parameters4/5

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

The schema has no property descriptions, but the description compensates with concrete examples: gene symbol formats like AT1G01010/AGL1 and species values like arabidopsis/rice/maize/wheat/soybean. It loses a point because these common-name species examples may not match the exact schema default `arabidopsis_thaliana`, creating potential value-format ambiguity.

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?

The description opens with a specific verb and resource: 'Look up plant gene information via Ensembl Plants.' The plant+Ensembl Plants scope clearly distinguishes it from generic Ensembl lookup siblings, and the example species and gene symbols reinforce the tool's domain.

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?

The description gives clear context by specifying that this is for plant gene lookup and lists valid species and symbol examples. It does not explicitly name sibling alternatives or state when not to use it, so it stops short of a 5.

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

plant_species_listA

List supported plant species for BioMCP plant gene lookup. Input: none. Output: common plant species names mapped to Ensembl species IDs. 列出支持的植物物种及其对应 Ensembl 物种名。

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.1/5.0
Behavior4/5

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

With no annotations provided, the description carries the full burden of behavioral disclosure. It explicitly states 'Input: none' and describes the output as 'common plant species names mapped to Ensembl species IDs', making the operation's scope and result format clear. While it does not discuss potential errors or data freshness, for a parameterless list tool this is substantial transparency.

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

Conciseness4/5

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

The English description is compact and front-loaded with the core purpose in the first sentence. However, the Chinese sentence largely duplicates the output description ('列出支持的植物物种及其对应 Ensembl 物种名'), introducing minor redundancy. It remains appropriately sized and scannable.

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

Completeness4/5

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

For a simple tool with no parameters and a dedicated output schema, the description covers the essential aspects: purpose, input, and output format. It could be slightly more explicit about how the species list integrates with plant_gene_lookup, but the provided context is sufficient for correct invocation in most cases.

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

Parameters4/5

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

There are zero parameters and the schema properties are empty, so the baseline is 4. The description reinforces this by stating 'Input: none', which removes any ambiguity about whether arguments are expected. No further parameter explanation is needed.

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?

The opening phrase 'List supported plant species for BioMCP plant gene lookup' uses a specific verb (List) and resource (supported plant species), and clearly states the tool's role within the BioMCP plant gene workflow. It distinguishes itself from sibling tools like plant_gene_lookup by focusing on the enumeration of supported species rather than gene queries.

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

Usage Guidelines3/5

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

The description implies usage context ('for BioMCP plant gene lookup') but does not explicitly state when to use this tool versus alternatives, nor does it mention any exclusion conditions. An agent must infer that this list should be consulted before querying plant_gene_lookup, which is a plausible but not explicitly stated workflow.

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

pride_projectA

Get PRIDE proteomics project by ID. 按项目 ID 获取蛋白质组学项目:输入 PXD 项目编号(如 PXD000001),返回项目标题、摘要、物种、实验类型与数据文件,用于蛋白质组学数据获取。

ParametersJSON Schema
NameRequiredDescriptionDefault
project_idYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.2/5.0
Behavior4/5

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

No annotations are provided, so the description carries the burden of behavioral disclosure. It clearly states what the tool returns (project title, abstract, species, experimental type, data files) and its intended purpose. It does not cover failure modes or response formatting details, but for a simple ID-based fetch this is adequate.

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

Conciseness4/5

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

The description is compact and front-loaded with the core operation and resource. The bilingual repetition adds a slight redundancy, but it remains only two sentences and contains no filler or irrelevant detail.

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

Completeness4/5

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

For a single-parameter, read-only fetch-by-ID tool with an output schema available, the description supplies the essential information: the input format, the resource, and the expected return categories. The only notable gap is not explicitly mentioning the pride_search sibling as the appropriate tool when the ID is unknown.

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?

The input schema provides no property descriptions, so schema description coverage is 0%. The description compensates fully by specifying the parameter format ('PXD project number') and giving a concrete example ('PXD000001'), which tells an agent exactly how to construct a valid call.

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?

The description states a specific operation ('Get'), a specific resource ('PRIDE proteomics project'), and a precise lookup key ('by ID'). It also enumerates the returned content (title, abstract, species, experiment type, data files), making the tool's purpose unambiguous. The 'by ID' phrasing also distinguishes it from the sibling pride_search tool without needing an explicit comparison.

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

Usage Guidelines3/5

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

The usage context is implied: use this tool when you already have a PXD project ID and need project details. However, it does not explicitly say when not to use it or point users to pride_search for query-based discovery, so the guidance is reasonably clear but not fully explicit about alternatives.

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

protein_domainsB

Query protein structural domains from InterPro. 查询蛋白的 InterPro 结构域/家族/位点注释(输入 UniProt accession),returns domain name/type for functional region analysis. 返回结构域名、类型与位置,用于蛋白功能区域分析。

ParametersJSON Schema
NameRequiredDescriptionDefault
uniprot_accYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the input and output types, but does not disclose data source updates, error behavior, rate limits, or other operational characteristics. The bilingual text adds no behavioral detail beyond what is already stated.

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

Conciseness3/5

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

The description is reasonably compact, but the English and Chinese sentences are near-duplicates, adding length without new information. The front-loaded English sentence is clear, but the repetition could be trimmed.

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

Completeness3/5

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

Given the output schema and single required parameter, the description is adequate for basic use, but it lacks richer context such as the meaning of domain types, example accessions, or how results integrate with other protein-focused tools. Some gaps remain for an agent navigating a large sibling set.

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

Parameters4/5

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

Schema description coverage is 0%, so the description must compensate. It does specify the parameter format (UniProt accession) and the output semantics (domain name, type, position). With only one parameter, this is sufficient for correct invocation.

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

Purpose4/5

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

The description clearly states a specific verb (query) and resource (protein structural domains from InterPro), and specifies the input (UniProt accession) and output (domain name/type/location). It does not explicitly differentiate from closely related protein tools, but the InterPro domain focus is distinctive.

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

Usage Guidelines2/5

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

The description implies use for functional region analysis but provides no explicit when-to-use or when-not-to-use guidance. It does not reference alternatives like uniprot_annotate or protein_tissue_expression, nor mention prerequisites or exclusions.

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

protein_glycosylationA

Look up protein glycosylation and glycan sites. 查询蛋白的糖基化信息:按 UniProt 编号(如 P04637),returns protein names/glycosites/glycan modifications. 返回蛋白名称、糖基化位点与糖修饰信息,用于糖蛋白研究。

ParametersJSON Schema
NameRequiredDescriptionDefault
uniprot_accYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.5/5.0
Behavior3/5

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

With no annotations provided, the description carries the full burden and does state what is returned (protein names, glycosites, modifications), implying a read-only lookup. It does not disclose behavior on invalid accessions, coverage limits, or whether only curated entries are returned, which would add transparency.

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

Conciseness3/5

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

The description is front-loaded with the English purpose, and is short overall. However, the Chinese sentences largely repeat the same information, so not every sentence adds new content; a single bilingual summary or key details only would be more efficient.

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

Completeness4/5

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

For a simple one-parameter lookup with an output schema present, the description covers the required input, expected output fields, and intended research use. It could mention limitations or relationship to glycan_lookup, but the basics for correct invocation are all present.

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

Parameters4/5

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

The input schema has 0% description coverage, but the description compensates by naming the parameter's semantic type ('按 UniProt 编号') and giving a concrete example ('如 P04637'). It still lacks explicit format/validation details, but for a single accession parameter this is sufficient.

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

Purpose4/5

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

Description clearly states the action ('Look up'), the resource ('protein glycosylation and glycan sites'), and the expected output ('protein names/glycosites/glycan modifications'). It does not explicitly differentiate itself from overlapping siblings such as glycan_lookup or protein_domains, so it misses the top score.

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

Usage Guidelines3/5

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

The description provides a clear use context: query by UniProt accession (e.g. P04637) for glycoprotein research. However, it does not say when not to use it or name alternatives like glycan_lookup, leaving routing partially to the agent.

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

protein_tissue_expressionB

Get Human Protein Atlas tissue expression profile. 查询蛋白组织表达图谱:按 Ensembl 基因号(如 ENSG00000141510),returns tissue-specific RNA/protein expression and localization. 返回组织特异性表达、亚细胞定位、蛋白分类与疾病关联。

ParametersJSON Schema
NameRequiredDescriptionDefault
ensembl_idYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.3/5.0
Behavior3/5

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

No annotations are provided, so the description carries the burden of explaining behavior. It does disclose the data source, input type, and output contents (tissue-specific expression, subcellular localization, classification, disease associations). However, it does not mention limitations such as human-only data coverage or behavior for invalid/missing Ensembl IDs.

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

Conciseness3/5

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

The opening English sentence is clear and front-loaded, but the Chinese portion largely duplicates the same information. The bilingual repetition adds length without adding much new substance, making it adequate but not maximally efficient.

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

Completeness4/5

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

The tool is simple: one required parameter and an output schema already exists. The description provides the identifier format, data source, and what the result contains, which is enough for an agent to invoke it correctly. Remaining gaps, such as error behavior, are minor for this type of lookup tool.

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

Parameters4/5

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

The schema provides only a parameter name with 0% description coverage, so the description must compensate. It does so by specifying that the parameter is an Ensembl gene ID and giving a concrete example (ENSG00000141510), which is sufficient for a single-parameter tool.

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

Purpose4/5

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

The description clearly identifies the tool as retrieving Human Protein Atlas tissue expression profiles by Ensembl gene ID, with a specific verb and resource. It does not explicitly distinguish itself from similar-looking siblings such as expression_atlas_gene or gene_full_profile, so it stops short of full differentiation.

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

Usage Guidelines2/5

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

The description gives an example Ensembl ID and states the query type, but it provides no guidance on when to choose this tool over alternatives. There is no mention of exclusions, prerequisites, or comparison with sibling tools like expression_atlas_gene.

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

rgd_gene_symbolA

Get rat gene by gene symbol. 按基因符号获取大鼠基因信息:输入大鼠基因符号(如 Brca1/Tp53),返回基因名称、符号、染色体位置、功能注释与别名,用于大鼠遗传学研究。

ParametersJSON Schema
NameRequiredDescriptionDefault
symbolYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.9/5.0
Behavior3/5

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

No annotations are provided, so the description carries the full burden of behavioral disclosure. It does disclose the input format (gene symbol with Brca1/Tp53 examples) and the return contents (gene name, symbol, chromosome location, functional annotation, aliases), which establishes this as a read-style lookup. However, it does not address edge-case behavior: exact vs. partial matching, case sensitivity, what happens for non-rat symbols, or error handling for invalid input.

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

Conciseness4/5

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

The description is compact and front-loaded: the English sentence states the core operation first, and the Chinese segment adds input format and return-field detail. There is mild redundancy from bilingual repetition, but each sentence earns its place — no filler, no schema echo.

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

Completeness4/5

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

For a simple single-parameter lookup with an output schema present, the description covers the essentials: purpose, input format with examples, and return contents. The output schema handles precise return typing. Minor gaps remain (failure modes, explicit tool-selection guidance against rgd_search/hgnc_gene_symbol), but nothing an agent needs to make a correct call is fundamentally missing.

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

Parameters4/5

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

Schema description coverage is 0% — the symbol property has only a title, no description. The tool description compensates well by naming the parameter's meaning ('输入大鼠基因符号') and giving two concrete real-world examples (Brca1/Tp53). This is meaningful added value beyond the bare schema. It does not specify format constraints, but for a single gene-symbol string the examples largely carry the semantic load.

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?

The description opens with a specific verb+resource statement — 'Get rat gene by gene symbol' — that clearly identifies the operation and its input. The organism qualifier ('rat') distinguishes it from sibling lookups like hgnc_gene_symbol (human), flybase_gene, and wormbase_gene, so an agent can recognize it without opening the schema.

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

Usage Guidelines3/5

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

The description implies usage context by stating the tool is '用于大鼠遗传学研究' (for rat genetics research) and specifies the input type (rat gene symbol). However, it provides no explicit when/when-not guidance or alternatives, even though closely related siblings exist (rgd_search for broader RGD queries, hgnc_gene_symbol for human genes). The context is clear but the exclusion logic is left to inference.

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

string_interactionsB

Query protein interaction network from STRING-db. 查询蛋白互作网络(STRING-db):给定一个或多个蛋白,返回互作关系及分数(综合分数越高越可信),for protein functional network analysis. 用于蛋白功能网络分析。

ParametersJSON Schema
NameRequiredDescriptionDefault
speciesNo
proteinsYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.4/5.0
Behavior3/5

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

No annotations exist, so the description carries the full disclosure burden. It does reveal the read-only query nature and adds genuinely useful interpretive context (higher combined score = more reliable). However, it is silent on result limits, confidence thresholds, whether predicted vs. experimental interactions are included, and behavior for unknown or invalid proteins.

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

Conciseness3/5

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

The description is compact at roughly four short clauses but is bilingual with visible repetition: the query statement and the use case appear twice ('for protein functional network analysis' / '用于蛋白功能网络分析'). The Chinese half contributes non-redundant detail (input cardinality, score interpretation), so waste is limited, but an agent must parse both languages to obtain the complete picture.

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

Completeness3/5

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

For a low-complexity 2-parameter tool with an output schema (which covers return structure), the description captures the core query behavior, input cardinality, and result interpretation. However, the species parameter being entirely undocumented is a material gap for a multi-species database like STRING, and the absence of annotations leaves operational behavior (limits, failure modes) undisclosed.

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

Parameters2/5

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

Schema description coverage is 0%, so the description must compensate. It adds real meaning for the proteins parameter ('给定一个或多个蛋白' — one or more proteins) and explains the output scoring, but it never addresses the species parameter (default 9606, without stating it is a taxonomy ID or that 9606 is human) or the accepted identifier format (UniProt vs. gene symbols). These are both needed for correct invocation.

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?

States a specific verb ('Query'), a precise resource ('protein interaction network from STRING-db'), and the input-output contract (one or more proteins → interaction relationships with reliability scores). Naming STRING-db distinguishes it from interaction siblings like intact_interactions and biogrid_interactions, and the score-semantics note clarifies it is a scored network query, not a sequence or literature search.

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

Usage Guidelines3/5

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

The description implies the usage context ('for protein functional network analysis' / '用于蛋白功能网络分析') and scopes the tool to STRING-db data, but it never states when not to use it or names alternatives. With multiple protein-interaction resources among the siblings (intact_interactions, biogrid_interactions, biogrid_gene_interactions), an agent receives no guidance on choosing between them.

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

taxonomy_lookupA

Look up NCBI Taxonomy species classification. 查询 NCBI Taxonomy 物种分类:输入物种名或 taxid(如 9606、human),returns scientific/common name, rank and lineage. 返回学名、常用名、分类层级与谱系,用于确认物种的官方分类。

ParametersJSON Schema
NameRequiredDescriptionDefault
queryYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.5/5.0
Behavior4/5

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

With no annotations provided, the description carries the behavioral transparency burden. It clearly describes a read-only lookup behavior, names the data source, lists the returned data fields, and gives concrete input examples. It does not discuss edge cases like no matches or multiple hits, but for a simple lookup tool this is sufficient.

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

Conciseness4/5

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

The description is short and front-loaded with the action and resource. The bilingual repetition adds length, but it also broadens accessibility and does not obscure the key information. Every meaningful element—purpose, input format, and output fields—is present without fluff.

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?

For a one-parameter lookup tool, the description is complete: it defines the accepted query formats, the data source, the returned fields, and the intended purpose. An output schema exists and no nested/enum complexity is present, so nothing critical is missing for an agent to select and invoke this tool.

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?

Schema description coverage is 0%, so the description is the only source of parameter meaning. It fully compensates by explaining that the 'query' parameter accepts either a species name or a NCBI taxid, and provides concrete examples (9606, human). This is exactly what an agent needs to call the tool correctly.

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?

The description uses a specific verb ('Look up') and a clear resource ('NCBI Taxonomy species classification'), and states the returned fields: scientific/common name, rank, and lineage. This makes it easy for an agent to distinguish this tool from the many sibling tools, none of which target NCBI taxonomy classification.

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?

The description gives a clear use context: confirm the official classification of a species, and specifies accepted inputs (species name or taxid, e.g., 9606, human). It does not explicitly name alternatives or exclusion conditions, but no close taxonomic sibling exists and the context is clear enough.

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

tool_inventoryA

List all BioMCP tools with their data source and verification status. 列出全部 BioMCP 工具及其数据源、验证状态(e2e_verified 已端到端验证 / best_effort 尽力而为未验证),并标注需要额外配置的工具。用于了解每个工具的可信度,避免过度信任未经证实的端点。

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.4/5.0
Behavior4/5

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

With no annotations provided, the description carries the behavioral disclosure burden. It transparently states what the tool lists and the distinction between e2e_verified and best_effort statuses. It also mentions that tools needing extra configuration are highlighted. It does not discuss side effects, but as a zero-parameter listing tool, the disclosed behavior is sufficient.

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

Conciseness4/5

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

The description is concise and front-loaded with the core function. The bilingual repetition adds minor length but serves accessibility and does not introduce fluff. Every sentence contributes either what the tool does or when it should be used.

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?

For a zero-parameter tool with an output schema provided, the description is complete: it explains the tool's purpose, the categories it reports, and the use case. There is no missing information that would prevent a agent from selecting or invoking the tool correctly.

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

Parameters4/5

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

The tool has zero parameters and the schema coverage is 100%, so no additional parameter explanation is needed. The baseline score for zero-parameter tools is 4, and the description adds no unnecessary parameter details, appropriately.

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?

The description uses a specific verb and resource: 'List all BioMCP tools with their data source and verification status'. It clearly differentiates this tool from the sibling tools, all of which are domain-specific searches, by marking it as a meta-level inventory tool. The bilingual text reinforces the exact output contents (data source, verification status, extra configuration needs).

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?

The description states when to use the tool: to understand the credibility of each tool and avoid over-trusting unverified endpoints. It provides clear usage context, though it does not explicitly name alternatives or exclusions. Since it is a meta-inventory tool with no obvious sibling competitor, the lack of explicit alternatives is acceptable.

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

ucsc_genome_infoC

Query UCSC Genome Browser. 查询 UCSC 基因组浏览器信息:list available genome assemblies or inspect one (e.g. hg38/GRCh38) and its gene annotation tracks. 列出可用组装,或查看某组装及其基因注释轨道,for genomics research. 用于基因组学研究。

ParametersJSON Schema
NameRequiredDescriptionDefault
assemblyNo
list_tracksNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

C2.8/5.0
Behavior2/5

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

With no annotations provided, the description carries the full burden of behavioral disclosure. It conveys a read-only query/inspect operation, but it does not state what happens when assembly is empty versus set, whether list_tracks changes the response, or any external API characteristics, limits, or side effects.

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

Conciseness2/5

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

The description is short and front-loaded, but it repeats the same content in English and Chinese, including the list/inspect functionality and the 'for genomics research' purpose. Later sentences do not add enough new information to justify the duplication.

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

Completeness2/5

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

Given no annotations and 0% schema description coverage, the definition leaves important mode-selection and parameter semantics implicit. The presence of an output schema helps with return values, but the agent still lacks guidance on when to set list_tracks, how assembly selection behaves, and how this tool compares to related assembly/genome tools.

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

Parameters2/5

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

Schema description coverage is 0%, so the description must compensate. It gives an example assembly value (hg38/GRCh38) and mentions gene annotation tracks, but it never explains the list_tracks boolean parameter or the default behavior when assembly is omitted.

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?

The description names UCSC Genome Browser as the resource and clearly states two modes: listing available genome assemblies or inspecting one assembly and its gene annotation tracks. This is specific enough to distinguish the tool from generic genome/assembly siblings like genome_assembly_search or ensembl_gene_lookup.

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

Usage Guidelines2/5

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

There is no explicit guidance on when to use this tool over alternatives. The phrase 'for genomics research' is too generic and does not help an agent choose between this and the many other genomics-related sibling tools. No when-not-to-use conditions or alternative tool mentions are provided.

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

unichem_mappingA

Query compound identifier mapping across databases by InChIKey. 按 InChI Key 查询化合物在多个数据库(ChEMBL/PubChem/DrugBank/ChEBI 等)中的标识符映射:输入标准化化学标识符 InChI Key,返回该化合物在各化学数据库中的对应 ID,用于跨数据库化合物查询与整合。

ParametersJSON Schema
NameRequiredDescriptionDefault
inchikeyYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.9/5.0
Behavior3/5

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

With no annotations provided, the description carries the burden of explaining behavior. It states that the tool returns corresponding database IDs for an InChIKey and includes the list of databases, but it does not disclose edge-case behavior such as no-match results, multiple mappings per database, or whether the input must be a canonical InChIKey.

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

Conciseness4/5

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

The English lead sentence states the core function concisely, and the Chinese sentence adds specific database examples and the intended use case. The bilingual duplication is slightly redundant but does not bloat the description.

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

Completeness4/5

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

For a single-parameter lookup with an output schema available, the description covers the input, the databases involved, and the purpose. It does not need to enumerate return fields, but a brief note about not-found or multi-mapping behavior would have made it complete.

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

Parameters4/5

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

Schema description coverage is 0%, so the description must compensate. It effectively identifies the single parameter as a 'standardized chemical identifier InChIKey' and explains its role as the query input. It could add exact format or normalization details, but for one simple string parameter the description is adequate.

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?

The description uses a specific verb ('Query') and clearly identifies the resource: compound identifier mapping across databases by InChIKey. It also names concrete target databases (ChEMBL/PubChem/DrugBank/ChEBI), which differentiates it from sibling compound-related tools such as unichem_structure or chembl_drug_search.

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

Usage Guidelines3/5

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

The description provides an explicit use case ('for cross-database compound query and integration'), so an agent can infer when to use it. However, it does not explicitly state when not to use it or how it compares to alternatives like unichem_structure or compound_info.

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

unichem_structureA

Look up compound cross-references by InChI Key via UniChem. 按 InChI Key 查询化合物的跨库引用详情:返回该化合物在 UniChem 登记的化学数据库及对应标识符(来源/ID 列表),用于结构与标识符验证。

ParametersJSON Schema
NameRequiredDescriptionDefault
inchikeyYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.6/5.0
Behavior3/5

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

With no annotations, the description must disclose behavior itself. It does state that the tool returns a list of databases and identifiers registered in UniChem, which is useful. However, it does not mention input format expectations, error behavior, rate limits, or explicitly confirm it is read-only beyond the verb 'look up'.

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

Conciseness4/5

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

The description is short and front-lows the key operation in English, then the Chinese sentence adds return-value detail and purpose. The bilingual repetition is slightly redundant but not bloated; each sentence contributes either the operation or the output/purpose.

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

Completeness4/5

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

For a simple single-parameter lookup tool, the description gives the operation, the input key type, the output type (source/ID list), and a purpose. An output schema exists, so return-value details do not need to be fully restated. It still lacks explicit differentiation from the sibling UniChem tool, which would improve completeness.

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

Parameters4/5

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

The schema only defines 'inchikey' as a string with no description, so the description's clarification that the parameter is an InChI Key and the query is by that key adds meaningful semantic value. It could go further with format or example, but it sufficiently compensates for the 0% schema description coverage.

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

Purpose4/5

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

The description clearly identifies a specific action ('look up') and resource ('compound cross-references via UniChem'), and specifies the input key. However, it does not explicitly distinguish this from the sibling tool 'unichem_mapping', which likely overlaps in the UniChem identifier-mapping space.

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

Usage Guidelines3/5

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

The Chinese phrase '用于结构与标识符验证' gives an implied use case, suggesting this is for structure and identifier validation, but no explicit when-to-use, when-not-to-use, or alternative tool guidance is provided. It relies on the user to infer the right context.

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

uniparc_by_idA

Get UniParc record details by UPI ID. 按 UPI 编号查询 UniParc 记录详情:输入 UPI 编号(如 UPI0000123165),returns sequence length/sequence/cross-references. 返回序列长度、序列本体与全部交叉引用数据库。

ParametersJSON Schema
NameRequiredDescriptionDefault
upiYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.2/5.0
Behavior4/5

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

No annotations are provided, so the description carries the full burden. It clearly indicates a read-only retrieval and lists the specific data returned (sequence length, sequence, cross-references), which is transparent enough for a simple lookup. It omits error behavior and data-source caveats, but these are minor for an ID-based fetch.

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

Conciseness4/5

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

The descripotion is compact and front-loaded with the most essential information. The Chinese sentence is largely a duplocate of the English sentence and adds limited new value ('all' for cross-references), creating minor redundancy without bloating the overall size.

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

Completeness4/5

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

With an output schema present and only one required parameter, the description covers the input contract and highlights the main output fields. It does not mention the prerequisite that a UPI ID must already be known or direct the user to uniparc_search for ID discovery, which would fully round out the interaction flow.

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?

Schema coverage is 0%, and the description fully compensates by explaining the single parameter 'upi': it states the input is a UPI number and provides a concrete example (UPI0000123165). This gives an agent everything needed to format the argument correctly.

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?

The description opens with a specific verb and resource: 'Get UniParc record details by UPI ID.' It also enumerates the return payload (sequence length, sequence, cross-references), which makes the tool's function unambiguous and distinguishable from a search-oriented sibling like uniparc_search.

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

Usage Guidelines3/5

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

The phrase 'by UPI ID' implies the tool should be used when an ID is already known, but it never states this condition explicitly. It does not reference a sibling like uniparc_search for discovering IDs, nor does it provide any when-to-use or when-not-to-use guidance.

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

uniprot_annotateA

Query UniProt protein annotations. 查询 UniProt 蛋白注释:protein name/gene/organism/length/function/Gene Ontology. 蛋白名/基因/物种/长度/功能/GO 项,支持 accession(如 P04637)或基因名检索,for protein function interpretation. 用于蛋白功能解读。

ParametersJSON Schema
NameRequiredDescriptionDefault
queryYes
max_resultsNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A3.6/5.0
Behavior3/5

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

No annotations are present, so the description carries the behavioral transparency burden. It does disclose the read-only nature ('Query'), the supported identifier types, and the annotation fields returned. It does not disclose result-count behavior, error handling, ambiguity of gene-name queries, or any UniProt API limitations, but the core behavior is reasonably clear.

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

Conciseness4/5

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

The description is compact and front-loaded with the core action and resource. The English and Chinese versions mirror each other, which adds some redundancy, but the overall length is still appropriate and the essential information appears early.

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

Completeness3/5

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

For a relatively simple lookup tool with an output schema, the essentials are present: what is queried, which query forms are supported, and which annotation fields come back. It is incomplete in that `max_results` behavior is not addressed and no guidance is given on disambiguating gene-name queries, but this is a minor gap 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.

Parameters3/5

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

Schema description coverage is 0%, so the description must compensate. It meaningfully explains the `query` parameter by saying accession or gene-name search is supported and gives an accession example (P04637). The `max_results` parameter is not described, though its name, type, and default make its purpose reasonably inferable.

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?

The description clearly states a specific verb ('Query'), a specific resource ('UniProt protein annotations'), and enumerates the annotation fields returned (protein name, gene, organism, length, function, Gene Ontology). It also states supported query forms (accession or gene name), which differentiates it from generic protein or sequence tools like uniparc_search or protein_domains.

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

Usage Guidelines3/5

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

The description gives an explicit use context: 'for protein function interpretation' / '用于蛋白功能解读', which implies when an agent should reach for this tool. However, it names no alternatives and gives no exclusions or conditions for when another UniProt-related or annotation tool would be more appropriate.

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

variant_annotateA

Annotate human genetic variants (MyVariant.info). 注释人类基因变异:输入 HGVS(如 chr13:g.32911145G>A)或 rsID,returns allele frequency (GnomAD/1000G), functional predictions (SIFT/PolyPhen), gene and clinical significance. 返回人群频率、功能预测、基因与临床意义,for variant interpretation. 用于变异解读。

ParametersJSON Schema
NameRequiredDescriptionDefault
variantYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.2/5.0
Behavior4/5

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

With no annotations provided, the description carries the transparency burden. It discloses the input formats (HGVS or rsID), the data sources (GnomAD/1000G, SIFT/PolyPhen), and the categories of returned information. It does not discuss error behavior or service dependencies, but for a straightforward read-only annotation lookup this is reasonably transparent.

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

Conciseness4/5

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

The description is front-loaded with the core purpose and remains compact. The main inefficiency is bilingual duplication: the Chinese text largely repeats the English content, and 'for variant interpretation' appears twice. Still, the structure is clear and the redundancy is not severe.

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

Completeness4/5

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

The tool has only one required parameter and an output schema exists, so the description need not detail return values. It covers accepted inputs, example formats, and the intended interpretation purpose. It would be more complete with explicit guidance on when to choose this tool over related variant or annotation tools.

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?

Schema description coverage is 0%, so the description must compensate, and it does: it explicitly explains that the 'variant' parameter accepts HGVS notation with a concrete example (chr13:g.32911145G>A) or an rsID. This is exactly the semantic guidance an agent needs to populate the single required parameter.

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?

The description opens with a specific verb and resource: 'Annotate human genetic variants (MyVariant.info)'. It clearly distinguishes itself from sibling tools like dbsnp_search or clinvar_query by naming a dedicated annotation service and listing its scope and output categories.

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

Usage Guidelines3/5

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

The phrase 'for variant interpretation' gives an implied use case, and the description explains what inputs are accepted and what results are returned. However, it does not explicitly state when to prefer this tool over alternatives such as dbsnp_search or clinvar_query, nor does it mention when not to use it.

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

wormbase_geneA

Get C. elegans gene by WormBase ID. 按 WormBase ID 获取线虫基因信息:输入线虫基因编号(如 WBGene00000001),返回基因名称、符号、染色体位置、功能注释与序列信息,用于线虫生物学研究。

ParametersJSON Schema
NameRequiredDescriptionDefault
gene_idYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.2/5.0
Behavior3/5

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

No annotations are provided, so the description carries the full burden. It discloses that the tool returns gene information (a behavioral trait) but does not explicitly state whether the operation is read-only or any side effects. As a 'Get' tool, this is implied, but not clearly stated.

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

Conciseness4/5

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

The description is concise with two sentences, one in English and one in Chinese. The information is front-loaded, but the repetition across languages is minor redundancy. It is still efficient and easy to scan.

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?

For a one-parameter lookup tool with an output schema, the description is complete: it states the purpose, the input format, and the type of returned data. Nothing essential is missing for an agent to invoke it correctly.

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

Parameters4/5

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

The input schema has zero description coverage for gene_id. The description compensates by explaining the expected format (WormBase ID) and providing an example (WBGene00000001), adding meaningful context beyond the bare schema.

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?

The description states a specific verb ('Get'), a precise resource ('C. elegans gene'), and the method ('by WormBase ID'). It also lists the returned data types (name, symbol, chromosome location, functional annotation, sequence information), making it clearly distinct from broader search tools like wormbase_search.

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?

The description provides clear context: use this tool when you have a WormBase ID for a C. elegans gene. It implies the appropriate scenario but does not explicitly mention alternatives or when-not-to-use. Since the tool is specialized, this is adequate.

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 73 tool updatesv0.6.0
    • First observedalphafold_structure
    • First observedbiogrid_gene_interactions
    • First observedbiogrid_interactions
    • First observedbioproject_search
    • First observedbiosample_by_id
    • First observedbiosample_search
    • First observedblast_search
    • First observedcellxgene_search
    • First observedchebi_compound
    • First observedchebi_search
    • First observedchembl_drug_search
    • First observedclinvar_query
    • First observedcompound_info
    • First observeddb_health_check
    • First observeddbsnp_search
    • First observedemdb_structure_lookup
    • First observedena_sequence_search
    • First observedensembl_gene_lookup
    • First observedensembl_homologs
    • First observedeuropepmc_search
    • First observedexpression_atlas_experiment
    • First observedexpression_atlas_gene
    • First observedflybase_gene
    • First observedflybase_search
    • First observedgene_enrichment
    • First observedgene_full_profile
    • First observedgene_go_annotation
    • First observedgenome_assembly_search
    • First observedgeo_dataset_search
    • First observedget_analysis_template
    • First observedglycan_lookup
    • First observedgo_term_lookup
    • First observedgo_term_search
    • First observedgwas_gene_variants
    • First observedgwas_variant_associations
    • First observedhgnc_gene_symbol
    • First observedhgnc_search
    • First observedintact_interactions
    • First observedintelligent_analyze
    • First observedkegg_pathway_genes
    • First observedkegg_pathway_search
    • First observedlipid_lookup
    • First observedmetabolomics_latest
    • First observedmetabolomics_study
    • First observedmicrobiome_study_search
    • First observedncbi_fetch_sequence
    • First observedopenalex_work_search
    • First observedpdb_structure_summary
    • First observedplant_gene_lookup
    • First observedplant_species_list
    • First observedplasmid_search
    • First observedpride_project
    • First observedpride_search
    • First observedprotein_domains
    • First observedprotein_glycosylation
    • First observedprotein_tissue_expression
    • First observedpubmed_search
    • First observedreactome_pathway_search
    • First observedrgd_gene_symbol
    • First observedrgd_search
    • First observedsra_search
    • First observedstring_interactions
    • First observedtaxonomy_lookup
    • First observedtool_inventory
    • First observeducsc_genome_info
    • First observedunichem_mapping
    • First observedunichem_structure
    • First observeduniparc_by_id
    • First observeduniparc_search
    • First observeduniprot_annotate
    • First observedvariant_annotate
    • First observedwormbase_gene
    • First observedwormbase_search

TDQS

B3.1/5.0

Scored across 73 tools

Disambiguation2/5

Multiple tools have nearly interchangeable roles, especially biogrid_interactions vs. biogrid_gene_interactions, hgnc_search vs. hgnc_gene_symbol, and unichem_mapping vs. unichem_structure. Protein interaction data can also be obtained from string_interactions or intact_interactions, while literature search is split across pubmed_search, europepmc_search, and openalex_work_search. Although many database-prefixed searches are distinct, these overlapping boundaries make selection error-prone.

Naming Consistency3/5

Nearly all names use lower_snake_case and most follow a source-prefix pattern, but the action suffix is not standardized: search, lookup, query, annotate, fetch, and get are used inconsistently, and some names like pdb_structure_summary or protein_tissue_expression have no clear action. The pattern is readable but not predictable enough to support high-confidence selection.

Tool Count2/5

73 tools is far beyond the practical agent context size for reliable selection, even for a broad bioinformatics utility. Many tools could be consolidated, such as merging the BioGRID, UniChem, and HGNC search/detail pairs. The count overwhelms rather than clearly earning each tool's place.

Completeness4/5

The set covers an unusually broad range of life-science domains, including genes, proteins, variants, literature, structures, pathways, interactions, compounds, model organisms, and multi-omic data repositories. Minor gaps remain, such as no direct retrieval of full expression matrices or raw sequence files from search results, but the search-and-annotate surface is generally adequate.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers