@polypad/mcp 0.1.1 → 0.1.6

package/README.md

@@ -6,15 +6,15 @@ The server runs on your own computer. Nothing is uploaded and there is no accoun
 
 ## Set up
 
-You need Node.js 22 or newer. Add the server to your AI client; `npx` downloads it on first use.
+**Claude Desktop, one click (no Node.js or terminal needed):** download [polypad.mcpb](https://polypad.ink/downloads/polypad.mcpb) (also behind **Connect AI** on polypad.ink) and open it; Claude Desktop shows an Install button. It runs this same server with Claude Desktop's built-in Node.
 
-**Claude Code**
+**Claude Code and Cursor:** you need Node.js 22 or newer. `npx` downloads the server on first use.
 
 ```sh
 claude mcp add polypad -- npx -y @polypad/mcp
 ```
 
-**Claude Desktop** (Settings, Developer, Edit Config, then restart)
+**Cursor** (`.cursor/mcp.json` in a project, or `~/.cursor/mcp.json` for all projects):
 
 ```json
 {
@@ -27,7 +27,7 @@ claude mcp add polypad -- npx -y @polypad/mcp
 }
 ```
 
-**Cursor** (`.cursor/mcp.json` in a project, or `~/.cursor/mcp.json` for all projects): the same `mcpServers` block as above.
+The same block works in Claude Desktop's `claude_desktop_config.json` (Settings, Developer, Edit Config, then restart) if you prefer it to the extension.
 
 ## Connect
 
@@ -44,7 +44,7 @@ You can add Polypad to Claude Code and Claude Desktop (or Cursor) and use them a
 
 ## Troubleshooting
 
-- **"Server not running"** in the dialog: your AI client has not started the server yet. Ask it something about Polypad, and check `npx -y @polypad/mcp --help` works (Node 22 or newer).
+- **"Server not running"** in the dialog: your AI client has not started the server yet. Ask it something about Polypad, and check `npx -y @polypad/mcp --help` works (Node 22 or newer; the Claude Desktop extension needs neither).
 - **"Wrong code"**: enter the code from the latest start. It changes whenever the connection's owner restarts.
 - **"Port 41720 is already in use"** (the tools say so): a program that is not a Polypad MCP server (or an old 0.1.0 one) holds the port. Close it, or use `--port 41721` here and in the dialog's Advanced section. The server checks again every 2 seconds.
 
@@ -72,4 +72,8 @@ Lengths are in mm and angles in degrees. Sizes can be numbers or formulas over y
 - The assistant sees and edits only the project you have open. Disconnect in the dialog cuts it off at any time.
 - Polypad sends nothing to a server. What leaves your machine is what your AI client sends to its model provider: your prompts and the tool results.
 
+## Licenses
+
+Polypad MCP is MIT licensed. `dist/index.js` bundles a few open-source packages (the MCP SDK, ws, zod and their dependencies); their names, versions and full license texts are in `THIRD_PARTY_NOTICES.txt`, shipped next to it in this package.
+
 More: [polypad.ink](https://polypad.ink). License: MIT.

package/dist/THIRD_PARTY_NOTICES.txt

@@ -0,0 +1,260 @@
+THIRD-PARTY NOTICES for @polypad/mcp
+
+dist/index.js bundles the open-source packages listed below. Each one is under its own license; the license
+texts are reproduced in full as the packages ship them.
+
+  @modelcontextprotocol/sdk@1.32.1 (MIT)
+  ajv@8.20.0 (MIT)
+  ajv-formats@3.0.1 (MIT)
+  fast-deep-equal@3.1.3 (MIT)
+  fast-uri@3.1.8 (BSD-3-Clause)
+  json-schema-traverse@1.0.0 (MIT)
+  ws@8.22.0 (MIT)
+  zod@4.6.5 (MIT)
+  zod-to-json-schema@3.25.2 (ISC)
+
+==============================================================================
+@modelcontextprotocol/sdk@1.32.1
+License: MIT
+Source: https://modelcontextprotocol.io
+
+MIT License
+
+Copyright (c) 2024 Anthropic, PBC
+
+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.
+
+==============================================================================
+ajv@8.20.0
+License: MIT
+Source: https://ajv.js.org
+
+The MIT License (MIT)
+
+Copyright (c) 2015-2021 Evgeny Poberezkin
+
+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.
+
+==============================================================================
+ajv-formats@3.0.1
+License: MIT
+Source: https://github.com/ajv-validator/ajv-formats#readme
+
+MIT License
+
+Copyright (c) 2020 Evgeny Poberezkin
+
+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.
+
+==============================================================================
+fast-deep-equal@3.1.3
+License: MIT
+Source: https://github.com/epoberezkin/fast-deep-equal#readme
+
+MIT License
+
+Copyright (c) 2017 Evgeny Poberezkin
+
+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.
+
+==============================================================================
+fast-uri@3.1.8
+License: BSD-3-Clause
+Source: https://github.com/fastify/fast-uri
+
+Copyright (c) 2011-2021, Gary Court until https://github.com/garycourt/uri-js/commit/a1acf730b4bba3f1097c9f52e7d9d3aba8cdcaae
+Copyright (c) 2021-present The Fastify team <https://github.com/fastify/fastify#team>
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in the
+      documentation and/or other materials provided with the distribution.
+    * The names of any contributors may not be used to endorse or promote
+      products derived from this software without specific prior written
+      permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS AND CONTRIBUTORS BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+                                  *   *   *
+
+The complete list of contributors can be found at:
+- https://github.com/garycourt/uri-js/graphs/contributors
+
+==============================================================================
+json-schema-traverse@1.0.0
+License: MIT
+Source: https://github.com/epoberezkin/json-schema-traverse#readme
+
+MIT License
+
+Copyright (c) 2017 Evgeny Poberezkin
+
+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.
+
+==============================================================================
+ws@8.22.0
+License: MIT
+Source: https://github.com/websockets/ws
+
+Copyright (c) 2011 Einar Otto Stangvik <einaros@gmail.com>
+Copyright (c) 2013 Arnout Kazemier and contributors
+Copyright (c) 2016 Luigi Pinca and contributors
+
+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.
+
+==============================================================================
+zod@4.6.5
+License: MIT
+Source: https://zod.dev
+
+MIT License
+
+Copyright (c) 2025 Colin McDonnell
+
+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.
+
+==============================================================================
+zod-to-json-schema@3.25.2
+License: ISC
+Source: https://github.com/StefanTerdell/zod-to-json-schema
+
+ISC License
+
+Copyright (c) 2020, Stefan Terdell
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+

package/dist/index.js

@@ -34241,7 +34241,7 @@ var rawSketchShape = { ...sketchShape, constraints: external_exports.array(RawSk
 var SketchSchema = external_exports.object(sketchShape).superRefine(validateSketch);
 
 // ../../packages/document/src/project.ts
-var SCHEMA_VERSION = 16;
+var SCHEMA_VERSION = 18;
 var MAX_SNAPSHOT_NAME = 80;
 var MAX_PATTERN_COUNT = 100;
 var MAX_PATTERN_COPIES = 400;
@@ -34269,7 +34269,10 @@ function makeSchemas(v, constraint) {
     external_exports.object({ kind: external_exports.literal("box"), width: pos, depth: pos, height: pos }),
     external_exports.object({ kind: external_exports.literal("cylinder"), radius: pos, height: pos }),
     external_exports.object({ kind: external_exports.literal("sphere"), radius: pos }),
-    external_exports.object({ kind: external_exports.literal("cone"), radius: pos, topRadius: nonneg, height: pos })
+    external_exports.object({ kind: external_exports.literal("cone"), radius: pos, topRadius: nonneg, height: pos }),
+    external_exports.object({ kind: external_exports.literal("torus"), radius: pos, tubeRadius: pos }),
+    external_exports.object({ kind: external_exports.literal("tube"), radius: pos, innerRadius: pos, height: pos }),
+    external_exports.object({ kind: external_exports.literal("wedge"), width: pos, depth: pos, height: pos, topWidth: nonneg })
   ]);
   const PrimitiveFeatureSchema = external_exports.object({
     ...featureBase,
@@ -34333,37 +34336,43 @@ function makeSchemas(v, constraint) {
   });
   const direction = external_exports.object({ axis: external_exports.enum(["x", "y", "z"]), flip: external_exports.boolean().default(false) });
   const count = v(external_exports.number().int().min(2).max(MAX_PATTERN_COUNT));
+  const LayoutSchema = external_exports.discriminatedUnion("kind", [
+    external_exports.object({
+      kind: external_exports.literal("linear"),
+      direction,
+      count,
+      spacing: pos,
+      second: external_exports.object({ direction, count, spacing: pos }).optional()
+    }),
+    external_exports.object({
+      kind: external_exports.literal("circular"),
+      axis: external_exports.enum(["x", "y", "z"]),
+      centre: vec32,
+      count,
+      // 360 spreads the copies evenly around; less puts the last copy at this angle.
+      angle: v(external_exports.number().gt(0).max(360)).default(360)
+    })
+  ]);
+  const gridWithinLimit = (f) => {
+    const layout = f.layout;
+    if (layout.kind !== "linear" || !layout.second) return true;
+    const [a, b] = [layout.count, layout.second.count];
+    return typeof a !== "number" || typeof b !== "number" || a * b <= MAX_PATTERN_COPIES;
+  };
+  const gridIssue = { path: ["layout", "second", "count"], message: `A grid can have at most ${MAX_PATTERN_COPIES} copies (count x second count)` };
   const PatternFeatureSchema = external_exports.object({
     ...featureBase,
     type: external_exports.literal("pattern"),
     body: external_exports.string(),
     result: external_exports.enum(["join", "separate"]).default("join"),
-    layout: external_exports.discriminatedUnion("kind", [
-      external_exports.object({
-        kind: external_exports.literal("linear"),
-        direction,
-        count,
-        spacing: pos,
-        second: external_exports.object({ direction, count, spacing: pos }).optional()
-      }),
-      external_exports.object({
-        kind: external_exports.literal("circular"),
-        axis: external_exports.enum(["x", "y", "z"]),
-        centre: vec32,
-        count,
-        // 360 spreads the copies evenly around; less puts the last copy at this angle.
-        angle: v(external_exports.number().gt(0).max(360)).default(360)
-      })
-    ])
-  }).refine(
-    (f) => {
-      const layout = f.layout;
-      if (layout.kind !== "linear" || !layout.second) return true;
-      const [a, b] = [layout.count, layout.second.count];
-      return typeof a !== "number" || typeof b !== "number" || a * b <= MAX_PATTERN_COPIES;
-    },
-    { path: ["layout", "second", "count"], message: `A grid can have at most ${MAX_PATTERN_COPIES} copies (count x second count)` }
-  );
+    layout: LayoutSchema
+  }).refine(gridWithinLimit, gridIssue);
+  const FeaturePatternSchema = external_exports.object({
+    ...featureBase,
+    type: external_exports.literal("featurePattern"),
+    feature: external_exports.string(),
+    layout: LayoutSchema
+  }).refine(gridWithinLimit, gridIssue);
   const MirrorFeatureSchema = external_exports.object({
     ...featureBase,
     type: external_exports.literal("mirror"),
@@ -34429,6 +34438,7 @@ function makeSchemas(v, constraint) {
     HoleFeatureSchema,
     TransformFeatureSchema,
     PatternFeatureSchema,
+    FeaturePatternSchema,
     MirrorFeatureSchema,
     CopyFeatureSchema,
     ImportFeatureSchema,
@@ -34449,6 +34459,15 @@ var modelShape = {
   features: external_exports.record(external_exports.string(), FeatureSchema),
   order: external_exports.array(external_exports.string())
 };
+function holePatternProblem(model, feature) {
+  const source = model.features[feature.feature];
+  if (!source) return "The hole this pattern repeats was deleted";
+  if (source.type !== "hole") return `${source.name} is not a hole; a hole pattern repeats a hole`;
+  const at = model.order.indexOf(feature.id);
+  const from = model.order.indexOf(source.id);
+  if (from < 0 || at >= 0 && from > at) return `${source.name} comes after this pattern; a hole pattern repeats an earlier hole`;
+  return null;
+}
 function checkModel(model, ctx) {
   const ids = Object.keys(model.features);
   if (new Set(model.order).size !== model.order.length) {
@@ -34461,6 +34480,11 @@ function checkModel(model, ctx) {
     if (model.features[id].id !== id) {
       ctx.addIssue({ code: "custom", path: ["features", id], message: "Feature id mismatch" });
     }
+    const feature = model.features[id];
+    if (feature.type === "featurePattern") {
+      const problem = holePatternProblem(model, feature);
+      if (problem) ctx.addIssue({ code: "custom", path: ["features", id, "feature"], message: problem });
+    }
   }
 }
 var SnapshotSchema = external_exports.object({
@@ -34654,6 +34678,26 @@ var patternDirection = external_exports.object({
   axis: external_exports.enum(["x", "y", "z"]).describe("World axis the copies step along"),
   flip: external_exports.boolean().default(false).describe("True steps along the negative axis")
 });
+var patternLayout = external_exports.discriminatedUnion("kind", [
+  external_exports.object({
+    kind: external_exports.literal("linear"),
+    direction: patternDirection,
+    count: external_exports.union([external_exports.number().int().min(2).max(100), external_exports.string().min(1)]).describe("Number of copies in a row, including the original (2 to 100)"),
+    spacing: size("Distance between copies"),
+    second: external_exports.object({
+      direction: patternDirection,
+      count: external_exports.union([external_exports.number().int().min(2).max(100), external_exports.string().min(1)]).describe("Rows in the second direction, including the original"),
+      spacing: size("Distance between rows")
+    }).optional().describe("A second direction makes a grid (at most 400 copies in all)")
+  }),
+  external_exports.object({
+    kind: external_exports.literal("circular"),
+    axis: external_exports.enum(["x", "y", "z"]).describe("World axis (through `centre`) the copies turn about"),
+    centre: vec3("A point on the axis"),
+    count: external_exports.union([external_exports.number().int().min(2).max(100), external_exports.string().min(1)]).describe("Number of copies including the original"),
+    angle: external_exports.union([external_exports.number().gt(0).max(360), external_exports.string().min(1)]).default(360).describe("360 spreads the copies evenly around the full circle; less puts the last copy at this angle (degrees)")
+  })
+]).describe("How the copies are laid out. Counts include the original");
 var inputs = {
   new_project: external_exports.object({
     name: external_exports.string().trim().min(1).max(120).default("Untitled").describe("Name of the new project"),
@@ -34673,8 +34717,28 @@ var inputs = {
         radius: size("Radius of the base"),
         topRadius: external_exports.union([external_exports.number().nonnegative(), external_exports.string().min(1)]).describe(`Radius of the top in mm, 0 for a point${EXPR}`),
         height: size("Height along Z")
+      }),
+      external_exports.object({
+        kind: external_exports.literal("tube"),
+        radius: size("Outer radius"),
+        innerRadius: size("Inner radius, smaller than the outer radius"),
+        height: size("Height along Z")
+      }),
+      external_exports.object({
+        kind: external_exports.literal("torus"),
+        radius: size("Distance from the centre to the middle of the ring's tube"),
+        tubeRadius: size("Radius of the tube, smaller than the ring radius")
+      }),
+      external_exports.object({
+        kind: external_exports.literal("wedge"),
+        width: size("Size of the base along X"),
+        depth: size("Size along Y"),
+        height: size("Height along Z, at the tall side"),
+        topWidth: external_exports.union([external_exports.number().nonnegative(), external_exports.string().min(1)]).describe(`Width of the flat top in mm, 0 for a sharp ramp edge, the width for a box${EXPR}`)
       })
-    ]).describe("The solid to add. A primitive stands on the XY plane: its base is centred on `position` and it grows upwards along Z."),
+    ]).describe(
+      "The solid to add. A primitive stands on the XY plane: its base is centred on `position` and it grows upwards along Z. A torus stands on the XY plane too (it spans z 0 to twice its tube radius). A wedge is tallest at its -X side and slopes down to +X; its top is `topWidth` wide."
+    ),
     position: vec3("Where the centre of the base goes").default([0, 0, 0]),
     rotation: vec3("Rotation about X, then Y, then Z, around the base centre", "degrees").default([0, 0, 0])
   }),
@@ -34739,26 +34803,11 @@ var inputs = {
   pattern: external_exports.object({
     body: bodyId,
     result: external_exports.enum(["join", "separate"]).default("join").describe("join fuses the copies into the body; separate makes each copy its own body"),
-    layout: external_exports.discriminatedUnion("kind", [
-      external_exports.object({
-        kind: external_exports.literal("linear"),
-        direction: patternDirection,
-        count: external_exports.union([external_exports.number().int().min(2).max(100), external_exports.string().min(1)]).describe("Number of copies in a row, including the original (2 to 100)"),
-        spacing: size("Distance between copies"),
-        second: external_exports.object({
-          direction: patternDirection,
-          count: external_exports.union([external_exports.number().int().min(2).max(100), external_exports.string().min(1)]).describe("Rows in the second direction, including the original"),
-          spacing: size("Distance between rows")
-        }).optional().describe("A second direction makes a grid (at most 400 copies in all)")
-      }),
-      external_exports.object({
-        kind: external_exports.literal("circular"),
-        axis: external_exports.enum(["x", "y", "z"]).describe("World axis (through `centre`) the copies turn about"),
-        centre: vec3("A point on the axis"),
-        count: external_exports.union([external_exports.number().int().min(2).max(100), external_exports.string().min(1)]).describe("Number of copies including the original"),
-        angle: external_exports.union([external_exports.number().gt(0).max(360), external_exports.string().min(1)]).default(360).describe("360 spreads the copies evenly around the full circle; less puts the last copy at this angle (degrees)")
-      })
-    ]).describe("How the copies are laid out")
+    layout: patternLayout
+  }),
+  pattern_hole: external_exports.object({
+    hole: featureId.describe("Id of the hole to repeat (returned by hole, or listed by get_project). Its copies are cut into the same body"),
+    layout: patternLayout
   }),
   mirror: external_exports.object({
     body: bodyId,
@@ -34809,25 +34858,26 @@ var inputs = {
 };
 var descriptions = {
   new_project: "Start a new, empty Polypad project (optionally from a template), replacing the open one. All lengths in Polypad are millimetres and angles are degrees; Z is up.",
-  set_parameter: "Create or change a named parameter (a number or an expression). Any length field of any feature can use the name, so one change resizes everything bound to it. Reports features that no longer build.",
-  add_primitive: "Add a solid box, cylinder, sphere or cone as a new body. Returns the new feature's id, which is also the body id for later commands. Sizes in mm.",
+  set_parameter: "Create or change a named parameter (a number or an expression). Any length field of any feature can use the name, so one change resizes everything bound to it. Reports features that no longer build. Set the sizes up front, then use the names in fields.",
+  add_primitive: "Add a solid box, cylinder, tube, sphere, cone, torus or wedge as a new body. Returns the new feature's id, which is also the body id for later commands. Sizes in mm.",
   add_sketch: "Add a 2D sketch on a base plane or on a flat face and draw shapes in it (rectangle, circle, line, polyline, arc, slot, polygon). The sketch is solved and its remaining degrees of freedom reported. Use extrude or revolve to turn closed shapes into a solid.",
   extrude: "Extrude the closed shapes of a sketch into a solid: as a new body, or cut from / joined to an existing body. Returns the feature id (the new body's id when mode is new).",
-  revolve: "Revolve the closed shapes of a sketch about an axis in the sketch plane to make a solid of revolution: new body, or cut / join with an existing body.",
-  combine: "Boolean-combine bodies: union, subtract (remove the tools from the target) or intersect. The target keeps its id; the tools are consumed.",
-  hole: "Drill a screw hole (M2 to M10, with clearance, tap or heat-set insert fit and optional counterbore / countersink) into a flat face. Call list_faces first and pass the face index and its rebuildId.",
-  fillet: "Round the given edges of a body with a radius. Call list_edges first and pass the edge indices and their rebuildId.",
-  chamfer: "Bevel the given edges of a body. Call list_edges first and pass the edge indices and their rebuildId.",
-  shell: "Hollow out a body, leaving the given faces open, with walls of a given thickness. Call list_faces first and pass the face indices and their rebuildId.",
-  pattern: "Repeat a body in a row or grid, or around an axis, either fusing the copies into the body or making each copy a body of its own.",
-  mirror: "Mirror a whole body across a plane (yz, xz or xy, optionally moved along its normal), joining the copy into the body or making it a separate body.",
+  revolve: "Revolve the closed shapes of a sketch about an axis in the sketch plane to make a solid of revolution: new body, or cut / join with an existing body. Use it for round parts: draw half the outline beside the axis.",
+  combine: "Boolean-combine bodies: union, subtract (remove the tools from the target) or intersect. The target keeps its id; the tools are consumed. To hollow a body use shell, not a subtracted box; to check a collision, intersect two bodies, measure the result, then undo.",
+  hole: "Drill a screw hole (M2 to M10, with clearance, tap or heat-set insert fit and optional counterbore / countersink) into a flat face. Call list_faces first and pass the face index and its rebuildId. Use this for every screw, standoff or insert hole instead of cutting circles.",
+  fillet: "Round the given edges of a body with a radius. Call list_edges first (narrow it with its filter) and pass the edge indices and their rebuildId. If it fails, try a smaller radius or fewer edges.",
+  chamfer: "Bevel the given edges of a body. Call list_edges first (narrow it with its filter) and pass the edge indices and their rebuildId. If it fails, try a smaller distance or fewer edges.",
+  shell: "Hollow out a body, leaving the given faces open, with walls of a given thickness. Call list_faces first and pass the face indices and their rebuildId. Use this for enclosures and cups instead of subtracting a smaller box; list_faces with filter normal finds the face to open.",
+  pattern: "Repeat a body in a row or grid, or around an axis, either fusing the copies into the body or making each copy a body of its own. Model one copy (or one cutter) and pattern it instead of adding copies by hand. To repeat a screw hole use pattern_hole instead.",
+  pattern_hole: "Repeat a hole you already made: in a row or grid, or around an axis (a bolt circle, for example 6 holes around a flange). The copies are cut into the hole's body in one go with the hole's size, fit, head and depth, and follow later edits to the hole. The layout works in world axes: for a bolt circle on a top face use kind circular, axis z, centre a point on the axis (the middle of the circle) and the count; the hole itself is one of the copies, so place it on the bolt circle. A copy that lands off the face is skipped and reported.",
+  mirror: "Mirror a whole body across a plane (yz, xz or xy, optionally moved along its normal), joining the copy into the body or making it a separate body. Model one side of a symmetric part, then mirror it.",
   move: "Move, rotate and/or scale a whole body (translate in mm, rotate in degrees about X, Y, Z around a pivot).",
-  update_feature: "Change fields of an existing feature (for example an extrude's distance or a box's width); everything after it rebuilds. The change is refused, and the project left as it was, if the result is not a valid model.",
+  update_feature: "Change fields of an existing feature (for example an extrude's distance or a box's width); everything after it rebuilds. The change is refused, and the project left as it was, if the result is not a valid model. Prefer this over deleting and rebuilding a feature.",
   delete_feature: "Delete a feature. Refused while other features still use it; delete those first.",
   undo: "Undo the last change made to the project. Can be repeated.",
   get_project: "Describe the whole project: parameters, every feature in order (id, name, type, main values, whether it built or the error), and every body (volume, area, bounding box). Start here, and call it again after changes to check the result.",
-  list_faces: "List the faces of a body: index, flat or curved, normal, centre, area, and for flat faces the sketch frame (origin, x and y axes) with the face's bounds in it. The indices go into hole, shell and add_sketch (face). Returns a rebuildId those commands require.",
-  list_edges: "List the edges of a body: index, convex / concave / smooth, length, straight or curved, direction, midpoint, and the faces they border. The indices go into fillet and chamfer. Returns a rebuildId those commands require.",
+  list_faces: "List the faces of a body: index, flat or curved, normal, centre, area, and for flat faces the sketch frame (origin, x and y axes) with the face's bounds in it. The indices go into hole, shell and add_sketch (face). Returns a rebuildId those commands require. A body can have hundreds of faces: use the filter (normal, kind).",
+  list_edges: "List the edges of a body: index, convex / concave / smooth, length, straight or curved, direction, midpoint, and the faces they border. The indices go into fillet and chamfer. Returns a rebuildId those commands require. A body can have hundreds of edges: use the filter (face, direction, kind).",
   measure: "Measure bodies: volume (mm3), surface area (mm2), bounding box (mm) and its centre.",
   render_view: "Render the model to a PNG image from a standard view, to look at the result. Needs the Polypad browser tab."
 };
@@ -35451,12 +35501,25 @@ var SERVER_INSTRUCTIONS = `Polypad is a parametric CAD editor. These tools build
 Units and axes: lengths are millimetres, angles degrees, Z is up. Any length field accepts a number or an expression over the project's parameters ("width / 2"); prefer set_parameter for sizes that belong together.
 
 Workflow:
-1. Start with get_project to see what is already there (the user may have work open). new_project replaces the open project, so use it only when asked or when the project is empty.
+1. Start with get_project to see what is already there (the user may have work open). new_project replaces the open project: if it has features, ask the user first and never call it over their work; use it freely only when the project is empty.
 2. Build with add_primitive, or add_sketch then extrude / revolve. Ids returned by a command are the feature and body ids for later calls.
 3. For hole, shell, fillet, chamfer and for sketching on a face, call list_faces or list_edges first. Pass the indices they return together with the same rebuildId. The rebuildId changes whenever the model changes, so after any change list again; a stale one is refused ("Call list_edges again").
 4. A feature that does not build stays in the project with its error: fix it with update_feature, or remove it with delete_feature or undo.
 5. Check your work: measure gives volume and bounding box, and render_view returns a PNG (iso, top, front, right) so you can look at the result. Compare the numbers with what was asked before you finish.
 
+Pick the tool by task:
+- Hollow part (enclosure, box, cup): shell the solid with the open face(s) removed (list_faces with filter normal "+z" finds the top); don't subtract a smaller box.
+- Screw holes, standoffs, inserts: hole (size, fit close/normal/loose/tap/insert, counterbore or countersink, blind depth), not cut circles.
+- Several of the same hole (a bolt circle on a flange, a row or grid of mounting holes): make one hole with hole, then pattern_hole with its id. For a bolt circle use layout kind circular, axis = the face normal axis (z for a top face), centre = a point on the circle's axis, count = number of holes; place the first hole on the circle itself (list_faces gives the face's frame and bounds). Copies that land off the face are skipped and reported.
+- Repeated parts (rows, grids, around a circle, lattices): model one body, or one cutter body, then pattern it (then combine subtract for a cutter). Symmetric parts: model one side, then mirror.
+- Round parts (knobs, turrets, finials, domes): add_sketch on XZ (sketch x = world X, sketch y = world Z), draw half the outline at x >= 0, then revolve with axis "y" (the world Z axis).
+- Pipes, spacers and rings: the tube primitive (a torus for an O-ring), not two subtracted cylinders.
+- Sizes that belong together or may change: set_parameter first, then use the names in fields.
+- Changing or fixing a feature: update_feature (or undo the last step); don't delete and rebuild.
+- Picking edges: use the list_edges filter (face, direction, kind) and the list_faces filter (normal, kind) instead of reading every edge. For the rim of the top: list_faces normal "+z", then list_edges face <index>.
+- Fillet fails: try a smaller radius or fewer edges at once, or use chamfer.
+- Clearances and collisions: measure gives bounding boxes; combine intersect on two bodies, then measure, shows an overlap; then undo.
+
 Results: a result with isError set was refused or something in the model did not build; the text says what and how to fix it. Nothing is changed by a refused call.`;
 function toToolResult(result) {
   const content = [{ type: "text", text: result.text }];
@@ -35485,7 +35548,7 @@ function createPolypadMcp(options = {}) {
 }
 
 // src/index.ts
-var VERSION = true ? "0.1.1" : "0.0.0-dev";
+var VERSION = true ? "0.1.6" : "0.0.0-dev";
 var err = (line2) => process.stderr.write(`${line2}
 `);
 async function main() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polypad/mcp",
-  "version": "0.1.1",
+  "version": "0.1.6",
   "type": "module",
   "description": "MCP server that lets Claude, Cursor or another AI assistant build and inspect 3D models in your open Polypad tab (polypad.ink). Runs locally, nothing is uploaded.",
   "license": "MIT",
@@ -18,6 +18,7 @@
   },
   "files": [
     "dist/index.js",
+    "dist/THIRD_PARTY_NOTICES.txt",
     "README.md",
     "LICENSE"
   ],
@@ -32,9 +33,11 @@
     "prepublishOnly": "tsup",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
-    "lint": "eslint ."
+    "lint": "eslint .",
+    "build:mcpb": "node mcpb/build.mjs"
   },
   "devDependencies": {
+    "@anthropic-ai/mcpb": "2.1.2",
     "@modelcontextprotocol/sdk": "^1.32.1",
     "@polypad/core": "workspace:*",
     "@polypad/document": "workspace:*",