Let the agent that wrote the code walk you through it.

mcp-review is a code review viewer that your coding agent fills in for you. The agent sorts every change into a story you can follow, and you read it in a fast viewer on your laptop or your phone. The viewer never calls a model: the agent that you already use does the explaining.

Your reviews stay on your own machine. Your agent keeps using the model provider that it is set up with, and the viewer adds no model endpoint of its own.

The demo review in the viewer, with its summary and its groups of changes The same review on a phone

why I built it

I made this for myself

My coding agents now write more code than I can properly read, and I kept ending up as the slow part of my own work. The tools that promise to help are mostly one more AI subscription, which sends my code off to someone else's model and bills me a second time for a review my own agent has pretty much done already.

So I built mcp-review the other way around: my agent does the sorting and explaining, and the server never calls a model at all. I review my own changes in it, and whenever something gets in my way, I fix it.

It's made by a developer, for developers. If you try it and something bugs you, tell me, and it'll probably bug me too.

Nikita

how it works

How a review goes

  1. 1 · your agent

    Your agent captures the change and sorts it

    It has already been through this change with you while you built it, so it has the context. Ask your agent to group the changes and explain each group.

  2. 2 · you

    You read it in the viewer

    On a laptop or a phone. You tick off what you've looked at and leave comments on any line.

  3. 3 · back to the agent

    Your comments go back to the agent

    It answers you, fixes what you ask it to and captures a new round for you to look at.

None of this needs a separate model or another subscription. mcp-review works with any agent that supports standard MCP, including Claude Code, Codex and Cursor.

story navigation

Read the change in the order that makes sense

Instead of a list of files in alphabetical order, your agent puts every edit into a group based on what it does. Each group gets a short explanation and a mark for how closely you should look at it.

core logic
the change itself
consequences
what had to change because of it
glue
wiring and configuration
tests
what proves it works
noise
formatting, imports, moved code

review fyi nit

Lockfiles, generated code and vendored files are spotted by the server itself and put to one side, so you don't have to scroll past them to get to the real change.

The navigation of the demo review: its groups of changes with their marks
A group of repeated changes: two examples, then the remaining files closed with their count

Repeated changes, shown once

When the same edit repeats across many files, the agent can show a few examples and close the rest. You check the pattern once and mark the whole group as reviewed.

rich diffs

Every kind of file, shown the way you'd check it

Code is compared by its syntax, documents are rendered, diagrams are drawn and images sit side by side. Video and audio play right inside the review as well.

A changed line of code with its changed words marked

Code, word by word

Inside a changed line, only the parts that actually changed are highlighted, so a small edit in a long line is easy to spot.

A Markdown document rendered Before and After

Docs, rendered

You read the Before and After of a document the way people will actually read it, not as raw markup.

A changed sequence diagram with its added and removed steps marked

Diagrams, drawn

Diagrams written as text are drawn for both versions. In sequence diagrams, added and removed steps are marked on the picture.

An old and a new version of a screenshot, side by side

Images, compared

The Before and After of an image show together, with the changes to the source file underneath.

The first screen of the large demo review on a phone
Recorded from the large demo in a phone-sized browser.

on your phone

Review on your phone

You can go through a review on your phone, even a large one. The viewer loads only the rows that are near the screen.

Open it from your phone over your own private network, such as Tailscale.

The large demo is a review of 588 files and 25,796 changed lines: 14,668 added and 11,128 removed.

Try the large review on your phone

second round

The second round picks up where you left off

Every time your agent captures the change, it's kept as a snapshot. When the agent comes back with fixes, you can look at just what changed since last time, and anything you already reviewed that didn't change stays ticked off and folded out of the way.

The second round of the demo review: the edited file with its update, and reviewed code folded away
A comment thread on a changed line, with the answer of the agent

comments

Talk it through with your agent

Leave a comment on any line and your agent can reply right there in the thread. It can also stop and wait for your answer before it carries on, and more than one agent can work on the same review. When you're happy with it, your comments go to the pull request exactly as you wrote them.

your machine

It runs on your own machine, and that's deliberate

Right now mcp-review is for one person on their own computer, with no accounts and no login. I'd rather keep it that way than send your code somewhere it doesn't need to go.

  • Your reviews are stored on your machine. Your agent keeps using the model provider that it is set up with, and the viewer adds no model endpoint.
  • The login for your code host stays on your machine as well.
  • The review tool has no telemetry, so nothing reports back to me.
  • Pages are put together on the server without a front-end framework, so there's very little to load.
  • Your reviews are backed up automatically every day.

early access

Get early access

The form sends your email and your answers to this site. Your email goes on the early access list, which Resend keeps for me, and your answers come to me by email. I use them only to get back to you about mcp-review. Privacy