# Kiln MCP server

> Lets AI agents design, slice, and print 3D objects on connected printers, with Git-style version control for designs.

- Repository: https://github.com/codeofaxel/Kiln
- Page: https://hostedmcp.org/servers/codeofaxel/kiln
- Transport: stdio, remote
- Stars: 247
- License: AGPL-3.0
- Latest version: 1.5.1

## Install

### Claude Code

```sh
claude mcp add --env 'KILN_PRINTER_API_KEY=<YOUR_KILN_PRINTER_API_KEY>' kiln -- uvx kiln3d
```

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

```json
{
  "mcpServers": {
    "kiln": {
      "command": "uvx",
      "args": [
        "kiln3d"
      ],
      "env": {
        "KILN_PRINTER_API_KEY": "<YOUR_KILN_PRINTER_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "kiln": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "kiln3d"
      ],
      "env": {
        "KILN_PRINTER_API_KEY": "<YOUR_KILN_PRINTER_API_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"kiln","type":"stdio","command":"uvx","args":["kiln3d"],"env":{"KILN_PRINTER_API_KEY":"<YOUR_KILN_PRINTER_API_KEY>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "kiln": {
      "command": "uvx",
      "args": [
        "kiln3d"
      ],
      "env": {
        "KILN_PRINTER_API_KEY": "<YOUR_KILN_PRINTER_API_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add kiln --env 'KILN_PRINTER_API_KEY=<YOUR_KILN_PRINTER_API_KEY>' -- uvx kiln3d
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.kiln]
command = "uvx"
args = ["kiln3d"]

[mcp_servers.kiln.env]
KILN_PRINTER_API_KEY = "<YOUR_KILN_PRINTER_API_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'KILN_PRINTER_API_KEY=<YOUR_KILN_PRINTER_API_KEY>' kiln uvx -- kiln3d
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "kiln": {
      "command": "uvx",
      "args": [
        "kiln3d"
      ],
      "env": {
        "KILN_PRINTER_API_KEY": "<YOUR_KILN_PRINTER_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `KILN_PRINTER_API_KEY` | no | yes | API key for your printer's REST API |
| `KILN_AUTH_ENABLED` | no | no |  |
| `KILN_AUTH_KEY` | no | no |  |
| `KILN_BAMBU_TLS_FINGERPRINT` | no | no |  |
| `KILN_BAMBU_TLS_MODE` | no | no |  |
| `KILN_MCP_AUTH_TOKEN` | no | no |  |
| `KILN_OPENROUTER_KEY` | no | no |  |
| `KILN_PRINTER_API_KEY` | no | no |  |
| `KILN_PRINTER_HOST` | no | no |  |
| `KILN_PRINTER_HOST` | no | no | URL of your 3D printer (OctoPrint, Moonraker, Creality, or Prusa Link) |
| `KILN_PRINTER_TYPE` | no | no |  |
| `KILN_PRINTER_TYPE` | no | no | Printer type: octoprint, moonraker, creality, bambu, prusalink, elegoo, or serial |

## Tools (28)

- `design_session`
- `compile_scad`
- `generate_model`
- `search_all_models`
- `import_step_file`
- `analyze_printability`
- `auto_orient_model`
- `repair_mesh`
- `split_mesh_to_fit`
- `recommend_material`
- `decorate_surface`
- `slice_model`
- `show_on_stage`
- `estimate_print_cost_from_mesh`
- `preflight_check`
- `start_print`
- `monitor_print`
- `emergency_stop`
- `purge_filament`
- `wipe_nozzle`
- `home_axes`
- `park_head`
- `plate_status`
- `diagnose_print_failure_live`
- `retry_print_with_fix`
- `save_design_version`
- `export_step`
- `fulfillment_quote`

## FAQ

### Which 3D printers does Kiln support?

Kiln works with Bambu Lab, Creality, Prusa, Elegoo, Voron, Sovol, AnkerMake, Artillery, FlashForge, QIDI, RatRig and SparkX printers, and is compatible with OctoPrint, Moonraker/Klipper, PrusaLink and Direct USB.

### Does Kiln work with AI clients other than Claude?

Yes, it works with ChatGPT, Claude, Gemini, GitHub Copilot, Codex, Cursor, Grok and any MCP-capable agent.

### How do I install Kiln?

Install it with pip, then create an account and connect your AI with kiln signin and kiln install-mcp, or add the hosted endpoint inside the app.

### Does Kiln keep versions of my designs?

Yes, every version is kept Git-style, so you can branch, compare, merge and undo design revisions.

### Do I have to approve every print?

By default you approve every print, but you can let a chosen printer run on its own for as long as you choose.
