Critical failures across all dimensions. Tool definitions exist only in mcp.json with names and brief descriptions, but NO input schemas are visible in source code. The mcp.json file shows tool names and one-line descriptions (avg ~50 chars), but provides zero parameter definitions, type information, or output schemas. Without schemas, LLMs cannot validate inputs or understand return structures. No evidence of error handling, permission gates, or security patterns. STDIO transport limits remote accessibility. This is a skeleton definition file with no implementation detail visible.
Create, update, or delete bookmarks
Advanced search with filters, tags, and pagination
Bulk update, move, or remove bookmarks in a collection
Remove empty collections (requires confirmation)
List all collections as a flat list
Create, update, or delete collections
Server diagnostic information and library health metrics
NO INPUT SCHEMAS VISIBLE. All 15 tools lack parameter definitions, type information, and constraints. mcp.json contains only tool names and descriptions; no 'inputSchema' or 'parameters' fields present. LLMs cannot validate inputs or understand what parameters each tool accepts.
DESCRIPTIONS TOO BRIEF. Average description length ~50 chars (baseline 194 chars). Descriptions like 'Create, update, or delete collections' lack context on WHEN to use the tool, WHAT parameters it needs, and WHAT it returns. LLMs cannot distinguish between similar tools (e.g., collection_manage vs bookmark_manage).
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 37 | 2026-07-28+ | v2 |
Permanently empty the trash (requires confirmation)
Hierarchical view of collections with full breadcrumb paths
Fetch a single bookmark by ID
AI-powered organization advice for a URL or bookmark
Create, update, or delete highlights
Scan library for broken links, duplicates, and untagged items
List bookmarks for a collection with pagination
Rename, merge, or delete tags
NO OUTPUT SCHEMAS DOCUMENTED. No evidence of return type definitions, field descriptions, or pagination info. Tools like list_raindrops and bookmark_search should document pagination (limit, offset, total_count) and field structure, but none is visible.
AMBIGUOUS TOOL NAMES. 'collection_manage', 'bookmark_manage', 'tag_manage', 'highlight_manage' all use generic 'manage' verb. LLMs cannot infer whether these create, update, delete, or all three. Split into separate tools: create_collection, update_collection, delete_collection.
NO ERROR HANDLING GUIDANCE. No evidence of error classification, recovery hints, or actionable error messages. Destructive tools (empty_trash, cleanup_collections) mention 'requires confirmation' but no mechanism is documented for how confirmation works or what happens on failure.