MCP server for searching and retrieving pages from Cosense (Scrapbox)
Three tools with basic schemas but critical quality gaps. All tools lack parameter descriptions (typo: 'descrption' instead of 'description' in schema). Tool descriptions are minimal (10-30 chars, below 50-char baseline). No output schema documentation. Error handling is present but generic. cosense_syntax_rule has no parameters, making it trivial. Parameter naming lacks type suffixes (e.g., 'keywords' should clarify it's a search string). No pagination support despite search returning potentially large result sets.
Get a page by title
Search Cosense by keywords
Get Cosense syntax rules
All parameter descriptions missing or misspelled. Schema declares 'descrption' (typo) instead of 'description', making descriptions invisible to LLMs. Parameters lack type hints and constraints.
Tool descriptions too short (10-30 chars). Baseline is 50-200 chars for LLM clarity. 'Search Cosense by keywords' and 'Get a page by title' lack context on when to use, what to expect, and prerequisites.
No output schema documented. LLMs cannot predict response structure. cosense_search returns JSON with 'pages' array; cosense_get_page returns object with 'lines' array. Undocumented structure forces LLMs to guess field names.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 36 | 2026-07-28+ | v2 |
No pagination support. cosense_search can return unlimited results, risking context window exhaustion. No limit, offset, or cursor parameters. Baseline pattern requires pagination for list-returning tools.
Error messages generic and non-actionable. 'Error: HTTP error! status: 404' tells LLM nothing about recovery. Missing recovery guidance like 'Try search_cosense() with different keywords' or 'Page not found. Available pages: ...'