Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

io.github.gpambrozio/onshape

NPM · @GPAMBROZIO/ONSHAPE-MCP · SCANNED SEP 24

Drive Onshape CAD from an assistant: documents, sketches, solid features, assemblies and exports.

80 Trust /100
Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security98
  • No malware found by supply-chain analysis.Pass
  • No known CVEs affecting this package version or its production dependencies.Pass
  • No install/post-install scripts declared.Pass
  • 34 of 121 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency100
  • Source repository is publicly reachable at the declared URL. View diagnostics → Pass
  • Cryptographically verified build provenance (signed, bound to gpambrozio/onshape-mcp). View diagnostics → Pass
  • Clear OSI-approved license (MIT).Pass
  • Actively maintained (last published 2 days ago).Pass
  • Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability73
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 12872 tokens (~147/item across 87 items; 87 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
  • Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
Tool Safety93
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • 5 of 7 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "onshape_eval_featurescript" implies "eval" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Partial
  • An AI judge read all 88 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Unverified: 1 category

A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

Install

How do I install the io.github.gpambrozio/onshape MCP server?

io.github.gpambrozio/onshape runs locally as an npm package, launched with npx -y @gpambrozio/onshape-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

npm · @gpambrozio/onshape-mcp

# add to Claude Code
claude mcp add gpambrozio-onshape -- npx -y @gpambrozio/onshape-mcp
// .cursor/mcp.json
{
  "mcpServers": {
    "gpambrozio-onshape": {
      "command": "npx",
      "args": [
        "-y",
        "@gpambrozio/onshape-mcp"
      ]
    }
  }
}
// .vscode/mcp.json
{
  "servers": {
    "gpambrozio-onshape": {
      "command": "npx",
      "args": [
        "-y",
        "@gpambrozio/onshape-mcp"
      ]
    }
  }
}
# add to Codex CLI
codex mcp add gpambrozio-onshape -- npx -y @gpambrozio/onshape-mcp
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "gpambrozio-onshape": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@gpambrozio/onshape-mcp"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add gpambrozio-onshape --command npx --arg -y --arg @gpambrozio/onshape-mcp
# ~/.hermes/config.yaml
mcp_servers:
  gpambrozio-onshape:
    command: "npx"
    args: ["-y", "@gpambrozio/onshape-mcp"]
// ~/.netclaw/config/netclaw.json
{
  "McpServers": {
    "gpambrozio-onshape": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "@gpambrozio/onshape-mcp"
      ]
    }
  }
}
# add to Vellum
assistant mcp add gpambrozio-onshape -t stdio -c npx -a -y @gpambrozio/onshape-mcp
// mcp.json
{
  "mcpServers": {
    "gpambrozio-onshape": {
      "command": "npx",
      "args": [
        "-y",
        "@gpambrozio/onshape-mcp"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 22 Sept 26 80

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 24 Sept 2026 · Analysed npm/@gpambrozio/onshape-mcp@0.1.2

Provenance Verified

A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.

Result Verified
Ecosystem npm
Reason Verified
Discovered via Registry attestation endpoint
Source repo gpambrozio/onshape-mcp
Certificate issuer https://token.actions.githubusercontent.com
Certificate SAN https://github.com/gpambrozio/onshape-mcp/.github/workflows/release.yml@refs/tags/v0.1.2
Rekor log index 2907221075
Predicate type https://slsa.dev/provenance/v1
Subject digest sha512:e97be88799902314905d7e3785416718f81012328ed4f147dcadeb541aa1655921b5fb519b50fd2485478199ff24df92f783b312a4fc46272e63e2cb1

Background: How many MCP packages publish verified provenance →

Dependencies 121 packages
Packages resolved 121
Stale 34
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 87 exposed · ~12,547 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
onshape_add_feature ~163

Post a hand-written BTM feature payload to a Part Studio. The escape hatch for feature types this server has no dedicated tool for — read onshape_get_feature_specs first.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
featureobjectyesThe feature JSON, usually a BTFeatureDefinitionCall-1406 envelope.
validatebooleanRe-read the feature list afterwards and fail if the feature regenerated with an error (default true).
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_assembly_add_feature ~114

Post a hand-written assembly feature payload — the escape hatch for mate types with no tool here.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
featureobjectyesThe assembly feature JSON.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_assembly_group ~116

Lock several instances together without individual mates.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
namestringFeature name (default "Group").
occurrencesarrayyesOccurrence ids to group.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_assembly_mass_properties ~96

Mass, volume, centroid and inertia for a whole assembly.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_assembly_mate ~154

Join two or more mate connectors with a mate: FASTENED, REVOLUTE, SLIDER, PLANAR, and so on.

NameTypeReqDescription
connectorsarrayyesFeature ids of the mate connectors to join.
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
namestringFeature name (default "Mate").
typestringMate type (default FASTENED).
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_assembly_mate_connector ~173

Place an implicit mate connector on an instance by inference (CENTROID, TOP, ...). Its feature id is what onshape_assembly_mate then joins.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
inferencestringInference type, e.g. CENTROID, TOP, MID_PLANE (default CENTROID).
namestringFeature name (default "Mate connector").
occurrencestringyesOccurrence id of the instance to attach to.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_auth_status ~53

Report which Onshape credential is active, where it came from and whether it still works. Secrets are redacted.

NameTypeReqDescription
verifybooleanAlso make a live API call to confirm the credential (default true).

No output schema declared.

No examples provided.

onshape_boolean ~218

Combine bodies: UNION, SUBTRACTION or INTERSECTION. Subtraction also needs the targets query.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
keep_toolsbooleanKeep the tool bodies after the operation.
namestringFeature name shown in the tree (default "Boolean").
opstringBoolean operation (default UNION).
targetsstringFeatureScript query selecting the target bodies (SUBTRACTION).
tool_idsarrayDeterministic ids of the tool bodies.
toolsstringFeatureScript query selecting the tool bodies.
validatebooleanRe-read the feature list afterwards and fail if the feature regenerated with an error (default true).
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_boolean_union ~143

Merge all modifiable solid bodies into one. The usual cleanup before exporting a single part.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
namestringFeature name shown in the tree (default "Union bodies").
validatebooleanRe-read the feature list afterwards and fail if the feature regenerated with an error (default true).
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_chamfer ~294

Bevel the selected edges. Selection works exactly as for onshape_fillet.

NameTypeReqDescription
allbooleanSelect all edges of all solid bodies.
anglenumberAngle in degrees, for type=OFFSET_ANGLE.
circularbooleanSelect only circular edges.
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
edgesarrayExplicit deterministic edge ids, from onshape_get_edges.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
featurestringSelect every edge created by this feature id.
namestringFeature name shown in the tree (default "Chamfer").
querystringFeatureScript query, e.g. query = qCreatedBy(makeId("FID"), EntityType.EDGE);
typestringChamfer type (default EQUAL_OFFSETS).
validatebooleanRe-read the feature list afterwards and fail if the feature regenerated with an error (default true).
widthnumberChamfer width in inches (default 0.1).
width_variablestringUse a Part Studio variable for the width.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_circular_pattern ~239

Repeat geometry around an axis.

NameTypeReqDescription
anglenumberTotal angle covered, degrees (default 360).
axisstringFeatureScript query selecting the axis.
axis_idsarrayDeterministic id of the axis entity.
countintegeryesTotal number of instances, including the original.
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
entitiesstringyesFeatureScript query selecting what to pattern.
equal_spacingbooleanSpace instances evenly over the angle (default true).
namestringFeature name shown in the tree (default "Circular Pattern").
typestringWhat kind of thing is patterned (default PART).
validatebooleanRe-read the feature list afterwards and fail if the feature regenerated with an error (default true).
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_create_assembly ~78

Add an assembly tab to a workspace.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
namestringyesTab name.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_create_document ~77

Create a document. Free Onshape accounts may only create public documents, so pass public=true there. The result carries the new document id and its default workspace id.

NameTypeReqDescription
descriptionstringDocument description.
namestringyesDocument name.
publicbooleanMake the document public (required on free accounts).

No output schema declared.

No examples provided.

onshape_create_drawing ~162

Create a drawing of a part, Part Studio or assembly. The source must be referenced by version — call onshape_create_version first and pass its id as src_version.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
namestringyesDrawing name.
partstringPart id, to draw a single part.
src_docstringSource document id (defaults to the target document).
src_elemstringyesElement id being drawn.
src_versionstringyesVersion id of the source element.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_create_feature_studio ~81

Add a Feature Studio tab for custom FeatureScript.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
namestringyesTab name.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_create_part_studio ~90

Add a Part Studio tab to a workspace. The new element id is at result.response.id.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
namestringyesTab name.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_create_sketch ~216

Add a sketch from a list of entities: lines, circles, rectangles and arcs. Use this when the single-shape sketch tools cannot express the profile. Close the profile if you intend to extrude it.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
entitiesarrayyesEntities making up the sketch.
namestringFeature name shown in the tree (default "Sketch").
planestringDefault plane to sketch on (default Front).
plane_featurestringSketch on a face created by this feature id instead of a default plane.
validatebooleanRe-read the feature list afterwards and fail if the feature regenerated with an error (default true).
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_create_version ~124

Snapshot the workspace as an immutable version. Do this before restructuring an existing design: it is the only way back to the previous state, and drawings must reference a version.

NameTypeReqDescription
descriptionstringWhy this snapshot was taken.
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
namestringyesVersion name, e.g. what is about to change.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_delete_document ~59

Move a document to the trash. This affects the whole document, not a single tab.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.

No output schema declared.

No examples provided.

onshape_delete_element ~92

Delete one element (tab) from a workspace.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_delete_feature ~112

Remove one feature from the tree. Features added after it may fail to regenerate.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
feature_idstringyesId of the feature to delete.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_delete_instance ~108

Remove one instance from an assembly by its occurrence node id.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
nodestringyesOccurrence node id of the instance.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_draft ~189

Taper faces away from a neutral plane — the usual requirement for moulded or cast parts.

NameTypeReqDescription
anglenumberDraft angle in degrees (default 3).
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
facesstringyesFeatureScript query selecting the faces to draft.
namestringFeature name shown in the tree (default "Draft").
neutralstringyesFeatureScript query selecting the neutral plane or face.
validatebooleanRe-read the feature list afterwards and fail if the feature regenerated with an error (default true).
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_encode_configuration ~111

Turn configuration parameter values into the encoded string other tools accept as `configuration`.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
paramsarrayyesParameter ids and the values to set.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_eval_featurescript ~153

Run a FeatureScript function against the Part Studio and return its decoded value. The general-purpose way to inspect geometry: 'function(context is Context, queries) { ... }'.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
rawbooleanReturn Onshape's raw response instead of the decoded value.
scriptstringyesA FeatureScript function expression taking (context, queries).
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_export ~203

Export through Onshape's translation service: STEP, IGES, 3MF, PARASOLID, SOLIDWORKS and others. Slower than STL because the translation is queued server-side.

NameTypeReqDescription
configurationstringEncoded configuration string.
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
formatstringFormat name, e.g. STEP, IGES, 3MF, PARASOLID (default STEP).
kindstringElement kind being exported (default partstudios).
outstringOutput file path (default onshape-<timestamp>.<format> in the output directory).
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_export_drawing ~143

Export a drawing as PDF (or DWG/DXF) through the translation service.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
formatstringFormat name: PDF, DWG, DXF (default PDF).
outstringOutput file path (default onshape-drawing-<timestamp>.<format>).
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_export_stl ~176

Export the Part Studio as STL, for 3D printing. Measure the model before exporting it.

NameTypeReqDescription
asciibooleanWrite ASCII STL instead of binary.
configurationstringEncoded configuration string.
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
outstringOutput file path (default onshape-<timestamp>.stl in the output directory).
resolutionstringTessellation quality (default medium).
unitsstringSTL units (default inch).
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_extrude ~237

Extrude the closed regions of a sketch into a solid. op=NEW makes a body, ADD merges into existing bodies, REMOVE cuts them, INTERSECT keeps the overlap.

NameTypeReqDescription
depthnumberyesExtrusion depth in inches.
depth_variablestringUse a Part Studio variable (by name) for the depth instead.
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
namestringFeature name shown in the tree (default "Extrude").
opstringNEW makes a new body; ADD/REMOVE/INTERSECT combine with existing bodies (default NEW).
sketchstringyesFeature id of the sketch to extrude.
validatebooleanRe-read the feature list afterwards and fail if the feature regenerated with an error (default true).
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_fillet ~291

Round the selected edges. Name the edges with one of: edges (ids), query (FeatureScript), feature (every edge that feature made), all, or circular.

NameTypeReqDescription
allbooleanSelect all edges of all solid bodies.
circularbooleanSelect only circular edges.
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
edgesarrayExplicit deterministic edge ids, from onshape_get_edges.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
featurestringSelect every edge created by this feature id.
namestringFeature name shown in the tree (default "Fillet").
querystringFeatureScript query, e.g. query = qCreatedBy(makeId("FID"), EntityType.EDGE);
radiusnumberFillet radius in inches (default 0.1).
radius_variablestringUse a Part Studio variable for the radius.
typestringFillet type (default EDGE).
validatebooleanRe-read the feature list afterwards and fail if the feature regenerated with an error (default true).
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_find_circular_edges ~139

Circular edges, optionally only those matching a radius — the usual way to pick hole rims to fillet.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
radiusnumberOnly return edges with this radius, in inches.
tolerancenumberRadius match tolerance in inches (default 0.001).
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_find_edges_by_feature ~114

Deterministic ids of the edges a given feature created, evaluated by Onshape.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
featurestringyesFeature id whose edges you want.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_find_part_studios ~92

List the Part Studios in a workspace, optionally filtered by a substring of the name.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
namestringCase-insensitive substring to match.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_get_assembly ~146

The assembly's instances, occurrences, mate features and mate connectors.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
include_mate_connectorsbooleanInclude mate connectors (default true).
include_mate_featuresbooleanInclude mate features (default true).
include_non_solidsbooleanInclude non-solid instances (default false).
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_get_assembly_features ~101

The mates, mate connectors and groups defined in an assembly, with their feature ids.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_get_body_details ~100

Bodies, faces and edges with their deterministic ids — the source for explicit edge selection.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_get_bom ~121

The assembly's BOM table.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
indentedbooleanReturn the indented BOM (default true).
multi_levelbooleanExpand sub-assemblies (default false).
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_get_configuration ~96

The configuration parameters an element exposes, with their ids and allowed values.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_get_document ~53

Read one document's metadata, including its default workspace id.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.

No output schema declared.

No examples provided.

onshape_get_document_summary ~73

Document metadata plus every workspace and the elements (tabs) inside each — the fastest way to orient in an unfamiliar document and collect the ids other tools need.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.

No output schema declared.

No examples provided.

onshape_get_drawing_views ~92

The views placed on a drawing sheet.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_get_edges ~104

Every edge of every solid body, with its deterministic id, owning body, type and radius (inches).

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_get_elements ~93

List the elements (tabs) in a workspace: Part Studios, assemblies, drawings, Feature Studios.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
typestringOnly return elements of this type.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_get_feature_specs ~116

The parameter ids, enum names and defaults Onshape expects for every feature type in this Part Studio. Read this before hand-writing a payload for onshape_add_feature.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_get_feature_studio ~93

The FeatureScript source of a Feature Studio.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_get_feature_studio_specs ~99

The feature specifications a Feature Studio defines, for calling its custom features.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_get_features ~136

The full feature tree with each feature's id, type, parameters and regeneration state. Large — prefer onshape_measure or onshape_get_parts when you only need the result of the tree.

NameTypeReqDescription
configurationstringEncoded configuration string from onshape_encode_configuration.
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_get_metadata ~114

Read the properties of an element, or of one part when part is given.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
partstringPart id, to read that part's properties.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_get_parts ~98

The parts a Part Studio produces, with part ids for export and assembly insertion.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

onshape_get_sketch_info ~114

Entities and solved geometry for every sketch in a Part Studio, or for one sketch.

NameTypeReqDescription
docstringyesDocument id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>.
elemstringyesElement id (tab) — the <elem> segment of the document URL.
sketchstringLimit to this sketch feature id.
wsstringyesWorkspace id — the <ws> segment of the document URL.

No output schema declared.

No examples provided.

Common questions

What is the io.github.gpambrozio/onshape MCP server?

io.github.gpambrozio/onshape is an MCP server listed in the public MCP registry as io.github.gpambrozio/onshape. Drive Onshape CAD from an assistant: documents, sketches, solid features, assemblies and exports. This page covers its npm package (@gpambrozio/onshape-mcp).

Is the io.github.gpambrozio/onshape MCP server safe to use?

io.github.gpambrozio/onshape scores 80 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 24 September 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the io.github.gpambrozio/onshape MCP server expose?

io.github.gpambrozio/onshape exposes 87 tools: onshape_login, onshape_login_status, onshape_set_api_key, onshape_auth_status, onshape_logout, and 82 more. Their descriptions and schemas cost roughly 12,547 tokens of context every time the server is loaded.

Is the io.github.gpambrozio/onshape MCP server still maintained?

io.github.gpambrozio/onshape is still listed as active in the MCP registry. We last reached this channel on 24 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the io.github.gpambrozio/onshape MCP server under?

io.github.gpambrozio/onshape declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.