mdreview

Install

Works with Claude Code, VS Code, Cursor, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install connector/ranawaqas-ai-mdreview

About

No 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, install config and code. Checked Oct 25, 2026.

Tools

12 read · 6 write · 2 delete · 1 not yet classified

Secrets

None asked for

Install scripts

Nothing to install (hosted)

Runs as

Hosted (remote endpoint)

Tools (21)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• attach_asset

  Attach an image to a review so the viewer serves and renders it. Pass the file bytes as `content_b64` (base64) and `name` as the exact src the draft uses (for example "/assets/x.png" or "fig/y.svg"). Attach once; it survives every update_source revision. On the local stdio server you can pass `path` instead, a local file path the wrapper reads and encodes for you, which keeps large files out of the conversation. A remote server cannot read your files, so it needs `content_b64`. Returns the stored name and the served url.

• create_comment

  Author a NEW comment on a document, anchored to a quoted phrase — use this to leave review feedback at a specific spot (you act as a reviewer). Pass `quoted_text` = the exact phrase from the source to anchor to (the viewer highlights it wherever it occurs) and `text` = your comment. Omit `quoted_text` for a document-level (unanchored) note. Attributed to `role` (default `agent`). After this, the reviewer (or you) can reply/resolve it like any thread.

• create_review

  Create a review from markdown; returns the id and the review and feedback urls. The viewer renders GFM, Mermaid diagrams (```mermaid fenced blocks), LaTeX math ($...$ inline, $$...$$ display), GFM footnotes, syntax-highlighted fenced code (label the language) and images (attach them with attach_asset). A flow, decision tree, state machine or architecture reads best as a ```mermaid diagram, since a plain code fence renders as monospace text. Optional project, session and source_path record where the draft came from, for the dashboard. kind="latex" (default "markdown") makes a research-paper rev…

• delete_comment

  Permanently deletes a comment and its whole thread. This cannot be undone. Use it to remove a comment created by mistake; resolve_comment marks a real comment addressed and keeps it in the Resolved panel.

• delete_review

  Delete a review and its data.

• get_comment

  Fetch one comment thread in full — every reply plus the status_history (the open -> resolved -> reopened transitions).

• get_feedback

  Get a review's human feedback: structured notes (now including a projection of the comments) plus the rendered markdown block. For the full threads use list_comments.

• get_git_url

  Returns a git clone URL for a review's history: one commit per past round plus a live tip commit, so git log, git diff and git blame work with standard tools. Only available when the server has git-tracked history enabled; otherwise the call returns 404. Read-only: no push, no branching.

• get_history

  List a review's past rounds; with `round`, fetch one past draft plus the feedback it received.

• get_review

  Get one review's metadata.

• get_source

  Get a review's current source — the draft you edit (markdown, or raw LaTeX for a kind=latex review). Read it before applying feedback when you didn't keep the draft in memory (e.g. a resumed session). By default the result is the raw document verbatim, exactly as before. Pass with_revision=true to instead get a JSON envelope {"source": ..., "revision": N}: the revision is the optimistic-concurrency token for update_source's expected_revision, issued atomically with this read (same response), so use THIS — never a separate get_status poll — as the token source when you plan a guarded save.

• get_status

  Cheap poll: a review's source_updated, feedback_updated, and comments_updated timestamps. Watch comments_updated for new/changed comment threads. Also carries revision and can_edit (#288) — but for a guarded update_source take the revision from get_source(with_revision=true), the read that gave you the text, never from this poll. source_updated_by (#289) names who authored the current draft: "reviewer" means the human edited the document since your last write, so re-read the source before saving; "agent" (the default) means the last write was yours.

• hand_back

  Hand the turn back to the reviewer. Sets turn=reviewer on the review, so the viewer's banner reads 'Agent updated the draft, your turn' (state=done, the default) or 'Agent needs you' (state=blocked, used when you replied with a question instead of finishing); `message` is shown in that banner. Use it after update_source and the replies or resolves on the comments you addressed, or when blocked; for blocked, pair it with a comment reply that asks the question. Reopening a comment is a reviewer action in the viewer, not an agent action. Not available on a kind=latex review, which has no turn bat…

• list_assets

  List a review's attached assets (name, stored name, served url, bytes, ctype).

• list_comments

  List comments on a document, filtered by `status`: open (default), resolved, reopened or all. Reply to a comment to discuss it; resolve it once it is addressed.

Signals

Stars

2

Forks

0

Open issues

12

Last commit

Sep 29, 2026 (29 days ago)

Last release

Sep 29, 2026 (29 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name

io.github.ranawaqas-ai/mdreview

Version

0.7.0

Auth

Auth not stated

License

Apache-2.0

Repository

github.com/ranawaqas-ai/mdreview-service

Website

mdreview.space

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql