md-feedback — Claude Code MCP server: review markdown plans
Lets your agent read annotations on a markdown plan: fixes, questions, highlights. Useful when the plan comes before the code.
claude mcp add md-feedback -- npx -y md-feedbackWhat md-feedback does
md-feedback is an MCP server and a VS Code extension. You open a .md plan, select some text and press 1, 2 or 3 to leave a highlight, a fix or a question. The agent picks those annotations up over MCP and starts working. No export step, no copy-paste.
Under the hood there are 27 MCP tools, quality gates that evaluate pass or fail on their own, checkpoints, and session handoffs that carry context forward. Annotations live in the file as HTML comments, so they survive commits and merges. An agent can roll back its last change, and writes to .env, credentials or node_modules are blocked.
MCP needs Node.js 18+ because the server runs through npx. Config paths differ per client: .claude/mcp.json for Claude, .cursor/mcp.json for Cursor. Export-only agents, such as the current Copilot flow, cannot read annotations directly.
What it helps with
- check an agent's plan before it writes any code
- mark the parts of a plan that need rework
- ask the agent a question inside the plan text
- carry context from one agent session to the next
- set conditions the agent must meet before moving on
Example prompts for the agent
- Read the annotations in
plan.mdthrough md-feedback and apply the fixes - Answer the questions I left in the plan
- Generate a handoff for the next session
How to install md-feedback
Platform CLI
claude mcp add md-feedback -- npx -y md-feedbackPlatform CLI
codex mcp add md-feedback -- npx -y md-feedbackConfig file
{
"mcpServers": {
"md-feedback": {
"command": "npx",
"args": [
"-y",
"md-feedback"
]
}
}
}Config file
{
"servers": {
"md-feedback": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"md-feedback"
]
}
}
}Platform CLI
gemini mcp add md-feedback npx -y md-feedbackStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about md-feedback
How do I install md-feedback in Claude Code?
Run claude mcp add md-feedback -- npx -y md-feedback. Node.js 18+ is required.
What does md-feedback do?
It lets you annotate a markdown plan with three kinds of notes and hand them to an agent over MCP. The agent reads them, applies fixes and answers questions.
Do the annotations survive git?
Yes. They are stored in the file itself as HTML comments, so a reviewed plan travels through normal commits and pull requests.
