Skip to main content
Glama
Onshape MCP Server

Onshape MCP Server

by henrytkirk

Onshape MCP server

Drive Onshape CAD from an AI assistant. 87 tools for documents, part studios, sketching, solid features, assemblies, drawings, measurement and export — and no setup beyond installing it: the first tool call that needs Onshape opens a browser and asks you to connect.

CI npm

"Make a 60 × 40 × 10 mm bracket with 4 mm mounting holes and 2 mm fillets, then show me a render"

The assistant sketches it, extrudes it, fillets the edges, measures the result, renders it back into the conversation, and exports an STL you can print.

Install

Claude Code

claude mcp add onshape -- npx -y @gpambrozio/onshape-mcp

Claude Desktop — download onshape-mcp-<version>.mcpb from the latest release and double-click it. Nothing else to install.

Cursor, VS Code, Windsurf, Zed and other MCP clients — add the server to the client's MCP config:

{
  "mcpServers": {
    "onshape": {
      "command": "npx",
      "args": ["-y", "@gpambrozio/onshape-mcp"]
    }
  }
}

The file differs per client: ~/.cursor/mcp.json (Cursor), .vscode/mcp.json (VS Code), ~/.codeium/windsurf/mcp_config.json (Windsurf), ~/.config/zed/settings.json under context_servers (Zed).

Node 20 or newer is required. npx fetches the package on first run.

Related MCP server: onshape-mcp

Signing in

Nothing to configure. The first tool call that needs Onshape starts a sign-in and asks your client to show you the link; clients that support MCP's URL elicitation render it as a prompt, and the rest get the URL in the reply. The page that opens links straight to the key page for your Onshape stack and takes the pasted pair; tick Read, Write and Delete when you create the key so every tool here works. Keys are verified against Onshape, then stored in your OS keychain.

Your credentials never pass through the assistant, the model or this project's authors — the exchange happens between your browser and a server bound to 127.0.0.1 in this process, which is exactly why MCP has URL elicitation.

Other ways in, if you prefer:

  • onshape_login — start the same flow deliberately.

  • onshape_set_api_key — paste a key pair you already have.

  • OAuth 2.0 — onshape_login with method: "oauth", for an app you registered at the Onshape developer portal with redirect URL http://localhost:8471/oauth/callback. Tokens refresh automatically.

  • Environment variables — set ONSHAPE_ACCESS_KEY and ONSHAPE_SECRET_KEY for unattended installs, and ONSHAPE_MCP_AUTO_LOGIN=0 to stop the server ever opening a browser.

An existing onshape-cli credential at ~/.onshape/credentials.json is picked up automatically.

onshape_auth_status shows what is in use (redacted); onshape_logout forgets it.

Tools

Area

Tools

Sign-in

login, login_status, set_api_key, auth_status, logout

Documents

list_documents, search_documents, get_document, get_document_summary, create_document, update_document, delete_document, get_workspaces, get_elements, find_part_studios, list_versions, create_version, delete_element

Part studios

create_part_studio, get_features, get_feature_specs, get_sketch_info, get_body_details, get_parts, mass_properties, measure, validate_part_studio, add_feature, update_feature, delete_feature, rollback, eval_featurescript

Sketching

sketch_rectangle, sketch_circle, sketch_line, sketch_circle_axis, create_sketch, sketch_candy_cane_path

Solids

extrude, hole, thicken, revolve, sweep, fillet, chamfer, shell, draft, boolean, boolean_union, mirror, linear_pattern, circular_pattern, offset_plane

Geometry

get_edges, find_circular_edges, find_edges_by_feature

Variables

get_variables, set_variable, get_configuration, encode_configuration

Export

export_stl, export, shaded_view, get_thumbnail, thumbnail_info

Assemblies

create_assembly, get_assembly, insert_instance, delete_instance, transform_instance, get_assembly_features, assembly_mate_connector, assembly_mate, assembly_group, assembly_add_feature, get_bom, assembly_mass_properties

Drawings

create_drawing, get_drawing_views, export_drawing

Feature studios

create_feature_studio, get_feature_studio, set_feature_studio, get_feature_studio_specs

Metadata

get_metadata, set_metadata

Escape hatch

request

All names are prefixed onshape_, and every tool returns {"ok": true, "result": …} or {"ok": false, "error": …, "detail": …}.

Worth knowing:

  • Units are inches and degrees throughout.

  • Feature tools validate by default. Onshape answers 200 for a feature that fails to regenerate, so each tool re-reads the feature state and fails loudly instead. Pass validate: false to skip it.

  • Renders come back as images. shaded_view and get_thumbnail return the PNG inline as well as writing it, so the model can see the part.

  • Big reads spill to disk. Anything over ONSHAPE_MCP_MAX_RESPONSE_BYTES (default 200 kB) is written to a file and summarised, keeping a feature tree from swallowing the context window.

  • onshape_request reaches any REST endpoint the dedicated tools miss.

Configuration

Every setting is optional.

Variable

Effect

ONSHAPE_ACCESS_KEY, ONSHAPE_SECRET_KEY

Use this key pair instead of signing in

ONSHAPE_BASE_URL

Onshape API host (default https://cad.onshape.com)

ONSHAPE_OAUTH_CLIENT_ID, ONSHAPE_OAUTH_CLIENT_SECRET

OAuth app to sign in with, instead of an API key

ONSHAPE_MCP_AUTO_LOGIN

0 stops tool calls from starting a browser sign-in

ONSHAPE_MCP_NO_BROWSER

1 never launches a browser; the URL is reported instead

ONSHAPE_MCP_SIGNIN_WAIT_MS

How long a call waits for sign-in (default 120000)

ONSHAPE_DOC, ONSHAPE_WS, ONSHAPE_ELEM

Default target; these arguments become optional when set

ONSHAPE_MCP_OUTPUT_DIR

Where relative export paths land (default: working directory)

ONSHAPE_MCP_MAX_RESPONSE_BYTES

Response size before spilling to a file (default 200000)

ONSHAPE_MCP_CONFIG

Credential file path (default ~/.onshape-mcp/credentials.json)

ONSHAPE_TIMEOUT_MS

Per-request timeout (default 120000)

Secrets go to the OS keychain (service onshape-mcp) when one is available, and the config file then holds only non-secret metadata. Without a keychain the file holds the secret and is written 0600 inside a 0700 directory.

Onshape account limits

These come from Onshape, not from this server:

  • Free accounts can only create public documents — pass public: true to onshape_create_document.

  • Deleting needs a key with delete permission. Without it Onshape answers 403 Invalid API key state; re-create the key at cad.onshape.com/user/developer/apiKeys with Delete ticked.

  • The variable-table endpoint 404s on some accounts. onshape_set_variable and onshape_get_variables fall back to assignVariable features, which work everywhere; result.route / result.source says which path was taken.

Development

npm install
npm run check     # type-check
npm test          # unit tests, no network and no browser
npm run build
npm run bundle    # build the Claude Desktop .mcpb

node scripts/smoke.mjs           # live read-only check against your account
node scripts/smoke.mjs --write   # also builds a throwaway part

Layout: src/auth (credential store, keychain, login flows, OAuth, elicitation), src/api (REST wrappers), src/builders (Onshape BTM feature payloads), src/tools (the MCP surface), src/server.ts (registration and the auth gate).

Contributions welcome — see CONTRIBUTING.md. Security reports: SECURITY.md.

Licence

MIT. Portions derived from onshape-cli — see NOTICE.

Not affiliated with, endorsed by, or supported by Onshape or PTC. "Onshape" is a trademark of PTC Inc.

Available Tools

87 tools
onshape_add_featureAdd a raw featureA

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.

Inputs: ws (required), doc (required), elem (required), feature (required), +1 more.

onshape_assembly_add_featureAdd a raw assembly featureA

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

Inputs: ws (required), doc (required), elem (required), feature (required).

onshape_assembly_groupGroup instancesA

Lock several instances together without individual mates.

Inputs: ws (required), doc (required), elem (required), occurrences (required), +1 more.

onshape_assembly_mass_propertiesGet assembly mass propertiesA
Read-only

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

Inputs: ws (required), doc (required), elem (required).

onshape_assembly_mateAdd a mateB

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

Inputs: ws (required), doc (required), elem (required), connectors (required), +2 more.

onshape_assembly_mate_connectorAdd a mate connectorA

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

Inputs: ws (required), doc (required), elem (required), occurrence (required), +2 more.

onshape_auth_statusShow Onshape sign-in statusA
Read-only

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

Inputs: verify.

onshape_booleanBoolean bodiesB

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

Inputs: ws (required), doc (required), elem (required), op, +6 more.

onshape_boolean_unionUnion every bodyA

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

Inputs: ws (required), doc (required), elem (required), name, +1 more.

onshape_chamferChamfer edgesB

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

Inputs: ws (required), doc (required), elem (required), all, +10 more.

onshape_circular_patternCircular patternB

Repeat geometry around an axis.

Inputs: ws (required), doc (required), elem (required), count (required), +8 more.

onshape_create_assemblyCreate an assemblyB

Add an assembly tab to a workspace.

Inputs: ws (required), doc (required), name (required).

onshape_create_documentCreate an Onshape documentA

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.

Inputs: name (required), public, description.

onshape_create_drawingCreate a drawingA

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.

Inputs: ws (required), doc (required), name (required), src_elem (required), +3 more.

onshape_create_feature_studioCreate a Feature StudioB

Add a Feature Studio tab for custom FeatureScript.

Inputs: ws (required), doc (required), name (required).

onshape_create_part_studioCreate a Part StudioA

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

Inputs: ws (required), doc (required), name (required).

onshape_create_sketchSketch arbitrary entitiesA

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.

Inputs: ws (required), doc (required), elem (required), entities (required), +4 more.

onshape_create_versionCreate a document versionA

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.

Inputs: ws (required), doc (required), name (required), description.

onshape_delete_documentDelete an Onshape documentA
Destructive

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

Inputs: doc (required).

onshape_delete_elementDelete an elementB
Destructive

Delete one element (tab) from a workspace.

Inputs: ws (required), doc (required), elem (required).

onshape_delete_featureDelete a featureA
Destructive

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

Inputs: ws (required), doc (required), elem (required), feature_id (required).

onshape_delete_instanceDelete an instanceA
Destructive

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

Inputs: ws (required), doc (required), elem (required), node (required).

onshape_draftDraft facesA

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

Inputs: ws (required), doc (required), elem (required), faces (required), +4 more.

onshape_encode_configurationEncode a configurationA

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

Inputs: ws (required), doc (required), elem (required), params (required).

onshape_eval_featurescriptEvaluate FeatureScriptA

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) { ... }'.

Inputs: ws (required), doc (required), elem (required), script (required), +1 more.

onshape_exportExport CAD formatA

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

Inputs: ws (required), doc (required), elem (required), out, +3 more.

onshape_export_drawingExport a drawingB

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

Inputs: ws (required), doc (required), elem (required), out, +1 more.

onshape_export_stlExport STLA

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

Inputs: ws (required), doc (required), elem (required), out, +4 more.

onshape_extrudeExtrude a sketchA

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.

Inputs: ws (required), doc (required), elem (required), depth (required), +5 more.

onshape_filletFillet edgesC

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

Inputs: ws (required), doc (required), elem (required), all, +9 more.

onshape_find_circular_edgesFind circular edgesB
Read-only

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

Inputs: ws (required), doc (required), elem (required), radius, +1 more.

onshape_find_edges_by_featureFind edges created by a featureA
Read-only

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

Inputs: ws (required), doc (required), elem (required), feature (required).

onshape_find_part_studiosFind Part Studios by nameA
Read-only

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

Inputs: ws (required), doc (required), name.

onshape_get_assemblyGet assembly structureB
Read-only

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

Inputs: ws (required), doc (required), elem (required), include_non_solids, +2 more.

onshape_get_assembly_featuresList assembly featuresB
Read-only

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

Inputs: ws (required), doc (required), elem (required).

onshape_get_body_detailsGet body topologyA
Read-only

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

Inputs: ws (required), doc (required), elem (required).

onshape_get_bomGet the bill of materialsC
Read-only

The assembly's BOM table.

Inputs: ws (required), doc (required), elem (required), indented, +1 more.

onshape_get_configurationGet element configurationB
Read-only

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

Inputs: ws (required), doc (required), elem (required).

onshape_get_documentGet an Onshape documentB
Read-only

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

Inputs: doc (required).

onshape_get_document_summarySummarize an Onshape documentA
Read-only

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.

Inputs: doc (required).

onshape_get_drawing_viewsList drawing viewsB
Read-only

The views placed on a drawing sheet.

Inputs: ws (required), doc (required), elem (required).

onshape_get_edgesList edgesB
Read-only

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

Inputs: ws (required), doc (required), elem (required).

onshape_get_elementsList elements in a workspaceA
Read-only

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

Inputs: ws (required), doc (required), type.

onshape_get_featuresList Part Studio featuresA
Read-only

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.

Inputs: ws (required), doc (required), elem (required), configuration.

onshape_get_feature_specsGet feature specificationsA
Read-only

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.

Inputs: ws (required), doc (required), elem (required).

onshape_get_feature_studioRead a Feature StudioB
Read-only

The FeatureScript source of a Feature Studio.

Inputs: ws (required), doc (required), elem (required).

onshape_get_feature_studio_specsGet Feature Studio specsA
Read-only

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

Inputs: ws (required), doc (required), elem (required).

onshape_get_metadataGet element or part metadataA
Read-only

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

Inputs: ws (required), doc (required), elem (required), part.

onshape_get_partsList partsA
Read-only

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

Inputs: ws (required), doc (required), elem (required).

onshape_get_sketch_infoGet sketch geometryB
Read-only

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

Inputs: ws (required), doc (required), elem (required), sketch.

onshape_get_thumbnailDownload the element thumbnailA

Save Onshape's stored thumbnail. Thumbnails are generated asynchronously and lag edits — prefer onshape_shaded_view to see the current state.

Inputs: ws (required), doc (required), elem (required), out, +2 more.

onshape_get_variablesList Part Studio variablesB
Read-only

The variable table of a Part Studio: names, expressions and descriptions.

Inputs: ws (required), doc (required), elem (required).

onshape_get_workspacesList workspacesA
Read-only

List a document's workspaces (branches).

Inputs: doc (required).

onshape_holeCut a holeA

Extrude a sketch as a cut (op=REMOVE). Sketch a circle first, then cut it through the body.

Inputs: ws (required), doc (required), elem (required), depth (required), +4 more.

onshape_insert_instanceInsert an instanceA

Insert a part, a whole Part Studio or another assembly into an assembly. Insert from a version when pulling from a different document.

Inputs: ws (required), doc (required), elem (required), src_elem (required), +6 more.

onshape_linear_patternLinear patternB

Repeat geometry along a direction, at a fixed spacing.

Inputs: ws (required), doc (required), elem (required), count (required), +8 more.

onshape_list_documentsList Onshape documentsA
Read-only

List documents visible to the signed-in user, most recently modified first.

Inputs: limit, filter, sort_by, sort_order.

onshape_list_versionsList document versionsA
Read-only

List the immutable versions of a document, newest first.

Inputs: doc (required).

onshape_loginSign in to OnshapeA

Sign in to Onshape by opening a browser. method='api_key' (default) opens a local page that links to the Onshape developer key page and accepts the pasted key pair. method='oauth' runs the OAuth 2.0 authorization-code flow against an app you registered in the Onshape developer portal. The credential is verified against Onshape and stored in the OS keychain. Returns immediately with status 'pending' if the user has not finished yet — poll with onshape_login_status.

Inputs: port, scope, store, method, +5 more.

onshape_login_statusCheck the pending Onshape loginA
Read-only

Wait for, and report on, the login started by onshape_login. Call this repeatedly while the user is in the browser; each call waits up to wait_seconds before returning.

Inputs: wait_seconds.

onshape_logoutForget stored Onshape credentialsA
DestructiveIdempotent

Delete the credential this server stored (keychain entry and config file). Credentials coming from environment variables or from an existing onshape-cli install are not touched.

Inputs: no named parameters.

onshape_mass_propertiesGet mass propertiesB
Read-only

Volume, mass, centroid and inertia for the Part Studio's bodies.

Inputs: ws (required), doc (required), elem (required), configuration.

onshape_measureMeasure the modelA
Read-only

Body count, overall bounding box in inches and total volume. Use this to check a model matches its intended dimensions before exporting.

Inputs: ws (required), doc (required), elem (required).

onshape_mirrorMirror geometryB

Mirror parts, bodies or faces across a plane.

Inputs: ws (required), doc (required), elem (required), entities (required), +5 more.

onshape_offset_planeCreate an offset planeA

Add a construction plane offset from a default plane, a face, or another plane.

Inputs: ws (required), doc (required), elem (required), name, +5 more.

onshape_requestCall any Onshape REST endpointA

Make an authenticated request to an arbitrary Onshape REST endpoint, for anything the dedicated tools do not cover. Paths start with /api/ and are documented at https://cad.onshape.com/glassworks/explorer. Prefer a dedicated tool when one exists — they normalise the response and validate the result.

Inputs: path (required), method (required), body, params.

onshape_revolveRevolve a sketchA

Revolve a sketch profile around an axis. With no axis given, the sketch's own construction line is used (see onshape_sketch_circle_axis); otherwise pass axis_ids or an axis query.

Inputs: ws (required), doc (required), elem (required), sketch (required), +7 more.

onshape_rollbackMove the rollback barA

Set the rollback index so features after it are suppressed. Index 0 rolls back to before the first feature.

Inputs: ws (required), doc (required), elem (required), index (required).

onshape_search_documentsSearch Onshape documentsA
Read-only

Find documents by name. Search before creating, so repeated runs do not make duplicates.

Inputs: query (required), limit.

onshape_set_api_keyStore an Onshape API key pairA

Store an Onshape access key and secret key directly, without a browser. Use when the user already has a key pair from https://cad.onshape.com/user/developer/apiKeys. The pair is verified against Onshape before it is saved.

Inputs: access_key (required), secret_key (required), store, base_url.

onshape_set_feature_studioWrite a Feature StudioA

Replace the FeatureScript source of a Feature Studio. The whole file is overwritten.

Inputs: ws (required), doc (required), elem (required), contents (required).

onshape_set_metadataSet element or part metadataA

Write properties such as part number, description or material. Only editable properties are accepted; read onshape_get_metadata first to find the property ids.

Inputs: ws (required), doc (required), elem (required), properties (required), +1 more.

onshape_set_variableSet a Part Studio variableA

Create or update a variable. Feature tools can then reference it by name (depth_variable, radius_variable, ...) so a dimension lives in one place. Uses the variable table where the account supports it and falls back to an assignVariable feature otherwise; result.route says which was used.

Inputs: ws (required), doc (required), elem (required), name (required), +3 more.

onshape_shaded_viewRender the modelA

Render the element server-side and return the image. Unlike a thumbnail this is generated on demand, so it always shows the current geometry — use it to check a model visually before exporting.

Inputs: ws (required), doc (required), elem (required), out, +7 more.

onshape_shellShell a bodyA

Hollow the body out to a wall thickness, removing the selected faces to open it.

Inputs: ws (required), doc (required), elem (required), name, +6 more.

onshape_sketch_candy_cane_pathSketch a hooked sweep pathA

Add a sketch of a straight stem joined to a hooked arc, approximated by segments — a ready-made path for onshape_sweep.

Inputs: ws (required), doc (required), elem (required), hook_radius (required), +8 more.

onshape_sketch_circleSketch a circleC

Add a sketch holding one circle.

Inputs: ws (required), doc (required), elem (required), center (required), +5 more.

onshape_sketch_circle_axisSketch a circle with a revolve axisB

Add a sketch with a circle profile and a construction line. onshape_revolve spins the profile around that construction line, which is how you get a torus or a ring.

Inputs: ws (required), doc (required), elem (required), center (required), +6 more.

onshape_sketch_lineSketch a lineA

Add a sketch holding one line segment. A line alone encloses no region, so it cannot be extruded.

Inputs: ws (required), doc (required), end (required), elem (required), +5 more.

onshape_sketch_rectangleSketch a rectangleB

Add a sketch holding one closed rectangle, ready to extrude. Corners are opposite, in inches.

Inputs: ws (required), doc (required), elem (required), corner1 (required), +5 more.

onshape_sweepSweep a profile along a pathA

Sweep the closed regions of one sketch along the edges of another.

Inputs: ws (required), doc (required), elem (required), path (required), +4 more.

onshape_thickenThicken a sketchC

Give a sketch region a wall thickness instead of a solid depth.

Inputs: ws (required), doc (required), elem (required), sketch (required), +7 more.

onshape_thumbnail_infoList thumbnail sizesB
Read-only

The thumbnail sizes Onshape has rendered for this element, with their hrefs.

Inputs: ws (required), doc (required), elem (required).

onshape_transform_instanceTransform instancesB

Apply a 4x4 row-major transform (16 numbers, metres) to the given occurrence paths.

Inputs: ws (required), doc (required), elem (required), paths (required), +2 more.

onshape_update_documentRename an Onshape documentC

Change a document's name or description.

Inputs: doc (required), name, description.

onshape_update_featureUpdate a featureA

Replace an existing feature's payload, e.g. to change a dimension. Post the whole feature JSON.

Inputs: ws (required), doc (required), elem (required), feature (required), +1 more.

onshape_validate_part_studioValidate a Part StudioA
Read-only

Count parts and bodies, and fail when the counts do not match the expectations you pass. A cheap regression check after a run of feature edits.

Inputs: ws (required), doc (required), elem (required), expect_parts, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 87 tools

    Disambiguation3/5

    Most tools target distinct resources or actions, but the large surface creates several near-overlaps: document summary vs. get_document/get_workspaces/get_elements, get_assembly vs. get_assembly_features, boolean vs. boolean_union, export vs. export_stl, and multiple feature-inspection tools. Descriptions usually clarify the intended use, but an agent must choose carefully among similar-looking options.

    Naming Consistency4/5

    All names use the onshape_ prefix and snake_case, with predictable verb_noun families such as get/create/update/delete/list/find/search. Minor deviations include noun-first names like onshape_mass_properties and onshape_assembly_mate/group, plus status/info tools, but overall the pattern is readable and consistent.

    Tool Count1/5

    With 87 tools, the surface is far larger than an agent can comfortably navigate and exceeds the rubric's 50+ extreme-mismatch threshold. Even accounting for Onshape's broad CAD/PDM domain, many read-only inspection, selection, and variant tools could be consolidated.

    Completeness4/5

    The set covers document lifecycle, workspaces/elements, Part Studios, sketches/features, assemblies, drawings, Feature Studios, metadata, exports, authentication, and an arbitrary REST escape hatch. Some collaboration, sharing, release, and comment operations are absent, but core CAD workflows are well covered.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      B
      quality
      B
      maintenance
      Enables programmatic CAD modeling with Onshape's REST API, offering 45 tools for parametric sketches, feature management, assemblies, analysis, variables, and exports.
      48
      166
      -
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to drive Onshape CAD with 87 tools for documents, part studios, sketching, solid features, assemblies, drawings, measurement, and export, including zero-configuration browser sign-in.
      93
      156 npm
      7
      MIT
    • F
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to draw, edit, inspect, and manage CAD drawings through a consistent API, either headlessly without a CAD installation or by driving a live Windows session. It supports documents, layers, entities, transforms, hatching, dimensions, blocks, architectural workflow tools, and optional previews.
      43
      -
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to control supported CAD applications through natural-language or direct tool calls for drawing, layer, block, entity, file, and data-export operations.
      -