MCP Server for Entity Disambiguation Clustering Resolver Skill. Clusters entity mentions into canonical entities using Jaro-Winkler similarity.
Single tool with basic schema and minimal descriptions. Tool name 'resolve_entities' lacks action verb prefix (should be 'cluster_entities' or 'resolve_entity_mentions'). Description is adequate (89 chars) but parameters lack individual descriptions entirely, LLMs cannot infer what 'mentions' or 'threshold' control without explicit guidance. Input schema is present with types but no parameter-level descriptions. No output schema documented. No error handling guidance. No security considerations. Composition is single-purpose but lacks richness for production use.
Cluster entity mentions into canonical entities using Jaro-Winkler similarity
Tool name lacks action verb prefix. 'resolve_entities' does not start with a clear action verb (get_, create_, search_, cluster_). Should be 'cluster_entities' or 'resolve_entity_mentions' to signal intent to LLMs.
Parameters lack descriptions. 'mentions' and 'threshold' have no descriptions in the schema. LLMs cannot infer that 'mentions' is a list of entity names to cluster or that 'threshold' controls Jaro-Winkler similarity cutoff (0.0-1.0 range).
No output schema documented. Tool returns JSON with 'canonical', 'aliases', 'cluster_size' fields, but this structure is not declared in the tool definition. LLMs cannot plan downstream operations without knowing the response shape.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 43 | 2026-07-28+ | v2 |
No error handling or recovery guidance. If 'mentions' is empty, malformed, or contains non-string values, the tool will fail silently or crash. No error messages guide the LLM to retry or correct input.
Parameter constraints not documented. 'threshold' defaults to 0.82 but valid range (0.0-1.0) is not stated. 'mentions' array size limits are not specified. LLMs may pass invalid values (negative thresholds, empty arrays, 10,000+ items) without guidance.