md-feedback
Review markdown plans before AI agents build.
Connector by yeominux · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/yeominux-md-feedback
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.
- Tools
- 12 read · 11 write · 1 delete · 3 not yet classified
- Secrets
- None asked for
- Install scripts
- Not scanned yet
- Runs as
- Node.js package
Tools by what they do 27
Read from the source code; the running server may list different tools.
Read 12 · Look things up without changing anything.
evaluate_gatesexport_reviewget_checkpointsget_document_structureget_memo_changesget_policy_statusget_review_statusget_severity_statusget_workflow_statuslist_annotationslist_documentspickup_handoff
Write 11 · Create, change, send or run things.
apply_memoapprove_checkpointbatch_applycreate_annotationcreate_checkpointrequest_approval_checkpointrespond_to_memoset_memo_severityupdate_cursorupdate_memo_progressupdate_memo_status
Delete 1 · Delete, drop, revoke or wipe things.
rollback_memo
Not yet classified 3 · We could not tell from the name and description.
advance_workflow_phasegenerate_handofflink_artifacts
Files it touches
- Any path the agent passes to its tools
Tools (27)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
advance_workflow_phaseAdvance workflow phase in strict sequence: scope -> root_cause -> implementation -> verification.
apply_memoApply an implementation action to a memo. Supports text_replace (requires occurrence or replaceAll when oldText has multiple matches; optional section-scoped propagation), file_patch (applies unified diff patch — snapshot saved first), and file_create (create a new file). Creates a snapshot before modification, records the implementation, and updates memo status to needs_review.
approve_checkpointApprove a pending high-risk checkpoint. Grants one execution for the approved tool.
batch_applyApply multiple implementation operations in a single transaction. Parses the document once, applies all operations sequentially, then writes once. Each operation follows the same format as apply_memo.
create_annotationCreate a new review annotation on a markdown file. Finds the anchor text in the document and attaches a review memo. Auto-creates a quality gate and updates cursor.
create_checkpointCreate a review checkpoint in an annotated markdown file. Records current annotation counts and reviewed sections.
evaluate_gatesEvaluate all gates in a markdown file against current memo statuses. Returns updated gate statuses without modifying the file.
export_reviewExport review feedback in a format optimized for a specific AI coding tool. Targets: claude-code, cursor, codex, copilot, cline, windsurf, roo-code, gemini, antigravity, generic, handoff. Returns formatted markdown ready to save to the appropriate file.
generate_handoffGenerate a structured handoff document from an annotated markdown file. Anti-compression format: explicit fields, numbers, lists only.
get_checkpointsList all checkpoints in an annotated markdown file.
get_document_structureParse an annotated markdown file and return v0.4.0 ReviewDocument metadata. By default bodyMd is omitted to reduce context size; set includeBody=true only when full body is required.
get_memo_changesGet the implementation history and progress for a memo. Returns all MemoImpl records and progress entries from .md-feedback/progress.json. If memoId is omitted, returns all changes.
get_policy_statusReturn current runtime policy profile and memo-action routing rules.
get_review_statusGet current review session status: annotation counts, checkpoints, and reviewed sections. Summary-only — returns counts and metadata, not individual memos. Use list_annotations for memo details or get_document_structure for the full parse.
get_severity_statusReturn memo severity overrides and unresolved blocking memo IDs for the document.
Show 12 more tools
get_workflow_statusReturn current workflow phase and transition history for a document.
link_artifactsLink file artifacts (source files, configs, etc.) to a memo. Creates a MemoArtifact record in the document.
list_annotationsList all annotations (USER_MEMO comments) in a markdown file. Returns structured array with id, type, status, owner, text, and color. Lightweight — returns only memo data, no document body or sections. Use get_document_structure for the full parse.
list_documentsList markdown files in the workspace. Optionally filter to only files that already contain annotations.
pickup_handoffParse an existing handoff document to resume a review session. Returns structured data for session continuity.
request_approval_checkpointCreate an approval checkpoint for a high-risk action before execution.
respond_to_memoAdd an AI response to a memo annotation. Inserts a REVIEW_RESPONSE block into the markdown file directly below the memo's anchor text. Automatically sets the memo status to "needs_review" for human approval.
rollback_memoRollback the latest implementation for a memo. Reverses text_replace operations (swaps before/after), marks the impl as reverted, and sets the memo status back to open.
set_memo_severitySet severity override for a memo. Defaults remain: fix=blocking, question/highlight=non_blocking.
update_cursorUpdate the plan cursor position in a markdown file. The cursor tracks "where we are" in a plan. Only one cursor per document.
update_memo_progressUpdate the progress of a memo with a status change and message. Writes progress to .md-feedback/progress.json and updates the memo status. Terminal statuses (done, failed) require human approval via VS Code.
update_memo_statusUpdate the status of a memo annotation. Writes the change back to the markdown file. Returns the updated memo. Terminal statuses (answered, done, failed, wontfix) require human approval via VS Code.
Signals
- Stars
- 5
- Forks
- 1
- Open issues
- 0
- Last commit
- Mar 23, 2026 (7 months ago)
- Last release
- Mar 22, 2026 (7 months ago)
From GitHub (fetched Oct 24, 2026).
Details
- Registry name
io.github.yeominux/md-feedback- Version
- 1.5.6
- Auth
- No auth
- Packages
- npm md-feedback
- License
- License unknown
- Repository
- github.com/yeominux/md-feedback
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
More from yeominux
Cite this page
md-feedback MCP server. Agent Mart. https://agentmart.dev/connectors/yeominux-md-feedback (last updated 2026-10-24)