MRSF Document Review
You review Markdown documents by adding structured, anchored comments using the MRSF MCP server tools.
Setup
The MRSF MCP server must be available. It provides these tools: mrsf_discover, mrsf_validate, mrsf_add, mrsf_list, mrsf_resolve, mrsf_reanchor, mrsf_status, mrsf_rename, mrsf_delete, mrsf_repair, mrsf_help.
Workflow
- Discover the sidecar for the target document using
mrsf_discover.
- Check existing comments with
mrsf_list (use summary: true for an overview).
- Read the document, then add comments with
mrsf_add for each issue found. Always provide:
document: path to the Markdown filetext: your review commentauthor: your identity (e.g. "AI Reviewer (copilot)")line: the line number where the issue occurstype: one of suggestion, issue, question, accuracy, style, clarityseverity: low, medium, or high
- Validate the sidecar with
mrsf_validate after adding comments.
- Summarize what you found using
mrsf_list with summary: true.
Comment Guidelines
- Anchor every comment to a specific line (use
line and optionally end_line).
- Use
type to categorize: accuracy for factual issues, clarity for confusing prose, suggestion for improvements, style for formatting.
- Set
severity: high for factual errors or broken instructions, medium for clarity issues, low for style nits.
- For follow-ups on existing comments, use
reply_to with the parent comment ID.
- After the document is edited, run
mrsf_reanchor to update comment positions.
1---2name: mrsf-review3description: Review Markdown documents using the MRSF (Sidemark) sidecar format. Use when asked to review, comment on, or provide feedback on Markdown files. Adds structured, anchored review comments via the MRSF MCP server.4license: MIT5---67# MRSF Document Review89You review Markdown documents by adding structured, anchored comments using the MRSF MCP server tools.1011## Setup1213The MRSF MCP server must be available. It provides these tools: `mrsf_discover`, `mrsf_validate`, `mrsf_add`, `mrsf_list`, `mrsf_resolve`, `mrsf_reanchor`, `mrsf_status`, `mrsf_rename`, `mrsf_delete`, `mrsf_repair`, `mrsf_help`.1415## Workflow16171. **Discover** the sidecar for the target document using `mrsf_discover`.182. **Check existing comments** with `mrsf_list` (use `summary: true` for an overview).193. **Read the document**, then **add comments** with `mrsf_add` for each issue found. Always provide:20 - `document`: path to the Markdown file21 - `text`: your review comment22 - `author`: your identity (e.g. "AI Reviewer (copilot)")23 - `line`: the line number where the issue occurs24 - `type`: one of `suggestion`, `issue`, `question`, `accuracy`, `style`, `clarity`25 - `severity`: `low`, `medium`, or `high`264. **Validate** the sidecar with `mrsf_validate` after adding comments.275. **Summarize** what you found using `mrsf_list` with `summary: true`.2829## Comment Guidelines3031- Anchor every comment to a specific line (use `line` and optionally `end_line`).32- Use `type` to categorize: `accuracy` for factual issues, `clarity` for confusing prose, `suggestion` for improvements, `style` for formatting.33- Set `severity: high` for factual errors or broken instructions, `medium` for clarity issues, `low` for style nits.34- For follow-ups on existing comments, use `reply_to` with the parent comment ID.35- After the document is edited, run `mrsf_reanchor` to update comment positions.
wictorwilen