Review Assist MCP
Turn a coding agent's session into an Intent Document checked against the diff
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 1.1.1
- Listing updated
- 3 days ago
About Review Assist MCP
Review Assist MCP is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
The package targets a review problem: reading AI-written code tells you what changed but not why. Review Assist has the agent write down the real problem, its assumptions, rejected approaches and a walkthrough anchored to each change, then checks that document against the diff before it is saved.
It splits authoring between two roles that cannot reach each other's tools. The Author holds the session transcript but cannot submit; the Intent Reviewer never sees the transcript and is the only one who can submit. The server never calls a model itself; it supplies the diff and transcript and gatekeeps the result.
The server is half of the setup. A separate GitHub App turns the committed document into a guided review on the pull request, with no workflow file and no runner minutes. The site says the session transcript stays on your machine and the app keeps no database, though code passes through the hosted app in transit unless you self-host.
Install
Run in a terminal
claude mcp add review-assist-mcp -- npx -y review-assist-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"review-assist-mcp": {
"command": "npx",
"args": [
"-y",
"review-assist-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"review-assist-mcp": {
"command": "npx",
"args": [
"-y",
"review-assist-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"review-assist-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"review-assist-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"review-assist-mcp": {
"command": "npx",
"args": [
"-y",
"review-assist-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"review-assist-mcp": {
"command": "npx",
"args": [
"-y",
"review-assist-mcp"
]
}
}
}Tools this server provides (7)
Taken from the project documentation; the running server may differ.
- compute_diff
- Returns the run handle, numbered hunk index and SHAs for a change.
- read_diff
- Returns the change itself a page at a time.
- submit_document
- Submits the validated Intent Document; available to the Reviewer role only.
- read_transcript
- Gives the Author role the session transcript.
- get_role_definitions
- Installs the Author and Reviewer roles as subagents.
- manage_consent
- Manages consent settings.
- import_session
- Imports a session for authoring.
What it does
- Intent Document
- Captures the problem, assumptions, rejected approaches and anchored walkthrough of changes.
- Diff validation
- Checks the document against the real diff before writing it.
- Two-role split
- Author and Reviewer roles are enforced by separate tool sets.
- Paged diff reading
- Large changes are read a page at a time so responses stay small.
- GitHub App pairing
- A companion app renders the document as a guided pull request review.
- No model calls
- The server supplies ground truth and leaves generation to your agent.
Good for
- Review a large agent-written pull request by its reasoning
- Hand a reviewer the assumptions behind a change
- Audit whether tests cover a stated behaviour
- Keep session context attached to a PR
Pricing
Open source
Free and open source (Apache-2.0)
Prices change. Check reviewassist.dev before you buy.
Review Assist MCP FAQ
Which agents work with it?
It ships tested with Claude Code, the Claude desktop app and Codex, and any MCP client can register it.
Is it free?
Yes. The site says the server and GitHub App are free under Apache-2.0 with no paid tier.
Is my code stored?
The site says no: the app reads the document and diff per request and holds them in memory, but code does pass through the hosted service unless you self-host.
Do I need the GitHub App?
Without it the document is still written to .intent/ in the repo, but nobody sees it on the pull request.
Is Review Assist MCP free?
Yes. Review Assist MCP is open source, so you can use and self-host it for free.
How do I add Review Assist MCP to Claude Code?
Run this command in your terminal: claude mcp add review-assist-mcp -- npx -y review-assist-mcp
What are the best alternatives to Review Assist MCP?
The closest alternatives to Review Assist MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Review Assist MCP

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools