MCP server for Remarc, a macOS contextual commenting app. Provides tools to list sessions, manage comments, set status, and retrieve comment details with attachments.
Remarc MCP has well-structured tool definitions with consistent naming (verb_noun pattern: remarc_list_*, remarc_get_*, remarc_set_*) and comprehensive descriptions (avg 150+ chars). All 8 tools have input schemas with typed parameters and enums where appropriate. However, output schemas are not documented in the visible code, only input schemas are defined. Error handling is minimal; tools lack recovery guidance. Parameter descriptions are solid but some lack format/constraint details. No pagination support visible for list operations despite potentially large result sets.
Set status for multiple comments in a single operation. More efficient than individual remarc_set_status calls.
Soft-delete a comment (marks as deleted, does not remove from disk).
Get full details of a comment by ID (UUID or short ID prefix). Includes attachments and web context.
List Remarc comments, filtered by session, status, or type. Note: comments injected via hooks have "handedOff" status, so use status "handedOff" or omit the status filter to find them. After addressing a comment, call remarc_set_status to resolve it.
List active Remarc sessions with comment counts.
Pair a Claude Code session with a Remarc session for instant comment delivery via the wake mechanism.
Output schemas not documented. Tools return structured data but LLMs cannot see what fields to expect. remarc_list_comments, remarc_get_comment, and others lack documented return types.
No pagination support visible for list operations. remarc_list_comments and remarc_list_sessions lack limit/offset/cursor parameters and total count in response. Large result sets will blow context window.
Minimal error handling and recovery guidance. Tools lack actionable error messages. E.g., remarc_delete_comment and remarc_set_status do not document what happens on invalid ID or status transition failures.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 62 | 2026-07-28+ | v2 |
Set the status of a comment. Use this after addressing a comment to mark it resolved with a summary.
Trigger instant delivery of pending comments to a paired Claude Code session.
Destructive operations lack confirmation/dry-run support. remarc_delete_comment performs soft-delete with no confirmation step. Agents can accidentally delete comments without safeguards.
Parameter descriptions lack format/constraint details. 'session_id' and 'claude_session_id' are described as strings but format (UUID vs arbitrary string) is unclear. No regex patterns or length limits stated.