← methodology

MCP tool quality

usability.mcp-tool-quality · Usability · 3 pts · recommended

Goal

Is your integration well-built?

Whether your specs, docs, and tools are complete and descriptive enough for an agent to use them without guessing.

How we test

Linted listed tools for descriptions, typed input schemas, and naming.

How to pass

Give every MCP tool a real description and a typed input schema — agents choose tools by description text alone.

Verify a fix

curl -X POST /api/scan/checks \
  -H 'content-type: application/json' \
  -d '{"url": "yourdomain.com", "checkIds": ["usability.mcp-tool-quality"]}'