# PAGAN

> PAGAN is an open-source MCP server for design and media. Write pixel art, tilesets and 3D sprite models as text; lint, preview and build for Godot. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://pagan.top
- **Repository:** https://github.com/lukasgolino/pagan
- **MCP Registry name:** io.github.lukasgolino/pagan
- **Categories:** design and media, games and play
- **Listing updated:** 2026-11-14

## About

Sprites are palette-keyed grids in YAML, and the tool also handles tilesets, 3D voxel models rendered from several headings or exported as glTF meshes, animations and style rules. An agent writes the files, runs lint for format errors and style warnings, looks at upscaled previews and GIFs, then builds sprite sheets with a manifest.json holding frame rectangles, animations, pivots and tile coordinates.

For Godot 4 it writes SpriteFrames and TileSet resources; since Godot resources cannot hold a pivot, the manifest gives a godot_offset to apply on the node. An isometric dimetric camera setting suits 2:1 tile maps. Every command accepts --json and exits non-zero on errors, and builds are described as byte-identical.

The package is pagan-gen on PyPI (Python 3.11 or newer) and runs locally with no account. The README marks it as early development, though the full pipeline works. It is Apache 2.0 licensed and has sister libraries for 3D models and game audio.

## Features

- **Pixel grids as text:** Palette-keyed YAML sprites and tiles.
- **3D models as sprites:** Voxel models rendered from several headings or exported as glTF.
- **Previews and gallery:** Upscaled sheets, frames and GIFs for review.
- **Lint:** Format errors and style warnings.
- **Manifest output:** manifest.json with frames, pivots and tile coordinates.
- **Godot 4 resources:** SpriteFrames and TileSet files.
- **Isometric camera:** Dimetric projection for 2:1 tile games.

## Good for

- Let an agent draw a potion or slime sprite
- Generate a ship that turns smoothly across headings
- Build meadow tilesets for a Godot TileMap
- Keep a game's art consistent with palette and style rules
- Export meshes for a 3D game

## Install

### Claude Code (Terminal)

```sh
claude mcp add pagan -- uvx pagan-gen
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "pagan": {
      "command": "uvx",
      "args": [
        "pagan-gen"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pagan": {
      "command": "uvx",
      "args": [
        "pagan-gen"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "pagan": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "pagan-gen"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pagan": {
      "command": "uvx",
      "args": [
        "pagan-gen"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pagan": {
      "command": "uvx",
      "args": [
        "pagan-gen"
      ]
    }
  }
}
```

## FAQ

### How do I install it?

pip install pagan-gen; the command is pagan.

### Is it stable?

The README calls it early development, though the full pipeline works.

### Which engines work?

Any engine can use the PNG sheets and manifest; Godot 4 gets ready-made resources.

### Does it cost anything?

It is free and Apache 2.0 licensed.

### Is PAGAN free?

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

### How do I add PAGAN to Claude Code?

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

### What are the best alternatives to PAGAN?

The closest alternatives to PAGAN are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.

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