Skip to main content
Glama

三域医研 · 科研算法引擎 (SanYu Research Engine)

Renal function & dose adjustment / 肾功能剂量调整

renal_dose_adjust
Read-only

Renal function & dose adjustment / 肾功能剂量调整 | USE WHEN: the user gives age / sex / weight / serum creatinine and asks for creatinine clearance, eGFR, CKD stage, or how to adjust a drug dose in renal impairment (vancomycin, meropenem, metformin, anticoagulants…) | ALIASES: 肾功能剂量, 肌酐清除率, CrCl, eGFR, 肾小球滤过率, 减量, 剂量调整, 肾功能不全, 万古霉素怎么减量, 按肌酐算剂量 | RETURNS: CrCl(Cockcroft-Gault)+ eGFR(CKD-EPI 2021)+ CKD 分期 + 该药的肾剂量分档(含依据与核对提示)

Example tool call

This call uses example arguments supplied in the tool’s input schema.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "age": 68,
      "sex": "male",
      "drug": "vancomycin",
      "height_cm": 170,
      "weight_kg": 62,
      "scr_umol_l": 186
    },
    "name": "renal_dose_adjust"
  }
}

Input Schema

NameRequiredDescriptionDefault
ageYes年龄(岁)
sexNomale / female(也接受 男 / 女)
crrtNo是否 CRRT
drugNo药名,中英文均可,如 vancomycin / 万古霉素
dialysisNo是否血液透析
height_cmNo身高 cm(用于理想体重与 BSA,建议给)
scr_mg_dlNo血肌酐 mg/dL(与 scr_umol_l 二选一)
weight_kgYes实际体重 kg
scr_umol_lNo血肌酐 μmol/L(国内化验单常用单位,与 scr_mg_dl 二选一)

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A4.1/5.0
Behavior4/5

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

Annotations already cover the safety profile (readOnlyHint=true, destructiveHint=false, openWorldHint=false), so the description's job is to add operational context — and it does, via the RETURNS section naming the two formulas used and stating that dose bands come with rationale and verification prompts. It does not state assumptions or limits (for example, that a steady-state creatinine is needed or that dialysis/CRRT inputs change the calculation), which keeps it below a 5.

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 definition is a single front-loaded line with clear pipe-delimited sections (identity, USE WHEN, ALIASES, RETURNS), so an agent can scan it quickly. The long bilingual alias list is retrieval-useful but is the one part that inflates length without adding behavioral 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?

With 9 parameters, no output schema, and full schema coverage, the description correctly focuses on stating what is returned (CrCl, eGFR, CKD stage, dose band) rather than re-documenting inputs. Some gaps remain for a clinical calculation tool: nothing is said about how dialysis and CRRT inputs alter the result or about clinical caveats.

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 100%, so every one of the 9 parameters is already documented in the schema, including unit alternatives (scr_umol_l vs scr_mg_dl) and Chinese/English drug names. The description restates the input set at a high level and adds no syntax, defaults, or precedence rules beyond the schema. The baseline of 3 is therefore appropriate.

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 resource (renal function) and the exact computations performed (CrCl by Cockcroft-Gault, eGFR by CKD-EPI 2021, CKD staging, drug-specific renal dose banding). It is clearly distinguishable from neighboring tools such as species_dose_convert, pk_nca, and animal_dose_volume, which handle other kinds of dosing or pharmacokinetics.

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 'USE WHEN' clause gives concrete triggering inputs (age, sex, weight, serum creatinine) and concrete requested outputs (CrCl, eGFR, CKD stage, dose adjustment), which is stronger guidance than most tools provide. It stops short of naming exclusions or pointing to sibling alternatives for adjacent cases, so it does not reach the top score.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.