VibeTide Levels is a comprehensive level editor for the VibeTide 2D platformer game that enables AI-assisted creation, modification, and visualization of custom game levels. Key features include: - Create new levels from scratch or generate full layouts with AI assistance - Granular editing capabilities — modify entire levels, single rows, or individual tiles - Visualize levels as ASCII art or high-quality PNG images for preview and sharing - Launch levels instantly in the VibeTide web player for immediate gameplay testing - Decode existing levels from shared URLs to load and remix community creations - Manage level metadata including spawn rates, difficulty settings, and other gameplay properties

VibeTide MCP Server

A Model Context Protocol (MCP) server for creating, editing, and playing VibeTide 2D platformer levels. This server provides tools for level manipulation, visualization, and gameplay through the MCP protocol.

[](https://opensource.org/licenses/MIT) [](https://www.python.org/downloads/) [](https://smithery.ai/server/@banjtheman/vibe_tide_mcp) [](https://badge.fury.io/py/vibe-tide-mcp-server)

🎮 Screenshots & Demo

Level Creation and Editing

*Create beautiful 2D platformer levels with AI assistance*

Gameplay Preview

*Play your created levels in the web player*

Features

Installation

Installing via Smithery

To install VibeTide Level Editor Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @banjtheman/vibe_tide_mcp --client claude

Option 1: Using UVX (Recommended)

If you have uvx installed, you can run the server directly without local installation:

uvx --from vibe-tide-mcp-server vibe-tide-mcp-server

Option 2: Local Installation

1. Clone the repository:

git clone https://github.com/banjtheman/vibe_tide_mcp.git
cd vibe_tide_mcp

2. Install dependencies:

pip install -r requirements.txt

3. Make the server executable:

chmod +x vibe_tide_mcp_server.py

Configuration

MCP Client Configuration

Add the server to your MCP client configuration:

#### Local Python Server

{
  "mcpServers": {
    "vibe-tide": {
      "command": "python",
      "args": ["/path/to/vibe_tide_mcp_server.py"],
      "env": {}
    }
  }
}

#### Using UVX

{
  "mcpServers": {
    "vibe-tide": {
      "command": "uvx",
      "args": [
        "--from", "vibe-tide-mcp-server", "vibe-tide-mcp-server"
      ],
      "env": {}
    }
  }
}

Available Tools

Level Viewing Tools

Level Playing Tools

Level Editing Tools

Level Creation Tools

Tile Types

| Type | Symbol | Name | Description | |------|---------|------|-------------| | 0 | ⬜ | Empty | Walkable air space | | 1 | 🌱 | Grass | Standard ground platform | | 2 | 🗿 | Rock | Solid stone platform | | 3 | ⭐ | Yellow | Special yellow platform | | 4 | ❄️ | Ice | Slippery ice platform | | 5 | 🔥 | Red | Dangerous red platform | | 6 | ⚠️ | Spikes | Hazardous spikes | | 7 | 💧 | Water | Water tiles |

Examples

Creating a New Level

# Create a simple level with platforms
level_tiles = [
    [0, 0, 0, 0, 0, 0, 0, 0, 0, 0],  # Empty top row
    [0, 0, 0, 0, 0, 0, 0, 0, 0, 0],  # Empty row
    [0, 0, 0, 1, 1, 1, 0, 0, 0, 0],  # Grass platform
    [1, 1, 0, 0, 0, 0, 0, 1, 1, 1],  # Ground platforms
    [2, 2, 2, 2, 2, 2, 2, 2, 2, 2],  # Rock foundation
]
result = create_level(
    level_name="My First Level",
    description="A simple starter level",
    tiles=level_tiles,
    width=10,
    height=5,
    maxEnemies=3,
    enemySpawnChance=10.0,
    coinSpawnChance=20.0
)

Editing a Level

# Edit a single tile
result = edit_level_tile(
    encoded_level="your_encoded_level_here",
    row=2,
    col=5,
    new_tile_type=6  # Add spikes
)
Edit level metadata
result = edit_level_metadata(
    encoded_level="your_encoded_level_here",
    new_name="Updated Level",
    max_enemies=5,
    enemy_spawn_chance=15.0
)

Viewing and Playing Levels

```python

View level visualization

Generate PNG image