reviewable-artifacts-mcp

Reviewable MCP

Reviewable is the human review layer for AI-generated artifacts. Its reviewable-artifacts-mcp package is a dependency-free, read-only stdio MCP server. Workspace mode discovers reviews linked to the configured owner key; share mode exposes only explicitly configured reviewer links.

Install and configure

The package publication and MCP Registry listing are release steps. After publishing, configure workspace mode with a credential-free HTTPS origin and a local workspace key. Treat the key as a password and keep it out of committed files and logs.

REVIEWABLE_MCP_BASE_URL='https://review.example' \
REVIEWABLE_MCP_WORKSPACE_KEY='your-local-workspace-key' \
  npx -y reviewable-artifacts-mcp

This mode lists active reviews by default. list_reviews can filter by lifecycle (active, archived, or all) and handoff state (no_handoff, stale, ready_to_regenerate, blocked, or no_actionable_handoff).

For review-specific, least-privilege access, use share mode with one or more reviewer links separated by whitespace or commas:

REVIEWABLE_MCP_REVIEWS='https://one.example/?session=one#cap=token-one, https://two.example/?session=two#cap=token-two'

Claude Code configuration:

claude mcp add --transport stdio reviewable-artifacts \
  --env REVIEWABLE_MCP_BASE_URL='https://review.example' \
  --env REVIEWABLE_MCP_WORKSPACE_KEY='your-local-workspace-key' \
  -- npx -y reviewable-artifacts-mcp

Codex configuration:

[mcp_servers.reviewable-artifacts]
command = "npx"
args = ["-y", "reviewable-artifacts-mcp"]

[mcp_servers.reviewable-artifacts.env]
REVIEWABLE_MCP_BASE_URL = "https://review.example"
REVIEWABLE_MCP_WORKSPACE_KEY = "your-local-workspace-key"

/demo reviewer links are also accepted in share mode: the server follows the redirect once at startup and reads the reviewer session and capability from the final URL.

See the published MCP tool contract for tool semantics and the agent-context/v1 consumer boundary.