io.github.gpambrozio/onshape
NPM · @GPAMBROZIO/ONSHAPE-MCP · SCANNED SEP 24
Drive Onshape CAD from an assistant: documents, sketches, solid features, assemblies and exports.
Available components
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.
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
claude mcp add gpambrozio-onshape -- npx -y @gpambrozio/onshape-mcp
{
"mcpServers": {
"gpambrozio-onshape": {
"command": "npx",
"args": [
"-y",
"@gpambrozio/onshape-mcp"
]
}
}
} {
"servers": {
"gpambrozio-onshape": {
"command": "npx",
"args": [
"-y",
"@gpambrozio/onshape-mcp"
]
}
}
} codex mcp add gpambrozio-onshape -- npx -y @gpambrozio/onshape-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"gpambrozio-onshape": {
"type": "local",
"command": [
"npx",
"-y",
"@gpambrozio/onshape-mcp"
],
"enabled": true
}
}
} openclaw mcp add gpambrozio-onshape --command npx --arg -y --arg @gpambrozio/onshape-mcp
mcp_servers:
gpambrozio-onshape:
command: "npx"
args: ["-y", "@gpambrozio/onshape-mcp"] {
"McpServers": {
"gpambrozio-onshape": {
"Transport": "stdio",
"Command": "npx",
"Arguments": [
"-y",
"@gpambrozio/onshape-mcp"
]
}
}
} assistant mcp add gpambrozio-onshape -t stdio -c npx -a -y @gpambrozio/onshape-mcp
{
"mcpServers": {
"gpambrozio-onshape": {
"command": "npx",
"args": [
"-y",
"@gpambrozio/onshape-mcp"
]
}
}
} 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.
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 →
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 →
onshape_add_feature Add a raw 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.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| feature | object | yes | The feature JSON, usually a BTFeatureDefinitionCall-1406 envelope. |
| validate | boolean | – | Re-read the feature list afterwards and fail if the feature regenerated with an error (default true). |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_assembly_add_feature Add a raw assembly feature ~114
Post a hand-written assembly feature payload — the escape hatch for mate types with no tool here.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| feature | object | yes | The assembly feature JSON. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_assembly_group Group instances ~116
Lock several instances together without individual mates.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| name | string | – | Feature name (default "Group"). |
| occurrences | array | yes | Occurrence ids to group. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_assembly_mass_properties Get assembly mass properties ~96
Mass, volume, centroid and inertia for a whole assembly.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_assembly_mate Add a mate ~154
Join two or more mate connectors with a mate: FASTENED, REVOLUTE, SLIDER, PLANAR, and so on.
| Name | Type | Req | Description |
|---|---|---|---|
| connectors | array | yes | Feature ids of the mate connectors to join. |
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| name | string | – | Feature name (default "Mate"). |
| type | string | – | Mate type (default FASTENED). |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_assembly_mate_connector Add a 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.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| inference | string | – | Inference type, e.g. CENTROID, TOP, MID_PLANE (default CENTROID). |
| name | string | – | Feature name (default "Mate connector"). |
| occurrence | string | yes | Occurrence id of the instance to attach to. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_auth_status Show Onshape sign-in status ~53
Report which Onshape credential is active, where it came from and whether it still works. Secrets are redacted.
| Name | Type | Req | Description |
|---|---|---|---|
| verify | boolean | – | Also make a live API call to confirm the credential (default true). |
No output schema declared.
No examples provided.
onshape_boolean Boolean bodies ~218
Combine bodies: UNION, SUBTRACTION or INTERSECTION. Subtraction also needs the targets query.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| keep_tools | boolean | – | Keep the tool bodies after the operation. |
| name | string | – | Feature name shown in the tree (default "Boolean"). |
| op | string | – | Boolean operation (default UNION). |
| targets | string | – | FeatureScript query selecting the target bodies (SUBTRACTION). |
| tool_ids | array | – | Deterministic ids of the tool bodies. |
| tools | string | – | FeatureScript query selecting the tool bodies. |
| validate | boolean | – | Re-read the feature list afterwards and fail if the feature regenerated with an error (default true). |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_boolean_union Union every body ~143
Merge all modifiable solid bodies into one. The usual cleanup before exporting a single part.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| name | string | – | Feature name shown in the tree (default "Union bodies"). |
| validate | boolean | – | Re-read the feature list afterwards and fail if the feature regenerated with an error (default true). |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_chamfer Chamfer edges ~294
Bevel the selected edges. Selection works exactly as for onshape_fillet.
| Name | Type | Req | Description |
|---|---|---|---|
| all | boolean | – | Select all edges of all solid bodies. |
| angle | number | – | Angle in degrees, for type=OFFSET_ANGLE. |
| circular | boolean | – | Select only circular edges. |
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| edges | array | – | Explicit deterministic edge ids, from onshape_get_edges. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| feature | string | – | Select every edge created by this feature id. |
| name | string | – | Feature name shown in the tree (default "Chamfer"). |
| query | string | – | FeatureScript query, e.g. query = qCreatedBy(makeId("FID"), EntityType.EDGE); |
| type | string | – | Chamfer type (default EQUAL_OFFSETS). |
| validate | boolean | – | Re-read the feature list afterwards and fail if the feature regenerated with an error (default true). |
| width | number | – | Chamfer width in inches (default 0.1). |
| width_variable | string | – | Use a Part Studio variable for the width. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_circular_pattern Circular pattern ~239
Repeat geometry around an axis.
| Name | Type | Req | Description |
|---|---|---|---|
| angle | number | – | Total angle covered, degrees (default 360). |
| axis | string | – | FeatureScript query selecting the axis. |
| axis_ids | array | – | Deterministic id of the axis entity. |
| count | integer | yes | Total number of instances, including the original. |
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| entities | string | yes | FeatureScript query selecting what to pattern. |
| equal_spacing | boolean | – | Space instances evenly over the angle (default true). |
| name | string | – | Feature name shown in the tree (default "Circular Pattern"). |
| type | string | – | What kind of thing is patterned (default PART). |
| validate | boolean | – | Re-read the feature list afterwards and fail if the feature regenerated with an error (default true). |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_create_assembly Create an assembly ~78
Add an assembly tab to a workspace.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| name | string | yes | Tab name. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_create_document Create an Onshape 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.
| Name | Type | Req | Description |
|---|---|---|---|
| description | string | – | Document description. |
| name | string | yes | Document name. |
| public | boolean | – | Make the document public (required on free accounts). |
No output schema declared.
No examples provided.
onshape_create_drawing Create a 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.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| name | string | yes | Drawing name. |
| part | string | – | Part id, to draw a single part. |
| src_doc | string | – | Source document id (defaults to the target document). |
| src_elem | string | yes | Element id being drawn. |
| src_version | string | yes | Version id of the source element. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_create_feature_studio Create a Feature Studio ~81
Add a Feature Studio tab for custom FeatureScript.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| name | string | yes | Tab name. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_create_part_studio Create a Part Studio ~90
Add a Part Studio tab to a workspace. The new element id is at result.response.id.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| name | string | yes | Tab name. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_create_sketch Sketch arbitrary entities ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| entities | array | yes | Entities making up the sketch. |
| name | string | – | Feature name shown in the tree (default "Sketch"). |
| plane | string | – | Default plane to sketch on (default Front). |
| plane_feature | string | – | Sketch on a face created by this feature id instead of a default plane. |
| validate | boolean | – | Re-read the feature list afterwards and fail if the feature regenerated with an error (default true). |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_create_version Create a document 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.
| Name | Type | Req | Description |
|---|---|---|---|
| description | string | – | Why this snapshot was taken. |
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| name | string | yes | Version name, e.g. what is about to change. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_delete_document Delete an Onshape document ~59
Move a document to the trash. This affects the whole document, not a single tab.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
No output schema declared.
No examples provided.
onshape_delete_element Delete an element ~92
Delete one element (tab) from a workspace.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_delete_feature Delete a feature ~112
Remove one feature from the tree. Features added after it may fail to regenerate.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| feature_id | string | yes | Id of the feature to delete. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_delete_instance Delete an instance ~108
Remove one instance from an assembly by its occurrence node id.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| node | string | yes | Occurrence node id of the instance. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_draft Draft faces ~189
Taper faces away from a neutral plane — the usual requirement for moulded or cast parts.
| Name | Type | Req | Description |
|---|---|---|---|
| angle | number | – | Draft angle in degrees (default 3). |
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| faces | string | yes | FeatureScript query selecting the faces to draft. |
| name | string | – | Feature name shown in the tree (default "Draft"). |
| neutral | string | yes | FeatureScript query selecting the neutral plane or face. |
| validate | boolean | – | Re-read the feature list afterwards and fail if the feature regenerated with an error (default true). |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_encode_configuration Encode a configuration ~111
Turn configuration parameter values into the encoded string other tools accept as `configuration`.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| params | array | yes | Parameter ids and the values to set. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_eval_featurescript Evaluate 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) { ... }'.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| raw | boolean | – | Return Onshape's raw response instead of the decoded value. |
| script | string | yes | A FeatureScript function expression taking (context, queries). |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_export Export CAD format ~203
Export through Onshape's translation service: STEP, IGES, 3MF, PARASOLID, SOLIDWORKS and others. Slower than STL because the translation is queued server-side.
| Name | Type | Req | Description |
|---|---|---|---|
| configuration | string | – | Encoded configuration string. |
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| format | string | – | Format name, e.g. STEP, IGES, 3MF, PARASOLID (default STEP). |
| kind | string | – | Element kind being exported (default partstudios). |
| out | string | – | Output file path (default onshape-<timestamp>.<format> in the output directory). |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_export_drawing Export a drawing ~143
Export a drawing as PDF (or DWG/DXF) through the translation service.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| format | string | – | Format name: PDF, DWG, DXF (default PDF). |
| out | string | – | Output file path (default onshape-drawing-<timestamp>.<format>). |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_export_stl Export STL ~176
Export the Part Studio as STL, for 3D printing. Measure the model before exporting it.
| Name | Type | Req | Description |
|---|---|---|---|
| ascii | boolean | – | Write ASCII STL instead of binary. |
| configuration | string | – | Encoded configuration string. |
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| out | string | – | Output file path (default onshape-<timestamp>.stl in the output directory). |
| resolution | string | – | Tessellation quality (default medium). |
| units | string | – | STL units (default inch). |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_extrude Extrude a sketch ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| depth | number | yes | Extrusion depth in inches. |
| depth_variable | string | – | Use a Part Studio variable (by name) for the depth instead. |
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| name | string | – | Feature name shown in the tree (default "Extrude"). |
| op | string | – | NEW makes a new body; ADD/REMOVE/INTERSECT combine with existing bodies (default NEW). |
| sketch | string | yes | Feature id of the sketch to extrude. |
| validate | boolean | – | Re-read the feature list afterwards and fail if the feature regenerated with an error (default true). |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_fillet Fillet edges ~291
Round the selected edges. Name the edges with one of: edges (ids), query (FeatureScript), feature (every edge that feature made), all, or circular.
| Name | Type | Req | Description |
|---|---|---|---|
| all | boolean | – | Select all edges of all solid bodies. |
| circular | boolean | – | Select only circular edges. |
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| edges | array | – | Explicit deterministic edge ids, from onshape_get_edges. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| feature | string | – | Select every edge created by this feature id. |
| name | string | – | Feature name shown in the tree (default "Fillet"). |
| query | string | – | FeatureScript query, e.g. query = qCreatedBy(makeId("FID"), EntityType.EDGE); |
| radius | number | – | Fillet radius in inches (default 0.1). |
| radius_variable | string | – | Use a Part Studio variable for the radius. |
| type | string | – | Fillet type (default EDGE). |
| validate | boolean | – | Re-read the feature list afterwards and fail if the feature regenerated with an error (default true). |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_find_circular_edges Find circular edges ~139
Circular edges, optionally only those matching a radius — the usual way to pick hole rims to fillet.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| radius | number | – | Only return edges with this radius, in inches. |
| tolerance | number | – | Radius match tolerance in inches (default 0.001). |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_find_edges_by_feature Find edges created by a feature ~114
Deterministic ids of the edges a given feature created, evaluated by Onshape.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| feature | string | yes | Feature id whose edges you want. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_find_part_studios Find Part Studios by name ~92
List the Part Studios in a workspace, optionally filtered by a substring of the name.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| name | string | – | Case-insensitive substring to match. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_get_assembly Get assembly structure ~146
The assembly's instances, occurrences, mate features and mate connectors.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| include_mate_connectors | boolean | – | Include mate connectors (default true). |
| include_mate_features | boolean | – | Include mate features (default true). |
| include_non_solids | boolean | – | Include non-solid instances (default false). |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_get_assembly_features List assembly features ~101
The mates, mate connectors and groups defined in an assembly, with their feature ids.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_get_body_details Get body topology ~100
Bodies, faces and edges with their deterministic ids — the source for explicit edge selection.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_get_bom Get the bill of materials ~121
The assembly's BOM table.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| indented | boolean | – | Return the indented BOM (default true). |
| multi_level | boolean | – | Expand sub-assemblies (default false). |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_get_configuration Get element configuration ~96
The configuration parameters an element exposes, with their ids and allowed values.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_get_document Get an Onshape document ~53
Read one document's metadata, including its default workspace id.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
No output schema declared.
No examples provided.
onshape_get_document_summary Summarize an Onshape document ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
No output schema declared.
No examples provided.
onshape_get_drawing_views List drawing views ~92
The views placed on a drawing sheet.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_get_edges List edges ~104
Every edge of every solid body, with its deterministic id, owning body, type and radius (inches).
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_get_elements List elements in a workspace ~93
List the elements (tabs) in a workspace: Part Studios, assemblies, drawings, Feature Studios.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| type | string | – | Only return elements of this type. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_get_feature_specs Get feature specifications ~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.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_get_feature_studio Read a Feature Studio ~93
The FeatureScript source of a Feature Studio.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_get_feature_studio_specs Get Feature Studio specs ~99
The feature specifications a Feature Studio defines, for calling its custom features.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_get_features List Part Studio 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.
| Name | Type | Req | Description |
|---|---|---|---|
| configuration | string | – | Encoded configuration string from onshape_encode_configuration. |
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_get_metadata Get element or part metadata ~114
Read the properties of an element, or of one part when part is given.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| part | string | – | Part id, to read that part's properties. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_get_parts List parts ~98
The parts a Part Studio produces, with part ids for export and assembly insertion.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
onshape_get_sketch_info Get sketch geometry ~114
Entities and solved geometry for every sketch in a Part Studio, or for one sketch.
| Name | Type | Req | Description |
|---|---|---|---|
| doc | string | yes | Document id — the <doc> in cad.onshape.com/documents/<doc>/w/<ws>/e/<elem>. |
| elem | string | yes | Element id (tab) — the <elem> segment of the document URL. |
| sketch | string | – | Limit to this sketch feature id. |
| ws | string | yes | Workspace id — the <ws> segment of the document URL. |
No output schema declared.
No examples provided.
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.