A minimal MCP server with OAuth 2.1 for Claude AI. Provides a shared persistence layer for AI agents authenticated with the same GitHub or Google identity.
Sketchpad has two well-named, verb-prefixed tools (read_file, write_file) with clear, detailed descriptions (150+ chars each) that explain WHAT, WHEN, and consequences. Both tools have input schemas with typed parameters and descriptions. Tool annotations (readOnlyHint, destructiveHint, idempotentHint) are correctly applied. However, the tools lack documented output schemas, and error messages are generic strings rather than structured guidance. The server demonstrates good naming discipline and parameter clarity but falls short of A-grade polish in error recovery and response documentation.
Read the Sketchpad -- a shared persistence layer for AI agents authenticated with the same GitHub identity. Contains content written by any agent session on this account. Read when the user asks you to check for prior context.
Write to the Sketchpad -- a shared persistence layer for AI agents authenticated with the same GitHub identity. Do: write ONLY when the user explicitly asks you to save something here. Do NOT: write here to save content for the user to read (use artifacts or files instead). Do NOT: write unprompted or proactively.
Output schemas not documented. Both tools return strings, but LLMs cannot infer structure or plan downstream operations. read_file returns file content or welcome message; write_file returns status string. Neither response structure is formally declared.
Error messages are generic strings ('Sketchpad too large...', 'Server storage full...') rather than structured error objects with recovery guidance. LLMs cannot distinguish retryable from fatal errors or know what corrective action to take.
write_file mode parameter description includes example values ('append (default)') which LLMs may reuse literally. Should use enum constraint alone without examples in description text.
No pagination or result-limiting mechanism. If sketchpad content grows very large, read_file returns the entire file as a single string, potentially exhausting context windows. No offset/limit parameters offered.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 66 | 2026-07-28+ | v2 |
write_file lacks a dry-run or confirmation step for destructive operations. Agents can overwrite entire sketchpad content without preview. A confirm_before_execute pattern would prevent accidental data loss.