English Français العربية

io.github.artur0x0/surfcad

Official registry AI and agents

MCP server for SurfCAD: Fully featured script CAD built on Manifold, with helpers for AI agents

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package surfcad-mcp
Claude Code 
claude mcp add surfcad -- npx -y surfcad-mcp@0.0.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "surfcad": {
            "command": "npx",
            "args": [
                "-y",
                "surfcad-mcp@0.0.1"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. surfcad-agent
  2. Layout
  3. Helper library
  4. Install the skill

surfcad-agent

Bring-your-own-agent SurfCAD skill and helper library. SurfCAD is a web CAD app on a custom Manifold kernel. Agents bring their own model. This repo has no API keys and does not call a hosted model.

Pre-release. Version 0.1.0 is the tree layout, the vendored helper runtime, and the skill. The MCP server in packages/mcp-server is a placeholder (the stdio process is a later revision). server.json and the registry publish flow are not in this revision. Nothing here is published to npm from this tree.

npm surfcad and npm surfcad-mcp already exist as 0.0.1 placeholders ("coming soon"). This repo's packages are 0.1.0 and are not published yet. The plugin .mcp.json points at surfcad-mcp@0.1.0, which will not resolve from the registry until that version is published.

License: Apache-2.0.

Layout

.claude-plugin/marketplace.json     marketplace name: surfcad-agent
plugins/surfcad/                    plugin name: surfcad (no bin/)
  .claude-plugin/plugin.json
  .mcp.json                         npx -y surfcad-mcp@0.1.0
  skills/surfcad/SKILL.md           skill name: surfcad
  skills/surfcad/references/
packages/surfcad/                   npm surfcad, the helper library
  UPSTREAM                          pinned 3dculos SHA
  vendor/                           copy of that commit's sync-files.json list
packages/mcp-server/                npm surfcad-mcp, placeholder
scripts/sync-3dculos.mjs            re-vendor the pin
scripts/gen-references.mjs          regenerate four skill references

There is one skill folder. There is no .claude/skills or .agents/skills copy.

Helper library

packages/surfcad re-exports loadManifold, runScript, helperScope, and the STL / 3MF / STEP exporters. The wasm is vendor/built/manifold.wasm, resolved from the package directory, so it works from node_modules/surfcad without depending on the process working directory. It is the custom kernel shipped with 3dculos, not npm manifold-3d.

The pin is the full SHA in packages/surfcad/UPSTREAM. npm run sync downloads that commit from GitHub, copies every runtimeFiles and catalogFiles path from sync-files.json into vendor/ (paths kept), and writes vendor/MANIFEST.json. CI runs the sync again and fails if the tree differs.

npm test

Run that from this directory. The headless test builds a filleted box, a two-body assembly, and a bent sheet, and checks status, bounding box, volume, body count, and non-empty STL, 3MF, and STEP.

Install the skill

AgentSkillMCP
Claude Code/plugin marketplace add artur0x0/surfcad-agent then /plugin install surfcad@surfcad-agentThe plugin .mcp.json starts npx -y surfcad-mcp@0.1.0 once that version is published. Standalone: claude mcp add --transport stdio surfcad -- npx -y surfcad-mcp@0.1.0
claude.ai / CoworkCustomize, Plugins, Add marketplace artur0x0/surfcad-agent, or upload the plugins/surfcad folderChat needs a remote HTTP server. This revision ships stdio config only, so Chat gets the skill without tools
Claude APIUpload plugins/surfcad/skills/surfcad (name matches the folder)—
Grok BuildReads this Claude marketplace, or npx skills add artur0x0/surfcad-agent -a grokgrok mcp add surfcad -- npx -y surfcad-mcp@0.1.0
Hermeshermes skills install artur0x0/surfcad-agent/plugins/surfcad/skills/surfcadhermes mcp add surfcad --command npx --args -y surfcad-mcp@0.1.0
Other agentsnpx skills add artur0x0/surfcad-agentRegistry name, when published: io.github.artur0x0/surfcad

The skill's frontmatter is only name, description, license, compatibility, metadata, and allowed-tools. metadata.version is the string "0.1.0".

Frequently asked questions

What is io.github.artur0x0/surfcad?

MCP server for SurfCAD: Fully featured script CAD built on Manifold, with helpers for AI agents

How do I install io.github.artur0x0/surfcad?

It runs on your machine. In Claude Code: claude mcp add surfcad -- npx -y surfcad-mcp@0.0.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.artur0x0/surfcad need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.artur0x0/surfcad open source?

Yes. Its code is on GitHub under the Apache-2.0 license.

Who maintains io.github.artur0x0/surfcad?

It is published by artur0x0. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.