MCP server for interacting with Scrapbox, a collaborative knowledge management tool. Provides tools to retrieve, list, search pages and generate URLs for creating new pages.
Server has 4 tools with basic naming (verb_noun pattern) and descriptions present. However, descriptions are minimal (10-60 chars), parameter descriptions are sparse or missing, and output schemas are undocumented. Tool names are clear but lack context about when to use each. Parameter validation and error guidance are weak. No tool annotations (readOnlyHint, destructiveHint). Schemas exist in code but are not formally documented for LLM consumption. This is typical of early-stage community servers.
Generate a URL for creating a new page
Get a Scrapbox page by title
Get a list of pages in the project (max 1000 pages)
Full-text search across all pages in the project (max 100 pages)
Descriptions are too brief (10-60 chars). LLMs cannot determine when to select each tool or what distinguishes them. E.g., 'Get a Scrapbox page by title' lacks context about whether this returns full content, metadata only, or both.
Output schemas are not documented. Callers cannot know what fields to expect from get_page, list_pages, or search_pages. LLMs must guess at response structure, risking failed downstream tool chains.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). All tools are read-only, but this is not declared. Agents cannot distinguish safe tools from destructive ones without explicit hints.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 39 | <=2025-11-25 | v2 |
Parameter descriptions are missing or minimal. 'page_title' in get_page has description 'Page title to retrieve', but no guidance on format, length, or case sensitivity. 'body_text' in create_page_url is optional but no default behavior is documented.
Error handling is generic. Handlers return 'Failed to get page: <error>' without guidance on recovery. If a page is not found, should the agent search for similar titles? No recovery hints provided.