Renforge
Inspect, drive and debug a running Ren'Py visual-novel game from an AI agent
- 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 renforgeAdd to claude_desktop_config.json
{
"mcpServers": {
"renforge": {
"command": "uvx",
"args": [
"renforge"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"renforge": {
"command": "uvx",
"args": [
"renforge"
]
}
}
}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

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