descriptions/too-short
Descriptions under ~20 characters carry no disambiguation signal. The model needs enough context to pick this tool over its neighbours without trial calls.
- Category
- descriptions
- Default severity
- warn
- Weight
- 3
- Max deduction
- 12
Why this category matters
Whether each tool explains itself well enough to be chosen correctly.
A rule deducts weight points from its category for each non-info finding, capped at maxDeduction. The composite is the mean of the six category scores — so a single noisy rule can never sink a whole surface on its own. Read the full scoring model.
Configuration
Override these in .mcp-surface-lintrc.json to match your own thresholds.
{
"rules": {
"descriptions/too-short": {
"options": {
"minChars": 20
}
}
}
}