# loenn-mcp

> loenn-mcp is an MCP server for games and play. Read, edit, validate, preview and generate Celeste .bin maps from an AI client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, Windows
- **Repository:** https://github.com/magedeline/loenn-mcp
- **MCP Registry name:** io.github.Magedeline/loenn-mcp
- **Categories:** [games and play](https://ai-powered.com/categories/games-and-play), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

Loenn-mcp is aimed at Celeste mod makers who want an agent to work on map files without opening the Lönn editor. It handles Everest mods and maps made in Lönn or Ahorn. The README stresses that despite the name no AI runs inside: every tool is deterministic and procedural, and the agent is simply whoever calls it.

Tools cover reading rooms and tiles, searching entities and triggers, adding and moving entities, creating rooms and maps, decals and stylegrounds, entity definitions taken from Lönn plugins, playability validation with auto-fix, ASCII and interactive HTML previews, and JSON round-tripping of whole maps. It can also drive a running game through Everest's debug server and play CelesteTAS inputs to test a room.

Writes are guarded. Each write keeps a timestamped backup, maps open in Lönn are protected, and protected chapter maps change only through copy, diff and commit steps. A companion pcgscene CLI supports scripting and CI, and generators build rooms from patterns, images or seeded noise.

## Features

- **Map reading and search:** Inspect rooms, tiles, entities and triggers across .bin maps.
- **Safe editing:** Timestamped backups, atomic writes and protected maps.
- **Playability validation:** Validate maps and auto-fix some problems.
- **Procedural generation:** Generate rooms from patterns, images or seeded terrain.
- **Interactive preview:** Render maps to a zoomable HTML view.
- **Game control:** Reload maps, teleport and play TAS inputs in the running game.

## Good for

- Add entities to a Celeste room from a prompt
- Validate a map before release
- Generate a gray-box layout from an image
- Preview a planned merge before writing it
- Audit missing Lönn plugin definitions

## Install

### Claude Code (Terminal)

```sh
claude mcp add loenn-mcp -- npx -y https://github.com/Magedeline/loenn-mcp/releases/download/v7.2.0/loenn-mcp-7.2.0.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "loenn-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Magedeline/loenn-mcp/releases/download/v7.2.0/loenn-mcp-7.2.0.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "loenn-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Magedeline/loenn-mcp/releases/download/v7.2.0/loenn-mcp-7.2.0.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "loenn-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Magedeline/loenn-mcp/releases/download/v7.2.0/loenn-mcp-7.2.0.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "loenn-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Magedeline/loenn-mcp/releases/download/v7.2.0/loenn-mcp-7.2.0.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "loenn-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Magedeline/loenn-mcp/releases/download/v7.2.0/loenn-mcp-7.2.0.mcpb"
      ]
    }
  }
}
```

## Tools

- `list_maps`: List .bin map files
- `read_map_overview`: Summarise rooms, entities, triggers and stylegrounds
- `read_room`: Full room details
- `search_entities`: Find entities by type, position or room
- `add_entity`: Place an entity
- `set_room_tiles`: Replace a tile grid
- `create_map`: Create a new .bin file
- `map_to_json`: Convert a map to typed JSON
- `validate_map`: Check playability
- `render_map_html`: Interactive HTML map preview
- `generate_map_from_image`: Convert an image to a map
- `generate_terrain_map`: Procedural terrain map
- `game_play_tas`: Play CelesteTAS inputs in the game
- `map_commit`: Commit a copy to a protected map

## FAQ

### Does it use AI internally?

No. The README says every tool is deterministic and procedural.

### Does it overwrite my maps?

Every write keeps a timestamped backup, and protected maps change only through a commit step.

### Is there a command-line tool?

Yes, pcgscene for scripting and CI.

### How is it installed?

The registry lists a packaged bundle release; the README also mentions a PyPI package.

### How do I add loenn-mcp to Claude Code?

Run this command in your terminal: claude mcp add loenn-mcp -- npx -y https://github.com/Magedeline/loenn-mcp/releases/download/v7.2.0/loenn-mcp-7.2.0.mcpb

### What are the best alternatives to loenn-mcp?

The closest alternatives to loenn-mcp are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [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.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers 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.

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