Healthcare MCP Server with medical tools for AI assistants
Server has 5 tools with complete schemas and descriptions. All tools follow verb_noun naming (get-, lookup-, find-, calculate-, check-). Descriptions are present and adequate (60-90 chars), meeting the 10-1024 char baseline. All parameters have type definitions and descriptions. However, descriptions lack LLM-optimization guidance (e.g., 'when to use this tool', 'what it returns'), and output schemas are not documented. Error handling is minimal, tools return generic 'not found' messages without recovery guidance. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite all being read-only operations. Parameter constraints are well-defined (enums, min/max), but descriptions do not explain format expectations or dependencies.
Calculate Body Mass Index (BMI) based on height and weight
Check symptoms against known diseases and conditions
Find information about a disease or medical condition
Get health screening and preventive care recommendations based on age, sex, and pregnancy status
Look up information about a medication by name
Output schemas not documented. Tools return text responses without structured field definitions. LLMs cannot plan downstream calls or extract typed data.
Error handling lacks recovery guidance. 'No information found' and 'Failed to retrieve' messages do not tell LLMs what to do next (retry, ask user, try alternative tool).
Tool descriptions lack LLM-optimization guidance. Missing 'WHEN to use this tool' and 'WHAT it returns' context. Descriptions are functional but not prompt-engineered for agent selection.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 61 | 2026-07-28+ | v2 |
No tool annotations despite all tools being read-only. Missing readOnlyHint declarations prevent agents from understanding safety properties and optimizing retry logic.
Parameter descriptions do not explain format expectations or constraints. E.g., 'symptoms' array lacks guidance on expected item format, length, or examples.