mcp server

engine-mcp

Official MCP server package for the CutOptim Engine API — cutting optimization tools for Claude, Cursor and any MCP client. Hosted at api.cutoptim.com/mcp.

cutoptim/engine-mcpcommunitylistedunreviewed

Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

Node.js 20 or newer

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "cutoptim-engine-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@cutoptim/mcp"
      ]
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 28, 2026

Two ways to connect

Hosted (no install) — point your MCP client at https://api.cutoptim.com/mcp with the header Authorization: Bearer <your API key>. Configurations for Claude Code, Cursor, VS Code and Claude Desktop are in the MCP guide.

Local (this package, stdio) — runs on your machine and calls the same API with your key:

{
  "mcpServers": {
    "cutoptim": {
      "command": "npx",
      "args": ["-y", "@cutoptim/mcp"],
      "env": { "CUTOPTIM_API_KEY": "co_test_YOUR_KEY" }
    }
  }
}

Claude Code: claude mcp add cutoptim --env CUTOPTIM_API_KEY=co_test_YOUR_KEY -- npx -y @cutoptim/mcp

Variable	Meaning
`CUTOPTIM_API_KEY`	your key: `co_live_…`, `co_test_…` (never billed) or the public demo key. Without one, only the `validate_*` tools work.
`CUTOPTIM_BASE_URL`	default `https://api.cutoptim.com`

Node 18 or newer.

Tools

Tool	What it does	Cost
`optimize_2d`	rectangular parts from sheets: layout, cut plan, yield	one API call
`optimize_1d`	lengths from bars, tubes, profiles	one API call
`optimize_wood`	timber parts by cross-section	one API call
`optimize_nest`	free-form polygon parts on sheets	one API call
`validate_2d` · `validate_1d` · `validate_wood` · `validate_nest`	check a request without solving it	free
`get_job`	read an async `engine: "max"` job	free
`get_usage`	calls used and left this month	free

The arguments of each tool are exactly the request body of its endpoint — the schemas are generated from the OpenAPI document. Every result carries a short summary for the assistant and the API's JSON answer as structuredContent.

Quota and billing

One tool call is one Engine API call: the same key, quota, rate limits and billing as calling the REST API yourself. The client sends an Idempotency-Key with every optimize call, so its own retries are never charged twice.

License and support

MIT. This repository is published from the CutOptim monorepo; report a bug in Issues or write to support@cutoptim.com.