# KerfScript

> KerfScript is an open-source MCP server for design and media. Write, check and render parametric laser-cutting designs to SVG or DXF. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI, self-hosted
- **Website:** https://kerfscript.mylasertools.com/docs/mcp/
- **Repository:** https://github.com/mylasertools/kerfscript/tree/HEAD/mcp
- **MCP Registry name:** com.mylasertools/kerfscript
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-14

## About

KerfScript is a language for parametric laser-cutting designs, and this server gives an assistant what it needs to write them without guessing. It can read the guides and language reference, search worked examples by title or tag, list a design's adjustable settings with their ranges, and render the result so the assistant tests its code before handing it over.

Renders return SVG or DXF along with parts, sizes in millimetres, layers and any warnings. Limits are stated plainly: a design may be up to 64,000 characters with up to 20 of its own libraries, cannot read files or use the network, and each render stops at 100,000 steps, 100 parts or 10 sheets. Text uses the bundled Atkinson Hyperlegible font.

The hosted server needs no account and allows about 60 requests a minute and 1,000 a day per client, and does not store or log designs. The same server runs locally with Node.js 20 or newer so designs never leave your machine. A successful render does not mean parts fit; cut a test piece first.

## Features

- **Docs and reference:** kerfscript_docs reads the guides and language reference.
- **Example search:** Finds examples by title or tag and returns their source.
- **Settings listing:** Shows a design's parameters with ranges and choices.
- **SVG and DXF render:** Outputs parts, sizes, layers and warnings.
- **Hosted or local:** Use the public endpoint or run via npx on your computer.
- **Documented limits:** Size, step, part and sheet caps are published.

## Good for

- Have an assistant draft a box or bracket design and test-render it
- Find an example close to a project and adapt it
- Expose a design's settings so they can be tuned
- Export DXF for a laser cutter

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `kerfscript_docs`: Reads the guides and the language reference.
- `kerfscript_examples`: Finds examples by title or tag and returns their source.
- `kerfscript_parameters`: Lists a design's settings with their ranges and choices.
- `kerfscript_render`: Renders a design to SVG or DXF, with its parts, sizes, layers and any warnings.

## FAQ

### Is an account required?

No. The hosted server needs no account or key.

### Are my designs stored?

The README says the hosted server does not store or log them.

### What is the licence?

GNU AGPL 3.0, with a free commercial licence for closed-source use.

### Does a successful render guarantee a fit?

No. Cut a test piece in your material first.

### Is KerfScript free?

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

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

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

### What are the best alternatives to KerfScript?

The closest alternatives to KerfScript 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/kerfscript
