English Français العربية

CutOptim Engine

Official registry Other

Cutting optimization: 2D panels, 1D bars, timber and true-shape nesting via the CutOptim API.

Source code Website 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).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http cutoptim-engine 'https://api.cutoptim.com/mcp' --header 'Authorization: <Bearer followed by your CutOptim API key (co_live_…, co_test_…, or the public demo key). Not needed for validate_* and tools/list.>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "cutoptim-engine": {
            "type": "http",
            "url": "https://api.cutoptim.com/mcp",
            "headers": {
                "Authorization": "<Bearer followed by your CutOptim API key (co_live_…, co_test_…, or the public demo key). Not needed for validate_* and tools/list.>"
            }
        }
    }
}
NPM package @cutoptim/mcp
Claude Code 
claude mcp add cutoptim-engine -e 'CUTOPTIM_API_KEY=<your cutoptim_api_key>' -- npx -y @cutoptim/mcp@0.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "cutoptim-engine": {
            "command": "npx",
            "args": [
                "-y",
                "@cutoptim/mcp@0.1.0"
            ],
            "env": {
                "CUTOPTIM_API_KEY": "<your cutoptim_api_key>"
            }
        }
    }
}

Environment variables

  • CUTOPTIM_API_KEY secret Your CutOptim API key (co_live_…, co_test_…, or the public demo key). Not needed for validate_*.

Documentation

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

Contents
  1. CutOptim MCP server
  2. Two ways to connect
  3. Tools
  4. Quota and billing
  5. License and support

CutOptim MCP server

Cutting optimization as tools for AI assistants: 2D panels, 1D bars, timber and true-shape nesting,

through the CutOptim Engine API and the Model Context Protocol.

MCP guide · API reference · Get a free test key

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

VariableMeaning
CUTOPTIM_API_KEYyour key: co_live_…, co_test_… (never billed) or the public demo key. Without one, only the validate_* tools work.
CUTOPTIM_BASE_URLdefault https://api.cutoptim.com

Node 18 or newer.

Tools

ToolWhat it doesCost
optimize_2drectangular parts from sheets: layout, cut plan, yieldone API call
optimize_1dlengths from bars, tubes, profilesone API call
optimize_woodtimber parts by cross-sectionone API call
optimize_nestfree-form polygon parts on sheetsone API call
validate_2d · validate_1d · validate_wood · validate_nestcheck a request without solving itfree
get_jobread an async engine: "max" jobfree
get_usagecalls used and left this monthfree

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.

Frequently asked questions

What is CutOptim Engine?

Cutting optimization: 2D panels, 1D bars, timber and true-shape nesting via the CutOptim API.

How do I install CutOptim Engine?

It runs as a remote server. In Claude Code: claude mcp add --transport http cutoptim-engine 'https://api.cutoptim.com/mcp' --header 'Authorization: <Bearer followed by your CutOptim API key (co_live_…, co_test_…, or the public demo key). Not needed for validate_* and tools/list.>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does CutOptim Engine need an API key?

Yes. It expects CUTOPTIM_API_KEY, Authorization, which you set in its configuration.

Is CutOptim Engine open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains CutOptim Engine?

It is published by cutoptim. 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.