@cutoptim/mcp 0.1.0 → 0.1.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 CutOptim
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 CutOptim
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,73 +1,77 @@
-<p align="center">
-  <a href="https://cutoptim.com/engine"><img src="https://raw.githubusercontent.com/cutoptim/engine-mcp/main/.github/logo.png" width="88" height="88" alt="CutOptim"></a>
-</p>
-
-<h1 align="center">CutOptim MCP server</h1>
-
-<p align="center">
-  Cutting optimization as tools for AI assistants: <b>2D panels</b>, <b>1D bars</b>, <b>timber</b> and <b>true-shape nesting</b>,<br>
-  through the <a href="https://cutoptim.com/engine">CutOptim Engine API</a> and the Model Context Protocol.
-</p>
-
-<p align="center">
-  <a href="https://cutoptim.com/engine/reference/guides/mcp">MCP guide</a> ·
-  <a href="https://cutoptim.com/engine/reference">API reference</a> ·
-  <a href="https://cutoptim.com/dashboard?api=test#api-keys">Get a free test key</a>
-</p>
-
----
-
-## 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](https://cutoptim.com/engine/reference/guides/mcp).
-
-**Local (this package, stdio)** — runs on your machine and calls the same API with your key:
-
-```json
-{
-  "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](https://cutoptim.com/engine/openapi.json). 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](https://github.com/cutoptim/engine-mcp/issues) or write to support@cutoptim.com.
+<p align="center">
+  <a href="https://cutoptim.com/engine"><img src="https://raw.githubusercontent.com/cutoptim/engine-mcp/main/.github/logo.png" width="88" height="88" alt="CutOptim"></a>
+</p>
+
+<h1 align="center">CutOptim MCP server</h1>
+
+<p align="center">
+  Cutting optimization as tools for AI assistants: <b>2D panels</b>, <b>1D bars</b>, <b>timber</b> and <b>true-shape nesting</b>,<br>
+  through the <a href="https://cutoptim.com/engine">CutOptim Engine API</a> and the Model Context Protocol.
+</p>
+
+<p align="center">
+  <a href="https://cutoptim.com/engine/reference/guides/mcp">MCP guide</a> ·
+  <a href="https://cutoptim.com/engine/reference">API reference</a> ·
+  <a href="https://cutoptim.com/dashboard?api=test#api-keys">Get a free test key</a>
+</p>
+
+<p align="center">
+  <a href="https://mcprush.com/to/cutoptim-engine-mcp?ref=badge"><img src="https://mcprush.com/badge/cutoptim-engine-mcp/card.svg" alt="CutOptim Engine MCP server"></a>
+</p>
+
+---
+
+## 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](https://cutoptim.com/engine/reference/guides/mcp).
+
+**Local (this package, stdio)** — runs on your machine and calls the same API with your key:
+
+```json
+{
+  "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](https://cutoptim.com/engine/openapi.json). 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](https://github.com/cutoptim/engine-mcp/issues) or write to support@cutoptim.com.

package/dist/core.gen.d.ts

@@ -40,6 +40,13 @@ export interface ApiAnswer {
 export type ApiCall = (req: ApiRequest, signal?: AbortSignal) => Promise<ApiAnswer>;
 export declare const SERVER_NAME = "cutoptim";
 export declare const SERVER_INSTRUCTIONS: string;
+/** Shown by MCP clients and registries next to the server name; the same icons as sdks/mcp/server.json. */
+export declare const SERVER_WEBSITE = "https://cutoptim.com/engine/reference/guides/mcp";
+export declare const SERVER_ICONS: {
+    src: string;
+    mimeType: string;
+    sizes: string[];
+}[];
 export declare function createCutOptimMcpServer(opts: {
     tools: ToolDef[];
     call: ApiCall;

package/dist/core.gen.js

@@ -18,12 +18,18 @@ export const SERVER_INSTRUCTIONS = 'CutOptim cutting optimization: 2D panels (op
     'All sizes are unit-agnostic numbers: keep one unit (e.g. mm) across parts, stock and kerf. ' +
     'engine "max" runs asynchronously: the answer is a jobId, poll it with get_job. ' +
     'get_usage shows the calls left this month. Reference: https://cutoptim.com/engine/reference';
+/** Shown by MCP clients and registries next to the server name; the same icons as sdks/mcp/server.json. */
+export const SERVER_WEBSITE = 'https://cutoptim.com/engine/reference/guides/mcp';
+export const SERVER_ICONS = [
+    { src: 'https://cutoptim.com/logo-square.png', mimeType: 'image/png', sizes: ['512x512'] },
+    { src: 'https://cutoptim.com/logo-square.svg', mimeType: 'image/svg+xml', sizes: ['any'] },
+];
 /** Export strings that are elided from the JSON text block (they stay in structuredContent). */
 const EXPORT_FIELDS = ['svg', 'dxf', 'csv', 'pdf', 'labelsPdf'];
 const MAX_TABLE_ROWS = 25;
 export function createCutOptimMcpServer(opts) {
     const byName = new Map(opts.tools.map((t) => [t.name, t]));
-    const server = new Server({ name: SERVER_NAME, title: 'CutOptim Engine', version: opts.version }, { capabilities: { tools: {} }, instructions: SERVER_INSTRUCTIONS });
+    const server = new Server({ name: SERVER_NAME, title: 'CutOptim Engine', version: opts.version, websiteUrl: SERVER_WEBSITE, icons: SERVER_ICONS }, { capabilities: { tools: {} }, instructions: SERVER_INSTRUCTIONS });
     server.setRequestHandler(ListToolsRequestSchema, async () => ({
         tools: opts.tools.map((t) => ({
             name: t.name, title: t.title, description: t.description,