CutOptim Engine
Cutting optimization: 2D panels, 1D bars, timber and true-shape nesting via the CutOptim API.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
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.>'
{
"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.>"
}
}
}
}
@cutoptim/mcpclaude mcp add cutoptim-engine -e 'CUTOPTIM_API_KEY=<your cutoptim_api_key>' -- npx -y @cutoptim/mcp@0.1.0
{
"mcpServers": {
"cutoptim-engine": {
"command": "npx",
"args": [
"-y",
"@cutoptim/mcp@0.1.0"
],
"env": {
"CUTOPTIM_API_KEY": "<your cutoptim_api_key>"
}
}
}
}
Variables d'environnement
CUTOPTIM_API_KEYsecret Your CutOptim API key (co_live_…, co_test_…, or the public demo key). Not needed for validate_*.
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
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
| 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.
Questions fréquentes
Qu'est-ce que CutOptim Engine ?
Cutting optimization: 2D panels, 1D bars, timber and true-shape nesting via the CutOptim API.
Comment installer CutOptim Engine ?
Il fonctionne comme serveur distant. Dans 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.>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour CutOptim Engine ?
Oui. Il attend CUTOPTIM_API_KEY, Authorization, à renseigner dans sa configuration.
CutOptim Engine est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient CutOptim Engine ?
Il est publié par cutoptim. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.