AI Agents
LinkCAD 11.3 and later can be used by AI agents such as Claude Code, Claude Desktop, GitHub Copilot in VS Code and Cursor. The agent works with LinkCAD through linkcad-mcp, a server for the Model Context Protocol (MCP) that is installed with LinkCAD on Windows and Linux.
You describe the task in plain language, for example “convert every DXF file in this folder to GDSII on layers 1 to 10 and check that nothing was lost”, and the agent calls LinkCAD to do it. It sees the same import and export logs you would see, and it can look at a preview of the drawing to check its own work.
What an agent can do
| Task | How |
|---|---|
| Find out what a file contains | Units, bounds, layers, cells, hierarchy and shape counts per layer, or the shapes of one cell. |
| Convert between formats | Every format LinkCAD reads and writes and your license covers, with the same import and export options as the conversion wizard. |
| Change the geometry | The commands of the Tools menu, such as merge, offset, flatten, crop, explode and Boolean layer operations, in the form of the --apply-tool commands. |
| Select, rename, recolor or delete layers | Before export, as on the Layers page of the wizard. |
| Run Python tool plugins | Layer Statistics, Panel Assembly, Remove Tiny Features and your own tool plugins. |
| Look at the result | A PNG preview drawn the way the LinkCAD viewer draws it. |
| Verify a conversion | Reopen the output and compare bounds, layers, cells and shape counts with the source. |
The agent receives a guide with the server, so it knows the workflow, the units, the option names and what each error means without you explaining them.
What it cannot do
The server limits what an agent can reach:
- Only the folders you name. You give the server one or more folders when you register it. The agent cannot read or write anywhere else, and it cannot add folders itself. A folder can be read-only.
- No overwriting by accident. An export never replaces the file the drawing was read from, and replaces any other existing file only when the agent asks for it explicitly. Multi-file outputs, such as one Gerber file per layer, are written to a hidden folder first and moved into place together only when the export succeeded.
- No change to your settings. Every call starts from LinkCAD’s default options. Options the agent sets apply to that call only and are not saved, so the desktop application is unaffected.
- No Python unless you allow it. Running arbitrary Python code is switched off by default, because Python is not limited to the folders. See
--allow-python.
Licensing
The AI agent interface is part of LinkCAD and needs no license of its own. It uses the license of the LinkCAD installation it belongs to, and the agent can do exactly what that license allows in the application:
| License | What the agent needs it for |
|---|---|
| Format licenses | Reading or writing that format. |
| Basic | Renaming layers, and the polyline repairs of the conversion wizard: join, close, add width to and erase zero-width polylines, and merge zero-width polylines. |
| Tools | Every other tool command: merge, offset, flatten, explode, crop, snap to grid, Boolean layer operations and the rest. |
| Edit | Deleting layers, and plugin tools or Python code that change a drawing. |
| View | Previews. |
Inspecting a drawing, selecting layers for export and changing their preview color need no license beyond the one that reads the file. When a license is missing, the agent receives an error that names it, before anything changes, and can tell you which license the task needs. When the license is read-only, files can be read and previewed but not changed or written.
Getting started
- Install LinkCAD 11.3 or later and register your license.
- Register
linkcad-mcpwith your agent, as Connecting an AI agent describes.linkcad-mcp --print-configprints the registration for you. - Ask the agent to inspect a file in one of the folders you named. A first request such as “Use LinkCAD to tell me what is in chip.gds” checks that everything is connected.
The tool reference lists every tool the server offers, with its arguments and errors.
Example requests
- “Open
panel.gbrand tell me which layers it has and how big the board is in millimeters.” - “Convert
layout.dxfto GDSII, map the DXF layers to GDSII layers 1 to 5 in the order they appear, and show me a preview of the result.” - “Merge the overlapping polygons on every layer of
mask.gds, grow layer METAL1 by 0.5 µm, and write the result tomask_out.gds.” - “Convert every
.dwgfile inincomingto DXF and list any warnings from the import logs.” - “Run Layer Statistics on
test.oasand give me the area per layer.”
Agents without MCP
An agent that can run commands can also call the command line directly. LinkCAD installs its agent guide as agents/linkcad/SKILL.md in the installation folder, in the skill format that Claude Code and GitHub Copilot read. Copy the linkcad folder to your agent’s skills folder (for Claude Code, ~/.claude/skills/) to give it the same guidance without the MCP server.