Skip to content
Back to search

jarvis-onshape-mcp

Jarvis Onshape MCP — Claude Code plugin for driving real Onshape CAD. Vision-decomposition skill + truth-telling + parametric iteration + FeatureScript.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/ReshefElisha/jarvis-onshape-mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/ReshefElisha/jarvis-onshape-mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/reshefelisha--jarvis-onshape-mcp/badge.svg)](/listings/reshefelisha--jarvis-onshape-mcp)

HTML

<a href="/listings/reshefelisha--jarvis-onshape-mcp"><img src="/api/listings/reshefelisha--jarvis-onshape-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

/plugin install github:ReshefElisha/jarvis-onshape-mcp

Claude Code will prompt you for:

- `ONSHAPE_API_KEY` — the "Access Key" from the Onshape developer portal. - `ONSHAPE_API_SECRET` — the "Secret Key" shown once when you create the key pair.

Get a key pair at [dev-portal.onshape.com](https://dev-portal.onshape.com/). Both values are stored in the OS keychain and never written to disk in plaintext.

Requirements

- [uv](https://docs.astral.sh/uv/) on your PATH (`brew install uv` or the official installer). The plugin launches its MCP server via `uv run`. - Claude Code desktop or CLI with plugin support. - An Onshape account.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 14 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "jarvis-onshape-mcp",
  3. "owner": {
  4. "name": "Reshef Elisha",
  5. "url": "https://github.com/ReshefElisha"
  6. },
  7. "plugins": [
  8. {
  9. "name": "jarvis-onshape-mcp",
  10. "source": "./",
  11. "description": "Jarvis Onshape MCP — Claude Code plugin for driving real Onshape CAD. Vision-decomposition skill, truth-telling on every mutation, parametric iteration, FeatureScript custom features."
  12. }
  13. ]
  14. }
README.md · README · 185 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Jarvis Onshape MCP
  2. Claude Code plugin that lets Claude drive real Onshape CAD: sketches, extrudes,
  3. fillets, mates, parametric iteration via Variable Studios, custom FeatureScript
  4. features. Every mutating tool returns a structured truth: what changed, what
  5. warnings the regenerator raised, and hints for the next move. Multi-view PNG
  6. renders come back as image content so Claude can actually see the part.
  7. Includes a vision-decomposition skill that walks Claude through reading an
  8. engineering reference image *before* building. See `RESEARCH.md` for the
  9. benchmark data behind that workflow.
  10. > "felt dramatically more like writing code than anything I've tried with an LLM CAD tool."
  11. ## What you get
  12. - **Truth-telling on every mutation.** Every tool returns `{ok, status,
  13. feature_id, feature_name, error_message, changes?, hints?}`. Silent regen
  14. failures are surfaced, warnings are enriched with actionable fixes.
  15. - **Vision.** `render_part_studio_views` and `render_assembly_views` return
  16. shaded PNGs (front/top/right/iso). `crop_image` zooms in on regions.
  17. `load_local_image` caches a reference image (drawing, photo, sketch) the
  18. user shares so you can crop into it the same way. `compare_to_reference`
  19. renders your in-progress part and composites it directly under the
  20. reference for side-by-side visual diff in a single image.
  21. - **Vision-decomposition skill.** `/skill vision-decompose` — when the
  22. user gives you a reference image and asks you to build it, this skill
  23. walks you through a structured zoom-and-describe pass *before* you start
  24. building. Produces a feature tree the user can sanity-check. We measured
  25. this turns "agent skims image and builds the wrong shape" into "agent
  26. reads image carefully, asks the user to confirm, then builds." See the
  27. research writeup below.
  28. - **Drawing OCR.** `extract_drawing_dimensions` runs Tesseract on an
  29. engineering drawing and returns every numeric callout (length / radius /
  30. diameter / thread / angle / count) grouped by kind, with pixel positions.
  31. Use it on hard-to-read drawing PNGs where small dim text gets clobbered
  32. by Claude's vision downsampling.
  33. - **Entity discovery with outward normals.** `list_entities` returns deterministic
  34. face IDs, surface types, and normals so follow-up features can target geometry
  35. without guessing.
  36. - **Per-feature geometric diffs.** After each feature, you get a `changes:`
  37. block with bbox delta, part count delta, mass delta — you see the effect
  38. before rendering.
  39. - **Parametric iteration.** First-class Variable Studios. `set_variable` is
  40. upsert-by-name, so reparametrizing NEMA 17 → NEMA 23 is a few values away.
  41. - **FeatureScript escape hatch.** `write_featurescript_feature` lets Claude
  42. write a custom feature directly (helices, swept threads, shells with
  43. parameters) when the tool-per-primitive surface isn't enough. Regen errors
  44. surface FS notice text.
  45. - **Hints rotation.** When a feature fails with a known pattern, hints point
  46. at the fix (`BOOLEAN_SUBTRACT_NO_OP → oppositeDirection`,
  47. `SKETCH_DIMENSION_MISSING_PARAMETER → add missing variable`, …).
  48. - **Assembly.** Fastened, slider, revolute, cylindrical mates; face-coordinate
  49. systems; instance alignment; bounding-box interference checks.
  50. ## Install
  51. ```
  52. /plugin install github:ReshefElisha/jarvis-onshape-mcp
  53. ```
  54. Claude Code will prompt you for:
  55. - `ONSHAPE_API_KEY` — the "Access Key" from the Onshape developer portal.
  56. - `ONSHAPE_API_SECRET` — the "Secret Key" shown once when you create the key pair.
  57. Get a key pair at [dev-portal.onshape.com](https://dev-portal.onshape.com/).
  58. Both values are stored in the OS keychain and never written to disk in plaintext.
  59. ### Requirements
  60. - [uv](https://docs.astral.sh/uv/) on your PATH (`brew install uv` or the
  61. official installer). The plugin launches its MCP server via `uv run`.
  62. - Claude Code desktop or CLI with plugin support.
  63. - An Onshape account.
  64. ## Quick start
  65. Once installed, restart Claude Code and try:
  66. > "Create a new Onshape document, add a Part Studio, and build me a
  67. > 60×40×8 mm mounting plate with four ø4 mm holes 6 mm in from the corners."
  68. Claude will render the result, show you the bbox delta, and surface any
  69. regen warnings. If it takes a wrong direction on an extrude, the
  70. `BOOLEAN_SUBTRACT_NO_OP` hint will kick in and it'll self-correct.
  71. ## Protocol guide
  72. Two plugin skills auto-discovered by Claude Code:
  73. - `skills/onshape/SKILL.md` — **CAD build skill**. Loaded into every Onshape
  74. session. Covers units (bare numbers in mm), coordinate frames (Front is XZ
  75. with a Y-normal sign flip), render-first and entity-first workflows,
  76. iteration discipline, when to reach for `write_featurescript_feature`,
  77. and the gotchas (REMOVE-on-face auto-flip, Variable Studios as separate
  78. elements, deterministic ID remapping).
  79. - `skills/vision-decompose/SKILL.md` — **Vision decomposition**. Use this
  80. *before* building when the user shares a reference image. Walks the agent
  81. through overview → cache → zoom-into-each-feature → structured spec.
  82. Output is a feature tree (type, role, size, position, face) the user can
  83. review before committing turns to the build. See "Recommended workflow"
  84. below.
  85. You can load either into any Claude session as a system prompt to get the
  86. same behavior outside the plugin context.
  87. ## Recommended workflow
  88. The plugin works best as a copilot, not an autocomplete. Two modes:
  89. **Mode A — text-first design.** Describe the part in plain text ("a 100×60×30
  90. mm aluminum heat sink with 1mm fins on 3mm pitch and 4 corner Ø3.5 mounting
  91. holes") and let Claude build. This works well — the bottleneck is not CAD
  92. execution, it's image interpretation.
  93. **Mode B — image reference.** Drop in a drawing, photo, sketch, or
  94. competition prompt and ask Claude to build it.
  95. 1. Invoke the vision-decomposition skill: `/skill vision-decompose`.
  96. 2. Claude produces a structured feature tree from the image.
  97. 3. Review it — fix mis-reads, fill in things the image didn't make obvious.
  98. 4. Tell Claude "build to that spec." It runs the CAD pipeline against the
  99. confirmed tree.
  100. Mode B with a careful human review beats letting Claude attempt the whole
  101. thing autonomously. See `RESEARCH.md` for the experimental data behind that
  102. recommendation.
  103. ## Tool surface
  104. Roughly 60 tools across these groups:
  105. | Group | Highlights |
  106. |-------|-----------|
  107. | Document | `create_document`, `find_part_studios`, `get_elements` |
  108. | Sketch | `create_sketch` (multi-entity), plus rectangle / circle / line / arc / rounded rect primitives |
  109. | Feature | `create_extrude`, `create_revolve`, `create_thicken`, `create_fillet`, `create_chamfer`, `create_boolean`, `create_linear_pattern`, `create_circular_pattern` |
  110. | Assembly | `add_assembly_instance`, `create_fastened_mate`, `create_slider_mate`, `create_revolute_mate`, `create_cylindrical_mate`, `align_instance_to_face`, `check_assembly_interference` |
  111. | Introspection | `describe_part_studio`, `list_entities`, `get_body_details`, `get_bounding_box`, `get_mass_properties`, `measure`, `get_face_coordinate_system` |
  112. | Variables | `create_variable_studio`, `set_variable`, `get_variables` |
  113. | FeatureScript | `eval_featurescript`, `write_featurescript_feature` |
  114. | Rendering | `render_part_studio_views`, `render_assembly_views`, `crop_image`, `load_local_image`, `compare_to_reference`, `extract_drawing_dimensions` |
  115. | Export | `export_part_studio`, `export_assembly` (STL / STEP / GLTF / …) |
  116. Full schemas are discoverable from Claude via `ToolSearch` — no separate
  117. docs to read.
  118. ## Known limitations
  119. - **Section views are blocked** at the Onshape platform level. The REST API
  120. has no section-view endpoint; only the UI `Shift+X` works.
  121. - `create_fillet` with `variableCenter` currently hits a phantom-reference
  122. bug on Onshape's side. Bare radius works.
  123. - `opHelix` standard-library call is flaky in some contexts; cookbook uses
  124. `opFitSpline` as a workaround.
  125. ## Development
  126. ```
  127. git clone https://github.com/ReshefElisha/jarvis-onshape-mcp
  128. cd jarvis-onshape-mcp
  129. uv sync
  130. export ONSHAPE_API_KEY=...
  131. export ONSHAPE_API_SECRET=...
  132. uv run onshape-mcp # launch the MCP server on stdio
  133. uv run pytest # unit tests
  134. ```
  135. ## Attribution
  136. Scaffolding (Onshape REST client + HMAC auth, BTMFeature-134 /
  137. BTMParameterQuantity-147 / BTMIndividualQuery-138 payload builders, and the
  138. first-pass tool-per-primitive MCP surface) was forked from
  139. [hedless/onshape-mcp](https://github.com/hedless/onshape-mcp) — thanks to
  140. hedless for getting that off the ground. Everything built on top of that
  141. (truth-telling, vision, entity discovery, parametric Variable Studios,
  142. FeatureScript orchestration, per-feature geometric diffs, the hints rotation,
  143. iterative agent harness via Claude Agent SDK, and most of the current tool
  144. surface) was built here. See `NOTICE` and `git log` for the full trail.
  145. ## License
  146. MIT. See `LICENSE`.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.