Skip to content
MCP server

Renforge

Inspect, drive and debug a running Ren'Py visual-novel game from an AI agent

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, Web, Windows
Runs
Locally
Version
0.7.5
Listing updated
3 days ago

About Renforge

Renforge is an open-source MCP server for games and play. It runs locally on your machine and is started by your AI client.

RenForge is built around a Live Editor: inside a running Ren'Py game you select an on-screen control, preview layout moves, and save to .rpy source only when the target is safe to write. Locked or unsupported targets stay inspectable with a stated reason rather than being forced. The project is marked alpha and says APIs may still change.

An agent's typical loop reads renforge_info, launches the game, polls launch status, takes screenshots or reads the scene tree, uses guarded clicks, verifies the result and stops the game. Other abilities listed include driving runtime state, generating translations, finding orphaned assets, running builds and searching Ren'Py's docs.

It ships as a Python package with an MCP server, a CLI and an optional web dashboard with a story map and asset audit. Python 3.11 or later and uv are enough; if no Ren'Py SDK is found, one is downloaded on first launch.

Install

Run in a terminal

claude mcp add renforge -- uvx renforge

Add to claude_desktop_config.json

{
  "mcpServers": {
    "renforge": {
      "command": "uvx",
      "args": [
        "renforge"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "renforge": {
      "command": "uvx",
      "args": [
        "renforge"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "renforge": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "renforge"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "renforge": {
      "command": "uvx",
      "args": [
        "renforge"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "renforge": {
      "command": "uvx",
      "args": [
        "renforge"
      ]
    }
  }
}

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

renforge_info
Reads project and Live Editor information.
renforge_launch
Launches the game.
renforge_launch_status
Polls launch progress.
renforge_screenshot
Captures a screenshot.
renforge_scene_tree
Returns the on-screen scene tree.
renforge_click_at
Guarded click at a position.
renforge_click_element
Guarded click on an element.
renforge_stop
Stops the game.

What it does

Live Editor
Select and move controls in the running game, then save to source when safe.
Guarded clicks
Click by position or element with checks before acting.
Scene tree and screenshots
Inspect what is on screen as structure or image.
Asset audit
Find orphaned and missing assets and undefined images.
Translation and builds
Generate translations and run builds.
Web dashboard
Control a running game and view a story map from a browser.

Good for

  • Have an agent tweak a screen layout and save it to the .rpy file
  • Debug game state while a visual novel runs
  • Find unused images before shipping a build
  • Generate translation files for a project
  • Warp the running game to a story node

Pricing

Open source

Free package on PyPI

Prices change. Check pypi.org before you buy.

Renforge FAQ

Do I need Ren'Py installed?

No. It reuses an SDK it finds or downloads one on first launch.

How is it started?

With uvx renforge@latest serve for MCP, or uvx with renforge[ui] for the dashboard.

Is it stable?

The project calls itself alpha and says APIs may change.

Can I skip the dashboard?

Yes, a slim install gives only the MCP server and CLI.

Is Renforge free?

Yes. Renforge is open source, so you can use and self-host it for free.

How do I add Renforge to Claude Code?

Run this command in your terminal: claude mcp add renforge -- uvx renforge

What are the best alternatives to Renforge?

The closest alternatives to Renforge are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Renforge

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools