# Renforge

> Renforge is an open-source MCP server for games and play. Inspect, drive and debug a running Ren'Py visual-novel game from an AI agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Web, Windows, macOS, Linux
- **Website:** https://pypi.org/project/renforge/
- **Repository:** https://github.com/alex-jordan547/renforge-mcp
- **MCP Registry name:** io.github.alex-jordan547/renforge
- **Categories:** games and play, developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add renforge -- uvx renforge
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/renforge
