SmartCut API
SmartCut is a hosted cutting-optimisation (cutlist / nesting) API for sheet, linear and roll stock. This repository holds the OpenAPI specification, runnable examples and MCP configuration for integrating it into your own software.
Power your agent
URL ของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
https://api.smartcut.dev/mcpปุ่ม Claude ด้านบนจะเปิด Claude พร้อมกรอกชื่อและ URL ให้แล้ว คุณยังต้องยืนยันที่นั่นเอง
claude mcp add --transport http dev.smartcut-cutlist-optimizer https://api.smartcut.dev/mcpRun in a terminal.
{ "mcpServers": { "dev.smartcut-cutlist-optimizer": { "command": "npx", "args": [ "-y", "mcp-remote", "https://api.smartcut.dev/mcp" ] } }}claude_desktop_config.json
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดจากผู้เผยแพร่
SmartCut is a hosted cutting-optimisation (cutlist / nesting) API for sheet, linear and roll stock. This repository holds the OpenAPI specification, runnable examples and MCP configuration for integrating it into your own software.
Cutlist optimization for sheet, linear and roll stock, with grain, kerf, nesting and saw exports.
.may.Get a key at https://smartcut.dev/account, then:
curl -X POST https://api.smartcut.dev/v3/calculate \
-H "Authorization: $SMARTCUT_API_KEY" \
-H "Content-Type: application/json" \
-d @examples/requests/guillotine.json
That returns a job id. Poll until it is ready, then fetch the result:
curl "https://api.smartcut.dev/v3/result/ready?id=$JOB_ID" -H "Authorization: $SMARTCUT_API_KEY"
curl "https://api.smartcut.dev/v3/result?id=$JOB_ID" -H "Authorization: $SMARTCUT_API_KEY"
The result carries one entry per stock piece, each listing the parts placed on
it with their positions, the cuts needed to produce them, and the offcut left
over. Complete runnable versions in four languages are in
examples/.
Pass the raw API key in the Authorization header:
Authorization: YOUR_API_KEY
There is no Bearer prefix. This is the single most common integration
mistake — a Bearer prefix returns 401.
Full reference: https://smartcut.dev/api-docs/v3
Optimisation takes longer than a request should block for, so /v3/calculate
returns a job id immediately. You then either poll /v3/result/ready until it
reports done, or register a webhook and let SmartCut POST to you when the result
is available. Either way you fetch the payload from /v3/result.
Webhook registration, signature verification and retry behaviour are documented at https://smartcut.dev/docs/webhooks.
SmartCut runs a hosted Model Context Protocol server, so an agent can run optimisations directly with your existing API key.
POST https://api.smartcut.dev/mcp
Streamable HTTP transport. Authentication is the same raw key in the
Authorization header, without a Bearer prefix. Configuration for Claude
Desktop and other clients is in mcp/.
Tools: calculate, validate, status, result, cancel, usage, export,
labels, list_cut_types — plus import_parts, which is different from the
rest: it pushes parts an agent has extracted (from a PDF or a photo of a cutting
plan) into an open Cutlist Evolution editor for the
user to confirm, rather than calling the optimisation API.
The calculate tool waits for the result in-call (about 25 seconds by default,
overridable with waitMs) and falls back to returning a job id if the
optimisation is still running, so an agent usually gets a layout in one call.
There is no official SDK, and that is deliberate. The API is a JSON body and
one header, so fetch is already the client — and a generated client in your own
idiom will fit your codebase better than a hand-written one would. Point any
generator at the spec:
npx openapi-typescript openapi/v3.json -o smartcut.d.ts
npx @hey-api/openapi-ts -i openapi/v3.json -o src/smartcut
openapi-generator-cli generate -i openapi/v3.json -g python -o ./smartcut-python
Each reads a payload from examples/requests/, which is
generated from the specification — so the examples cannot drift from the schema.
SmartCut is a hosted service with a subscription, not a self-hosted library. It suits quoting, order processing, e-commerce cut-to-size checkout and CAM hand-off, where you want optimisation quality and saw-format output without maintaining a geometry engine. If you want an in-process bin-packer with no network call and no account, this is the wrong tool and an open-source packing library is the right one.
Issues here are for the specification and the examples only. For API access,
billing, quota or integration support, use the contact form at
https://smartcut.dev/contact. Specification files are generated and cannot be
changed by pull request — see openapi/README.md.
Cutlist optimization for sheet, linear and roll stock, with grain, kerf, nesting and saw exports.
{ "mcpServers": { "dev.smartcut-cutlist-optimizer": { "url": "https://api.smartcut.dev/mcp", "headers": {} } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก http สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
SmartCut เข้าถึงได้ผ่าน HTTP
ตรวจสอบล่าสุดเมื่อ 2026-11-08 Cutlist optimization for sheet, linear and roll stock, with grain, kerf, nesting and saw exports.