Skip to main content
Glama
CutOptim MCP server

CutOptim MCP server

Official
by cutoptim

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.

Related MCP server: SmartCut

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to plan container and truck loads from plain-English shipment descriptions, returning fitted containers, utilization, non-fitting items, and interactive 3D load plans.
      1
      114 npm
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      SmartCut is a hosted cutting-optimisation API. It turns a list of parts and available stock into machine-ready cutting patterns for sheet materials (plywood, MDF, glass, plastic, sheet metal), linear stock (timber, bar, pipe, extrusion) and roll goods. Guillotine and true-shape nesting modes, with grain direction, per-part orientation locks, edge banding, blade kerf and stock trim.
      3
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI assistants to turn a furniture description into a parametric design, cut list, plywood sheet nesting, lumber cutting plan and dimensioned builder drawings, with no CAD required. When CadQuery or a licensed Autodesk Fusion is available, it also builds exact STEP/STL models and verifies them against the kernel.
      10
      2
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables an agent to turn furniture measurements into parametric module parts, optimize panel cutting layouts, and export cut lists, labels, PDF/SVG, CSV, or DXF.
      1
      MIT