MCP server for Raindrop.io API integration - save, organize, search bookmarks with collections, tags, and highlights
Raindrop MCP has well-structured tool definitions with consistent naming (verb_noun pattern), clear descriptions (avg ~100 chars), and complete input schemas with types and descriptions. All 17 tools follow the verb_noun convention (list_, get_, create_, update_, delete_, parse_, check_). Schemas are properly typed with enums for constrained inputs (view, sort). However, output schemas are not documented, LLMs cannot predict response structure for chaining. Error handling is minimal; no recovery guidance or actionable error messages. No tool annotations (readOnlyHint, destructiveHint) despite clear risk classifications. Parameter descriptions are adequate but lack format constraints (e.g., 'URL to parse' should specify valid schemes). Missing pagination guidance for list tools despite accepting page/perpage params.
Check if a URL already exists in Raindrop
Create a new collection
Create a highlight for a raindrop
Create a new raindrop (bookmark)
Delete a collection
Delete a highlight
Delete a raindrop (bookmark)
Get a specific collection by ID
Output schemas not documented. LLMs cannot predict response structure (Collection, Raindrop, Tag, Highlight fields) for downstream tool chaining. Breaks pattern:tool-chain.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk classifications (READ_ONLY, WRITE, DESTRUCTIVE). LLMs cannot infer safety properties.
Error handling absent. No recovery guidance, actionable error messages, or error classification (retryable vs user-fixable vs fatal). Breaks pattern:recovery-guide.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 55 | 2026-07-28+ | v2 |
Get a specific raindrop (bookmark) by ID
Get current user information
List all collections in Raindrop account
List highlights for a raindrop
List raindrops (bookmarks) in a collection
List all tags in a collection
Parse metadata from a URL
Update an existing collection
Update an existing raindrop (bookmark)
Parameter descriptions lack format constraints. 'URL to parse' should specify valid schemes (http, https). 'Highlight color' should specify format (hex, rgb, or enum). Breaks pattern:constrained-input.
Pagination guidance missing. list_raindrops and list_collections accept page/perpage but descriptions do not explain pagination behavior (0-indexed? max page size? total count returned?).