Tools

Everything picomcp docs exposes to your AI client: tools, resources and prompts.

3 capabilities3 tool

Automated heuristic

Tool docs quality: B — 3 tools graded

Average 80/100 for how clearly each description tells an AI client what the tool does, what it needs, and what it changes. It is not a security audit.

Grade A: 1
Grade B: 2
Grade C: 0
Grade D: 0
Grade F: 0

How grades work

list_docstool
Lists every documentation page, with its URL
Description quality grade B, 80/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: not passed10/20
  A bit terse. One more clause about inputs or results would help.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: passed20/20
  The description mentions what the tool takes.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
read_doctool
Returns a full page as Markdown, by title (Tools) or slug (tools)
Description quality grade B, 70/100 · 2 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: not passed0/20
  Say what the tool needs, for example “by issue number” or “takes a file path”.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.
search_docstool
Finds the pages that match a query, with a short excerpt
Description quality grade A, 90/100 · 1 to fix
- Has a description: passed20/20
  The tool has a description an AI client can read.
- Sensible length: passed20/20
  Length is in a useful range.
- Starts with what it does: passed15/15
  Opens with an action verb.
- Mentions its inputs: passed20/20
  The description mentions what the tool takes.
- Explains side effects: passed15/15
  Looks read-only, so no disclosure is required. Saying “read-only” still helps.
- Gives usage guidance: not passed0/10
  Add when to use it, what it requires, or what to use instead.