# OSCAR

> OSCAR is an open-source MCP server for events and entertainment. Lets an AI assistant inspect an OSCAR show-control setup and draft interfaces for review. 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://www.createwithoscar.site/how-it-works
- **Repository:** https://github.com/trafalmejo/oscar/tree/HEAD/createwithoscar
- **MCP Registry name:** io.github.trafalmejo/oscar
- **Categories:** events and entertainment, design and media
- **Listing updated:** 2026-11-16

## About

OSCAR is a free, open-source editor and server that serves pages of buttons, sliders and other controls to phones and tablets and turns each touch into OSC, MIDI or DMX for show software, instruments and lights. This npm package links an assistant to the OSCAR running on the same computer, and it only talks to that local instance.

Two jobs are described. The assistant can diagnose why a control does not respond by reading projects, what is published, each widget's settings, MIDI ports and the messages OSCAR recently received and sent. It can also draft an interface, which OSCAR's validators check before it appears under File, Open project or template with a Draft badge for you to open and publish yourself.

The README is explicit that the assistant never sends anything to your rig, publishes or changes a project. It requires OSCAR 2.1 or later with the MCP pill in the top bar switched on, and the connection finds OSCAR through a local file holding a token that changes at every start. Node 18 or later is needed.

## Features

- **Troubleshooting reads:** Inspect projects, widget settings, MIDI ports and recent traffic.
- **Interface drafting:** Generate a draft layout validated by OSCAR.
- **Review before use:** Drafts appear with a Draft badge and are never published automatically.
- **Read-only safety:** Cannot send to gear, publish or modify projects.
- **Local-only link:** Connects to OSCAR on the same computer via a rotating token.

## Good for

- Ask why a slider is not moving a light
- Draft a lighting desk interface with faders and a blackout button
- Check which MIDI ports OSCAR sees
- Review recent OSC traffic when debugging a show

## Install

### Claude Code (Terminal)

```sh
claude mcp add oscar -- npx -y createwithoscar
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## FAQ

### Can the assistant control my lights?

No. It never sends to your rig, publishes or changes a project.

### What do I need to run it?

OSCAR 2.1 or later running locally with the MCP pill green, and Node 18 or later.

### Which assistants work?

Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex, Gemini CLI and other MCP apps.

### What is the licence?

BSD-3-Clause.

### Is OSCAR free?

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

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

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

### What are the best alternatives to OSCAR?

The closest alternatives to OSCAR 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/oscar-2
