# Contraptify

> Contraptify is a free MCP server for games and play. Design Minecraft redstone machines with your AI and test them tick by tick. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API
- **Website:** https://contraptify.com
- **Repository:** https://github.com/torsviklabs/contraptify
- **MCP Registry name:** io.github.torsviklabs/contraptify
- **Categories:** games and play
- **Listing updated:** 2026-11-14

## About

The site walks through a real run: an egg cannon on a comparator clock failed its test because dispensers only fire when a signal switches fully off and on, so the AI added a repeater and the retest passed at 7.8 eggs per second. Every design is simulated before you see it, and the result opens in a 3D viewer inside the chat where you can turn it and click parts to see what they do.

The simulator follows Java Edition 26.3 redstone rules, including update order, scheduled ticks, piston timing and quasi-connectivity, and is checked against 339 reference tests. Ready-made machines can be played with even if you have no AI app.

Connect it as a custom connector at https://mcp.contraptify.com/mcp in an app that supports MCP. The site says it is free and was tested with Claude.

## Features

- **Tick-level simulation:** Designs run under Java Edition 26.3 redstone rules before you see them.
- **3D viewer in chat:** Turn the machine and click any part to see what it does.
- **Test-driven design:** The AI writes a test, reads failures and fixes the build.
- **Reference tests:** 339 tests compare the simulator against known game behaviour.
- **Ready-made machines:** Play with premade designs without an AI app.

## Good for

- Design a lamp-digit counter driven by a button
- Fix a redstone clock that never turns off fully
- Prototype a dispenser contraption before building it in-game
- Learn what each part of a machine does in 3D

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http contraptify https://mcp.contraptify.com/mcp
```

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

```sh
https://mcp.contraptify.com/mcp
```

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

```json
{
  "mcpServers": {
    "contraptify": {
      "url": "https://mcp.contraptify.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "contraptify": {
      "type": "http",
      "url": "https://mcp.contraptify.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "contraptify": {
      "serverUrl": "https://mcp.contraptify.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "contraptify": {
      "type": "http",
      "url": "https://mcp.contraptify.com/mcp"
    }
  }
}
```

## FAQ

### Is it free?

The site says it is free.

### Which game version's rules does it use?

Java Edition 26.3.

### Do I need an AI app?

To design your own machine, yes, one that supports custom MCP connectors; ready-made machines can be played without one.

### What is the server address?

https://mcp.contraptify.com/mcp over Streamable HTTP.

### Is Contraptify free?

Yes. Contraptify is free to use.

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

Run this command in your terminal: claude mcp add --transport http contraptify https://mcp.contraptify.com/mcp

### What are the best alternatives to Contraptify?

The closest alternatives to Contraptify are AvatarSay — Fictional Character & Talking Video MCP, VfxSmith, Born Then, Haze City and Vector Defence.

## Alternatives

- [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.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [Born Then](https://ai-powered.com/mcp/born-then): Born Then is a free MCP server for education and exams.
- [Haze City](https://ai-powered.com/mcp/haze-city): Haze City is an open-source MCP server for games and play.
- [Vector Defence](https://ai-powered.com/mcp/vector-defence): Vector Defence is a free MCP server for knowledge and memory.
- [Vector Abyss](https://ai-powered.com/mcp/vector-abyss): Vector Abyss is a free MCP server for knowledge and memory.
- [Vectoroids](https://ai-powered.com/mcp/vectoroids): Vectoroids is a free MCP server for games and play.
- [Vector Alienspace](https://ai-powered.com/mcp/vector-alienspace): Vector Alienspace is a free MCP server for knowledge and memory.

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