Skip to content

Rephrased MCP

Local Rephrased MCP is the required team toolkit. Your coding agent (Cursor, Claude Code, Codex, Antigravity, or another IDE that can run MCP) uses it so you can talk normally — you do not name tools.

After setup, the server runs your own code review, a pass on the team review server, wiki search, and devlog. Unreal MCP is a separate, suggested editor add-on.

Prerequisites

  • [ ] You have cloned the Rephrased repo
  • [ ] A coding agent is installed (Cursor, Claude Code, Codex, Antigravity, or another MCP-capable IDE)
  • [ ] uv is installed (used to run the MCP server)

Setup (about 2 minutes)

1. Install the MCP toolkit

From the repo root:

uv tool install tools/rephrased-mcp

2. Point your IDE at the local server

Cursor — .cursor/mcp.json (create if missing):

{
  "mcpServers": {
    "rephrased": {
      "command": "uvx",
      "args": ["--from", "tools/rephrased-mcp", "rephrased-mcp"]
    }
  }
}

Claude Code — same JSON in .claude/mcp.json (this repo already ships one).

Codex / Antigravity / other MCP-capable IDEs — paste the same rephrased block into that product's MCP settings. Setup pages: Cursor, Claude Code, Codex, Antigravity.

Suggested — Unreal MCP (editor tools: maps, assets, PIE). Add this next to rephrased after you enable the 5.8 plugins. See Unreal MCP.

"unreal-mcp": {
  "url": "http://127.0.0.1:6388/mcp"
}

Port 6388 is the team pin so it does not collide with other MCP on 8000. It only answers while the UE 5.8 editor is running.

Restart the IDE (or reload MCP servers) after saving.

3. Register (onboard)

In chat, run /onboard (or ask the agent to call onboarding register). Provide:

  1. The team review key (from your lead)
  2. (Optional) your display name

This writes ~/.rephrased/config.json, verifies the review server, and enables versioned Git hooks (core.hooksPath=scripts/git-hooks).

4. Verify

After /onboard, confirm the agent can see these tools: onboarding, convention_check, request_review, wiki_query, devlog.

Ask:

What does convention_check do?

If the agent answers from the wiki and repo state, setup is done. If not, check that the rephrased MCP server is running and that you are onboarded.

What Rephrased MCP does

Three jobs. The agent runs them. You ask in normal language.

1. Your code review (convention_check)

Local scan of the current git diff against Rephrased UE conventions (AGENTS.md / Coding conventions):

  • UE_LOG ASCII only — no emoji, no decorative banners, no empty logs
  • No sectional banner comments
  • Actor ids via GetActorNameOrLabel(), not GetName()
  • Include order: own header → engine → project → third-party
  • No speculative placeholder blocks (TODO/FIXME unused/placeholder)

The agent must run this after it edits Source/ C++, and again before commit. It fixes every error/warning it flags, then re-runs until clean. This is your review — it never leaves the machine. It does not replace the team review server or a human PR.

2. Team review (request_review)

After convention_check is clean and you have compiled, the agent sends the project diff to the team review server — a Rephrased-design review server with a separate, clean review LLM. It reads:

  • Source/ C++ text
  • Config/ text
  • Content/ map and uasset paths (not binary guts)

It is a second pass for gameplay / systems mistakes convention check will not catch. If it returns issues, the agent fixes and sends again until pass or [WARN] No project diff. Your compile and PIE still happen. The review server does not replace a teammate on the PR.

Order before commit:

convention_check → you compile → team review (request_review) → you PIE → devlog → commit

Wiki search (wiki_query) and session devlog also go through this same MCP. They are not a fourth review.

Daily usage

Engineers talk normally ("fix the overlap", "help me commit"). The coding agent must call MCP tools from AGENTS.md / CLAUDE.md without being asked.

You say Agent must call
How does camera / runes work? wiki_query
Help me commit / done convention_check → you compile → request_review → you PIE → devlog

Advisory Git hooks remind you of the review order on commit/push; they do not block. See What Rephrased MCP does above.

Troubleshooting

Symptom Likely cause Fix
MCP tools missing Server not configured / not reloaded Check mcp.json, reinstall with uv tool install, reload MCP
Not onboarded No ~/.rephrased/config.json Run /onboard again
Review model error on non-C++ Droplet prompt still C++-only Update droplet review prompt to accept asset path lists; client already sends them

Change history

  • 2026-08-23 — Gabriel Li — Removed Accretion Engine (task system retired); onboarding is review-key only; task tools removed from toolkit.
  • 2026-08-14 — Gabriel Li — Page titled Rephrased MCP; after setup, Accretion, local convention review, and the team review server are spelled out.
  • 2026-08-13 — Gabriel Li — Linked Unreal MCP; shipped mcp.json example includes port 6388.
  • 2026-08-10 — Gabriel Li — Added task_create/task_assign, timer hours, risk tier; Cursor mcp.json in repo.
  • 2026-08-10 — Gabriel Li — Rewrote for local uvx MCP, onboarding register, review gate, English-only; removed obsolete remote URL + env-token flow.
  • 2026-07-21 — Gabriel Li — Initial doc (remote MCP + ACCRETION_TOKEN env).