Fix guides · check docs.short

Write tool descriptions that say when to use the tool

Descriptions under 20 characters usually restate the name. Add when to use it and what it returns.

354 of 15,312 reachable MCP servers (2.3%) have this issue today.

Why it matters

"Get weather" does not tell a model whether the tool does forecasts, history or the current hour. One extra sentence removes most wrong-tool calls.

Before

"description": "Get weather"

After

"description": "Current weather for a city: temperature, conditions, wind. Use for 'now'; use get_forecast for future days."

Check your server

Paste your endpoint at /check, or run it in CI:

pipx run glimind check https://your-server.example.com/mcp --min-grade B

Related