SolidWorks MCP

Insert a bill-of-materials table for an assembly view on the active drawing.

Insert a part or sub-assembly into the active assembly. Call ``create_assembly`` first. Position is in millimetres from the assembly origin. **The component file must contain solid geometry** — SolidWorks silently refuses to insert an empty part, so a missing or empty component surfaces as an error rather than a fabricated success.

Bring the model's dimensions into the active drawing's views. Imports the model's "marked for drawing" dimensions view by view, each dimension shown once on the sheet (a repeat in a later view is deleted). Pictorial views (isometric, dimetric, trimetric) are skipped unless named. Falls back to SolidWorks AutoDimension only when nothing could be imported. SolidWorks places imported dimensions inside the views, so run ``arrange_dimensions`` afterwards.

List materials in the installed SolidWorks material libraries. Read-only; parses every ``.sldmat`` library SolidWorks is configured to use. Filter with ``search`` (name or classification substring, e.g. ``"steel"`` or ``"6061"``) and pass the exact ``name`` to ``set_material``.

List the top-level components of the active assembly.

List configuration names for the active SolidWorks document. Returns all available configuration names so callers can select a stable target before invoking feature or export operations.

List the views on the active drawing. Read-only. Use it to find an existing view's name before targeting it (e.g. with ``auto_center_marks``). Errors when the active document is not a drawing.

List feature-tree entries for the active SolidWorks document. Useful for read-before-write workflows where the agent must inspect existing model structure before adding or editing downstream features.

List every dimension in the active part or assembly with its full name. Read-only. Each entry's ``full_name`` (e.g. ``"D1@Sketch1"``) is the name ``set_dimension`` / ``get_dimension`` accept, so this is how to find and edit any driving dimension in an existing model. Pass ``feature_name`` to list one feature's dimensions only.

List every SolidWorks document that is currently open. Read-only — does not change which document is active. Use it to discover what is open (an assembly plus its parts, a drawing plus its model) before switching with ``activate_document``.

List available templates from the template library. This tool provides browsing and searching capabilities for the organization's template library.

Load (open) a SolidWorks assembly file. Convenience wrapper that opens a .sldasm file and makes it the active document. Provides a simpler alternative to open_model for assemblies.

Load (open) a SolidWorks part file. Convenience wrapper that opens a .sldprt file and makes it the active document. Provides a simpler alternative to open_model for parts.

List every indexed member (methods + properties) of a COM interface.

Look up one SolidWorks API method or property by interface + name. Confirms the member is indexed on that interface and returns its sibling members for context. The local index stores names only, so full signatures (parameters, return type) are not available here - use search_solidworks_api_help or help.solidworks.com for those.

Create or manage design tables for parametric modeling. Design tables allow you to create multiple configurations of a part or assembly by driving parameters from an Excel spreadsheet.

Read, update, copy, move, rename, or delete file-related properties. Uses the requested operation and file paths to manage SolidWorks file metadata or related file lifecycle tasks through the active adapter.

Measure faces, edges or vertices with SolidWorks' Measure tool. One face gives its area and perimeter; one edge its length (and radius and diameter for an arc); two entities give the distance and angle between them. Entity coordinates are in metres. Clears the selection afterwards.

Mirror solid bodies or features about a plane. Selects the named sources and the mirror plane, then mirrors them. The mirror is verified by comparing model volume before and after: SolidWorks can report a feature even when it mirrored nothing, so a volume that did not grow is reported as an error rather than a false success.

Open a SolidWorks model (part, assembly, or drawing). Opens an existing SolidWorks file and makes it the active document for further operations. Supports all standard SolidWorks file formats and provides detailed model information upon successful opening.

Optimize an existing macro for better performance and reliability. This tool analyzes and suggests improvements to existing macro code.

Optimize SolidWorks performance settings. This tool analyzes the current SolidWorks configuration and suggests or applies performance optimizations.

Copy a SolidWorks assembly and all its referenced parts to a self-contained folder. Enumerates every component referenced by the active assembly, copies the assembly and each part into ``target_dir``, then rewrites the stored component paths inside the copied assembly so it opens without any dependency on the original file locations — equivalent to the SolidWorks GUI Pack-and-Go operation.

Pattern features around an axis. Selects the named axis and features, then creates a circular pattern. The pattern is verified by comparing model volume before and after: SolidWorks can report a feature even when it patterned nothing, so a volume that did not grow is reported as an error rather than a false success.

Force a rebuild of the active model and report what is wrong. Use after programmatic edits (``set_dimension``, feature edits) to confirm the model rebuilds cleanly. When features fail, the response is an error whose ``data.errors`` names each failing feature with its SolidWorks error code, the features/sketches it depends on, and a concrete ``hint`` for fixing it. Warnings alone still succeed.

Rename a feature on the feature tree. SolidWorks silently refuses a rename onto a name another feature already uses, so the new name is read back and a mismatch is reported as an error rather than a quiet success. Renaming a feature to its current name is a no-op success.

Save the current model to a new location or format. Saves the currently active SolidWorks document with a new filename, location, or file format. Supports multiple export formats for interoperability with other CAD systems and manufacturing workflows.

Save the active SolidWorks assembly document. Convenience wrapper that saves the currently active assembly. If no file_path is provided, saves to the existing location. Otherwise, saves as a new file.

Extract one solid body from the active multibody part to a new file. Runs SolidWorks' Save Bodies on a single named body, writing a standalone part to ``file_path``. The body is matched by name against the active part's solid bodies; the response lists every solid body found, so an unknown name reports the real options. Success is confirmed by the file existing on disk afterwards.

Save the current SolidWorks model. Saves the currently active SolidWorks document to its existing file location. Essential for preserving work and maintaining document version control. Handles both modified and unmodified documents based on force_save setting.

Save the active SolidWorks part document. Convenience wrapper that saves the currently active part. If no file_path is provided, saves to the existing location. Otherwise, saves as a new file.

Save template to the organization's template library. This tool manages a centralized template library with categorization and version control.

Search SolidWorks API help index and return coherent guidance. This tool helps when the LLM gets stuck by mapping user intent to discovered COM members and practical MCP workflow guidance.

Select every edge of one face of the active part (multi-select). Identify the face with exactly one of ``point`` (a point on it, mm), ``side`` (``top``/``bottom``/``front``/``back``/``right``/``left`` or ``+X``..``-Z``; top=+Y, front=+Z, right=+X as in SolidWorks' default views - the furthest flat face facing that way) or ``plane`` (a reference plane name - the body face lying on it). ``edge_type`` narrows to ``linear`` or ``circular`` edges (e.g. hole rims). The edges become the live SolidWorks selection, so the next ``add_chamfer`` / ``add_fillet`` call with an empty ``edge_names`` acts on exactly them. Anything that changes the selection in between (including the user clicking in SolidWorks) changes what is used.

Select a named feature, sketch, plane or component. Replaces the current selection by default; pass ``append: true`` to add to it (e.g. to select several features in turn). A name that cannot be selected is an error, never a quiet success.

Create or overwrite one text custom property on the active document. Typical names: ``PartNo``, ``Description``, ``DrawnBy``, ``Revision``. The value is read back after writing, so success means it was stored.

Set the value of a dimension in the current model. This tool modifies the value of a named dimension and rebuilds the model. Use this to parametrically modify your model dimensions.

Assign a library material to the active part. The material drives mass properties (``get_mass_properties``) and what a title block's Material field shows. The name must match the library exactly; find it with ``list_available_materials``. The material is read back after assignment, so success means it really applied.

Set the active drawing sheet's scale; views using the sheet scale follow.

Set the active document's linear unit system. Accepts ``mm``, ``cm``, ``m``, ``in`` or ``ft`` (plus common aliases such as ``inch`` or ``millimeters``). The setting is applied and then read back from the document; if the readback disagrees the tool reports an error rather than a false success.

Create a circular pattern of sketch entities around the sketch origin. Generates a circular array of selected sketch entities. The rotation axis is always the **sketch origin** — SOLIDWORKS' ``CreateCircularSketchStepAndRepeat`` does not expose a pattern-centre parameter. Position the seed entity at the desired radius from the origin; the pattern derives its radius from the seed's centre. Essential for creating bolt circles, gear teeth, and other radially symmetric features around the sketch origin.

Create a linear pattern of sketch entities. Generates a linear array of selected sketch entities in specified direction(s) with defined spacing and count. Essential for creating hole patterns, vent grilles, and repetitive geometric features.

Mirror sketch entities about a centerline. Creates mirrored copies of selected sketch entities about a reference centerline, maintaining symmetrical design relationships. Essential for creating symmetric parts and reducing modeling time.

Create an offset of sketch entities. Generates offset copies of selected sketch entities at a specified distance, maintaining the original entity shape while creating parallel geometry. Essential for wall thickness, machining allowances, and clearance features.

Tutorial: Create a simple circular hole sketch. Demonstrates complete workflow for creating a basic hole sketch that can be used for through-holes, counterbores, or other circular features. This tutorial shows the fundamental sketch-to-feature process.

Start recording a SolidWorks macro. This tool initiates macro recording to capture user actions for later playback and automation.

Stop macro recording and save the recorded macro. This tool stops the active recording session and saves the generated macro code to a file.

Suppress or unsuppress a feature in the active model. Suppressing rolls a feature and its children out of the model without deleting it — the reversible way to turn off a feature that is causing trouble.

Create a simple hole as a guided tutorial workflow. Builds a sketch circle on the selected plane, exits the sketch, and creates a cut feature using the supplied diameter and depth. Useful as an end-to-end example of a basic subtractive feature.

Undo the last operations in the active model. SolidWorks accepts an undo with nothing left to undo without complaining, so the response reports whether the feature tree actually changed rather than assuming it did.