# DMX to GDTF

> DMX to GDTF is a free MCP server for events and entertainment. Find the matching GDTF lighting fixture and DMX mode from a DMX channel list. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API
- **Website:** https://gdtf-lights.com/dmx-to-gdtf
- **MCP Registry name:** com.gdtf-lights/dmx-to-gdtf
- **Categories:** events and entertainment, design and media
- **Listing updated:** 2026-11-14

## About

Lighting designers often hold a console's channel list but not the fixture file that matches it. The matcher compares a pasted list, or a fixture-profile text file, position by position against a library of more than 10,500 GDTF profiles and returns the top 10 candidates, each with a score and a download link.

Matching is forgiving. It normalizes channel names so variants such as ColorAdd_R, Red R and R line up, treats synonyms like Strobe and Shutter or Colors and Color Wheel as equal, and tolerates small typos. The single match_dmx_channels tool accepts channel names in DMX order or free text, with an optional manufacturer filter and a limit of one to ten results. Answers include the matched DMX mode name, a 0 to 100 percent score, a confidence level and a count of fixtures sharing the top score.

When several fixtures tie, the site advises adding the manufacturer or DMX value rows instead of picking blindly. A second tool, generate_mvr, builds a 3D MVR scene with the chosen fixtures patched in that mode. The same search is offered as a JSON API with published rate limits.

## Features

- **Channel list matching:** Compares pasted channels or an uploaded profile against every GDTF fixture in the library.
- **Forgiving name matching:** Normalizes channel names, understands synonyms and tolerates small typos.
- **Scored candidates:** Returns up to 10 matches with score, confidence and the matched DMX mode.
- **MVR scene generation:** Turns a chosen fixture and mode into a 3D MVR scene with the fixtures patched.
- **JSON API alongside MCP:** Offers the same search by plain HTTP, with no login or key.
- **Documented limits:** Publishes per-IP and global rate limits and retry behaviour for 429 and 503 replies.

## Good for

- Identify an unknown moving head from its channel list
- Pick the right DMX mode for a known fixture
- Build a patched MVR scene for visualisation
- Narrow ties by manufacturer or DMX value rows
- Add fixture lookup to a show-control app

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http dmx-to-gdtf https://gdtf-lights.com/mcp/dmx-to-gdtf
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gdtf-lights.com/mcp/dmx-to-gdtf
```

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

```json
{
  "mcpServers": {
    "dmx-to-gdtf": {
      "url": "https://gdtf-lights.com/mcp/dmx-to-gdtf"
    }
  }
}
```

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

```json
{
  "servers": {
    "dmx-to-gdtf": {
      "type": "http",
      "url": "https://gdtf-lights.com/mcp/dmx-to-gdtf"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "dmx-to-gdtf": {
      "serverUrl": "https://gdtf-lights.com/mcp/dmx-to-gdtf"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "dmx-to-gdtf": {
      "type": "http",
      "url": "https://gdtf-lights.com/mcp/dmx-to-gdtf"
    }
  }
}
```

## Tools

- `match_dmx_channels`: Matches DMX channel names or a pasted profile to GDTF fixtures and modes.
- `generate_mvr`: Builds a 3D MVR scene with fixtures patched in a chosen DMX mode.

## FAQ

### How many fixtures can it search?

More than 10,500 GDTF profiles.

### Is a login or key needed?

No, neither for the MCP endpoint nor the JSON API.

### What if several fixtures score the same?

Check same_score_count, then add the manufacturer or DMX values as rows in the text to separate them.

### What are the rate limits?

For the API and MCP tool, 300 searches a minute and 20,000 a day per IP, with a shared global cap; the web page has its own lower limit.

### Is DMX to GDTF free?

Yes. DMX to GDTF is free to use.

### How do I add DMX to GDTF to Claude Code?

Run this command in your terminal: claude mcp add --transport http dmx-to-gdtf https://gdtf-lights.com/mcp/dmx-to-gdtf

### What are the best alternatives to DMX to GDTF?

The closest alternatives to DMX to GDTF 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.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/dmx-to-gdtf
