Skip to main content
corpus
mcp server / read-only adapter

corpus-mcp

A stdio MCP server that lets agent clients ask a corpus workspace for scope, checks, parsed artifacts, and reconcile facts.

It is an adapter, not a judge. It gives the agent better context; it does not approve the work.

v0 surfaceread-onlyno verdictNode >= 18.18
pwrcheckevidence
mcp.json

// Claude Desktop / Cursor MCP config

{

"mcpServers": {

"corpus": {

"command": "corpus-mcp",

"args": ["--workspace", "/path/to/corpus-workspace"]

}

}

}

why a separate package?

mcp sdk lives here / cli stays small

note

corpus-mcp adapts the public --json contract. The CLI keeps its small footprint; the MCP server carries the SDK dependency and process model separately.

This is the “many libraries, not a framework” shape: useful pieces, coupled by public interfaces.

guardrails.ts

What it refuses to be

The server gives an MCP-capable client a clean way to read the workspace. It does not run an agent loop, write reviews, or decide whether the code is done.

  • Read-only

    The server exposes facts from the workspace. It does not write durable artifacts.

  • No verdict

    Tool results carry noVerdictIssued. A human or independent reviewer still owns Pass, Fail, Unverified, or Blocked.

  • Root-confined

    Client inputs are validated before subprocess calls; paths must resolve inside the configured workspace root.

  • CLI contract only

    It shells out to corpus status, check, review, and show with --json. It does not import CLI internals.

tools / 10

MCP tools

Reconcile/check calls plus parsed-artifact loaders. Every tool maps to a fixed corpus CLI invocation with --json.

reconcile

  • corpus_get_status
  • corpus_check_workspace
  • corpus_check_file
  • corpus_scan_task
  • corpus_reconcile_review
  • corpus_validate_review_packet

loaders

  • corpus_get_task
  • corpus_get_spec
  • corpus_get_review
  • corpus_get_checks
resources + prompts

Context the client can ask for

Resources expose the board, checks, and selected artifacts. Prompts steer agents toward scope, evidence, and independent review.

resources

  • corpus://workspace
  • corpus://status
  • corpus://checks
  • corpus://tasks/{id}
  • corpus://specs/{id}
  • corpus://reviews/{id}
  • corpus://findings/{id}

prompts

  • corpus_task_briefing
  • corpus_before_done
  • corpus_review_assistant
  • corpus_evidence_rule
  • corpus_finding_candidate
install.sh

Install from source for now

The package exposes a corpus-mcp binary. It expects the corpus CLI on PATH, unless you point CORPUS_BIN or --corpus-bin at a specific binary.

pwrcheckevidence
terminal

# until a published build is available

$ git clone https://github.com/jcosta33/corpus-mcp.git

$ cd corpus-mcp

$pnpm install && pnpm build && npm link

source

Read the adapter code

The repo is small: config, root guards, CLI invocation, tools, resources, prompts, and tests.

GitHub See the CLI