Enables AI assistants to write, validate, and render parametric laser-cutting designs into SVG or DXF formats.
Also known as mylasertools/kerfscript, @mylasertools/kerfscript-mcp
- Stars
- 11
- Tools
- 4
- Downloads, 30 days
- —
- Latest version
- 0.1.1
- Last commit
- Nov 10, 2026
- License
- AGPL-3.0
What is KerfScript MCP?
KerfScript enables AI assistants to write, validate, and render parametric laser-cutting designs into SVG or DXF formats. It exposes 4 tools, such as kerfscript_docs, kerfscript_examples, kerfscript_parameters.
Summary generated from the project's README
About KerfScript MCP server
KerfScript allows AI assistants to create and verify parametric laser-cutting designs. Developers can use this server to let an AI write code, consult documentation, and render files into SVG or DXF formats. This process enables the assistant to test its own code before presenting a final design to the user. The server supports millimetre measurements and uses the Atkinson Hyperlegible font for text elements.
You can connect to the hosted version via HTTP using Claude Code, Claude desktop, Cursor, or VS Code without needing an account or API key. For privacy, you can run the server locally using Node.js 20 or newer so that designs never leave your machine. The hosted service has a limit of 60 requests per minute and 1,000 requests per day.
Specific tools include kerfscript_docs for reading language references, kerfscript_examples for finding source code, kerfscript_parameters for checking design settings, and kerfscript_render for generating files. Rendering is limited to 100,000 steps, 100 parts, and 10 sheets per design.
What you can do with it
- 1Verify design parametersAsk the AI to find the valid ranges and choices for a specific design's settings.
- 2Generate laser-cutting filesRequest the assistant to turn a KerfScript design into an SVG or DXF file.
- 3Learn the language syntaxHave the AI assistant read the official guides and language reference to write better code.
- 4Find code templatesInstruct the AI to locate existing design examples by their title or tag.
Written from the project's README. Every use case is checked against a quote from it.
How to install KerfScript MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall KerfScript MCP in Claude Code
$ claude mcp add kerfscript -- npx -y @mylasertools/kerfscript-mcpInstall KerfScript MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"kerfscript": {
"command": "npx",
"args": [
"-y",
"@mylasertools/kerfscript-mcp"
]
}
}
}Install KerfScript MCP in VS Code
.vscode/mcp.json
{
"servers": {
"kerfscript": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mylasertools/kerfscript-mcp"
]
}
}
}Install KerfScript MCP in VS Code CLI
$ code --add-mcp '{"name":"kerfscript","type":"stdio","command":"npx","args":["-y","@mylasertools/kerfscript-mcp"]}'Install KerfScript MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"kerfscript": {
"command": "npx",
"args": [
"-y",
"@mylasertools/kerfscript-mcp"
]
}
}
}Install KerfScript MCP in Codex
$ codex mcp add kerfscript -- npx -y @mylasertools/kerfscript-mcpInstall KerfScript MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.kerfscript] command = "npx" args = ["-y", "@mylasertools/kerfscript-mcp"]
Install KerfScript MCP in Gemini CLI
$ gemini mcp add -s user kerfscript npx -- -y @mylasertools/kerfscript-mcpInstall KerfScript MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"kerfscript": {
"command": "npx",
"args": [
"-y",
"@mylasertools/kerfscript-mcp"
]
}
}
}KerfScript MCP tools 4
Detected from the READMEkerfscript_docskerfscript_exampleskerfscript_parameterskerfscript_render
| kerfscript_docs | — | |
| kerfscript_examples | — | |
| kerfscript_parameters | — | |
| kerfscript_render | — |
Automated checks
Ran Nov 12, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSPass
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHubKerfScript MCP
An MCP server that lets AI assistants write and check KerfScript laser-cutting designs. The assistant can read the KerfScript docs and examples, find a design's settings and render it to SVG or DXF, so it can test its code before giving it to you.
Connect
The hosted server needs no account or key:
https://mcp.mylasertools.com/mcp
Claude Code
claude mcp add --transport http kerfscript https://mcp.mylasertools.com/mcp
Claude (desktop and web): Settings → Connectors → Add custom connector, and enter the address above.
Cursor: add it to .cursor/mcp.json:
{
"mcpServers": {
"kerfscript": { "url": "https://mcp.mylasertools.com/mcp" }
}
}
VS Code: add it to .vscode/mcp.json:
{
"servers": {
"kerfscript": { "type": "http", "url": "https://mcp.mylasertools.com/mcp" }
}
}
Run it locally
With Node.js 20 or newer, the same server runs on your computer and designs never leave it:
{
"mcpServers": {
"kerfscript": { "command": "npx", "args": ["-y", "@mylasertools/kerfscript-mcp"] }
}
}
In Claude Code:
claude mcp add kerfscript -- npx -y @mylasertools/kerfscript-mcp
Tools
| Tool | What it does |
|---|---|
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 |
Sizes are in millimetres. Text uses the bundled Atkinson Hyperlegible font.
Limits
A design may be up to 64,000 characters, with up to 20 libraries of its own passed alongside it. It cannot read files or fetch anything from the network. Each render stops at 100,000 steps, 100 parts and 10 sheets. For bigger designs or other fonts, use the KerfScript package or its command line.
The hosted server allows each client about 60 requests a minute and 1,000 a day. It does not store or log the designs you send.
A render that succeeds does not mean the parts fit. Cut a test piece in your material before cutting a new design.
More
Licensed under the GNU AGPL 3.0, or the free commercial licence for closed-source use.
KerfScript MCP questions
How do I add KerfScript MCP to Claude Code?
Run claude mcp add kerfscript -- npx -y @mylasertools/kerfscript-mcp in your terminal. Add --scope user to make it available in every project.
How do I add KerfScript MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does KerfScript MCP provide?
It exposes 4 tools, including kerfscript_docs, kerfscript_examples, kerfscript_parameters, kerfscript_render.
How can I use the server without an account?
The hosted server requires no account or API key to connect.
What are the rendering limits for a design?
Each render is limited to 100,000 steps, 100 parts, and 10 sheets.
Does a successful render guarantee the parts will fit?
No, a successful render does not guarantee part fitment; you should cut a test piece in your material first.
Can I run the server locally to keep my designs private?
Yes, you can run the server locally using Node.js 20 or newer so that designs never leave your computer.