# paprika3d (the three.js toolset for coding agents)

> paprika3d (the three.js toolset for coding agents) is a free MCP server for design and media. Playtest, profile and build three.js games and 3D pages from your coding agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS
- **Website:** https://paprika3d.com/docs
- **Repository:** https://github.com/paprika3d/paprika3d
- **MCP Registry name:** io.github.paprika3d/paprika3d
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-14

## About

The server drives Google Chrome so an agent can load a three.js or WebGL page, play it, measure every frame and look for faults such as invisible models, files that never loaded and flickering, see-through or inside-out faces. Fixing those before reporting a build as done is the stated point.

A longer workflow sits on top, started with `/paprika3d:paprika-make` in Claude Code or the paprika-make MCP prompt elsewhere. It collects references (with licences and sources from Wikimedia Commons and Openverse), writes a style sheet and character sheets, then a design doc where the creative decisions are left to you, then builds. Image-model look boards and character views need your own fal, OpenAI or Gemini key; a free look board from your references is always made.

The project reports that Sonnet 5.5 made 86% of its 3D objects pass all checks with the tools against 66% without, over 150 runs per arm, using checks from 3JSBench. It needs Chrome and Node 20.11 or later, and works with Claude Code, Codex CLI, Gemini CLI, Cursor, VS Code and Windsurf.

## Features

- **Playtesting in Chrome:** Loads a page, plays it and measures every frame.
- **Model and render checks:** Looks for invisible models, failed file loads and flickering or inside-out faces.
- **Reference gathering:** Collects licensed reference images and optional study references and free models.
- **Look and character sheets:** Writes LOOK.md and CHARACTERS.md from tagged references.
- **Design doc stage:** Drafts a design doc and asks you about calls that change the game.
- **Improvement loops:** Repeats build, test and fix for a set amount of time.

## Good for

- Playtest a three.js page your agent just wrote
- Find why a model is invisible or a file never loaded
- Build a small 3D game from a one-line request
- Create a style sheet and character sheets from references
- Run an improvement loop on a game for an hour

## Install

### Claude Code (Terminal)

```sh
claude mcp add paprika3d -- npx -y paprika3d
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "paprika3d": {
      "command": "npx",
      "args": [
        "-y",
        "paprika3d"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "paprika3d": {
      "command": "npx",
      "args": [
        "-y",
        "paprika3d"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "paprika3d": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "paprika3d"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "paprika3d": {
      "command": "npx",
      "args": [
        "-y",
        "paprika3d"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "paprika3d": {
      "command": "npx",
      "args": [
        "-y",
        "paprika3d"
      ]
    }
  }
}
```

## Tools

- `reference`: Gathers numbered reference pictures for the references stage.
- `sheet`: Produces a preview look board for the look and characters stage.

## FAQ

### What does it need to run?

Google Chrome and Node 20.11 or later. The Claude Code plugin needs Claude Code 2.1.118 or later.

### Which agents work with it?

Claude Code, Codex CLI, Gemini CLI, Cursor, VS Code with GitHub Copilot, Windsurf and other MCP clients.

### Do I need image-model keys?

Only for image-model look boards and character views, which use your own fal, OpenAI or Gemini key. A free look board is always made.

### How is it started?

`npx -y paprika3d serve`, or the Claude Code plugin with `/paprika3d:paprika-make <request>`.

### Is paprika3d (the three.js toolset for coding agents) free?

Yes. paprika3d (the three.js toolset for coding agents) is free to use.

### How do I add paprika3d (the three.js toolset for coding agents) to Claude Code?

Run this command in your terminal: claude mcp add paprika3d -- npx -y paprika3d

### What are the best alternatives to paprika3d (the three.js toolset for coding agents)?

The closest alternatives to paprika3d (the three.js toolset for coding agents) are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [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.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/paprika3d-the-three-js-toolset-for-coding-agents
