Switch which open document is the active one.

Matches the argument against open documents by title, full path, or file name (case-insensitive), calls ActivateDoc3, and reads the active document back to confirm the switch took.

Add an annotation such as a note, balloon, or surface symbol.

Places annotation text in a drawing with optional font size, leader attachment, and title-block style metadata fields.

Add an arc to the current sketch.

Creates a circular arc defined by center point, start point, and end point. Arcs are essential for creating rounded corners, curved transitions, and complex curved profiles in mechanical designs.

Add a centerline to the current sketch.

Creates a construction/reference line that serves as a centerline for symmetrical features, revolution axes, or construction geometry. Centerlines are non-geometric entities used for reference only.

Add a circle to the current sketch.

Add a dimension to the current drawing.

Creates dimensional annotations on drawing views including linear, radial, angular, and diameter dimensions. Essential for manufacturing specifications and quality control documentation.

Add, update, or remove a drawing view in an existing drawing.

Supports configuring the target drawing, view type, parent view, scale, and placement coordinates for common drawing view workflows.

Add an ellipse to the current sketch.

Creates an elliptical entity with specified center and major/minor axes. Ellipses are useful for creating oval holes, ergonomic profiles, and complex curved features in mechanical and industrial design.

Add a fillet (rounded edge) to selected edges of the current model.

Rounds the specified named edges with the given radius. Edge names use the SolidWorks convention, e.g. 'Edge<1>', or you can leave edge_names empty to fillet all edges if the adapter supports it.

Add a line to the current sketch.

Adds a line segment between two points in the active sketch. Lines are fundamental sketch entities used for creating profiles, construction geometry, and complex shapes.

Mate two components in the active assembly.

Positions components relative to one another — coincident planes to stack or align them, concentric to line up axes, distance to hold a gap.

Entities are selected by feature name, so only each component's reference planes and axes can be mated. Mating to a specific face or edge needs entity names this adapter cannot enumerate.

Add a note or annotation to the current drawing.

Creates text annotations, callouts, and notes on drawings for specifications, instructions, and additional manufacturing information. Essential for comprehensive technical documentation.

Add a regular polygon to the current sketch.

Creates a regular polygon with specified number of sides, center point, and circumscribed radius. Polygons are useful for creating hexagonal nuts, octagonal features, and other multi-sided geometric shapes.

Add a rectangle to the current sketch.

Creates a rectangular profile defined by two opposite corner points, automatically generating four connected line segments forming a closed rectangle suitable for extrusion or other 3D operations.

Add a geometric constraint/relation between sketch entities.

Creates geometric relationships between sketch entities such as parallel, perpendicular, tangent, coincident, etc. Essential for creating fully defined, parametric sketches that maintain design intent.

Add a dimension to sketch entities.

Creates dimensional constraints that control the size of sketch entities. Dimensions are essential for creating precise, parametric designs that can be easily modified and maintain manufacturing tolerances.

In live SolidWorks automation, sketch dimensions can otherwise trigger the interactive Modify approval dialog. The adapter suppresses the relevant sketch-input preferences for the automation session and uses the dedicated radial/diameter APIs for circles and arcs so this tool remains non-interactive.

Add a spline curve to the current sketch.

Creates a smooth, free-form spline curve that passes through or near the specified control points. Splines are ideal for creating organic shapes, complex profiles, and smooth transitions in industrial design.

Analyze drawing annotations and notes quality.

Handle analyze drawing comprehensive.

Analyze dimensions in a SolidWorks drawing for consistency and completeness.

This tool performs detailed dimensional analysis including precision, tolerances, and completeness checking.

Analyze drawing views arrangement and quality.

Handle analyze geometry.

This tool provides various geometry analysis capabilities like curvature analysis, draft analysis, thickness analysis, etc.

Analyze a macro for complexity, dependencies, and optimization opportunities.

This tool provides insights into macro structure and performance to help with optimization and maintenance.

Apply a template to an existing SolidWorks model.

This tool applies saved template settings including properties, dimensions, and formatting to the target model.

Auto-insert centre marks on circular features in a drawing view.

Runs SolidWorks' automatic centre-mark insertion for the named view. The API does not report how many marks it added, so the response gives the view's centre-mark count before and after and the delta. A run that added nothing is still a success — the view may have no un-marked holes.

Automatically dimension a drawing view.

Analyzes drawing view geometry and automatically adds common dimensions including overall sizes, hole diameters, radii, and critical features. Accelerates drawing completion and ensures comprehensive dimensioning coverage.

Start recording a macro in SolidWorks.

Begins macro recording to capture user actions and generate reusable automation scripts.

Stop recording the current macro.

This tool stops the active macro recording and saves the recorded actions as a VBA macro.

Apply template to multiple models in batch.

This tool processes multiple SolidWorks files and applies the same template configuration to all matching files.

Handle batch execute macros.

This tool allows running multiple macros in sequence or parallel for complex automated workflows.

Batch export multiple SolidWorks files to a target format.

Processes entire directories of SolidWorks files and converts them to specified target formats. Essential for project migrations, supplier deliverables, and large-scale format conversions.

Run a file operation across multiple files as a batch workflow.

Intended for repetitive file management tasks such as copying, moving, renaming, or deleting groups of SolidWorks documents.

Handle batch process files.

This tool processes multiple files in a directory, performing operations like rebuild, save as, export, or property updates.

Get mass properties of the current SolidWorks model.

Calculates and returns comprehensive mass properties for the active model including volume, surface area, mass, center of mass, and moments of inertia. Essential for engineering analysis, weight calculations, and structural design.

Check drawing compliance with company standards.

Check the current drawing against drafting standards.

Validates drawing compliance with industry drafting standards including ANSI Y14.5, ISO 128, and DIN standards. Identifies non-compliance issues and provides recommendations for improvement.

Check for interference between components in an assembly.

Analyzes specified components for geometric interference (overlapping volumes) and provides detailed interference detection results. Critical for assembly validation and identifying design conflicts before manufacturing.

Check whether a sketch is fully defined.

Classify the active model into a feature family from model-info and tree data.

This is a read-before-write helper for delegation. It summarizes whether the current document looks like a direct-MCP solid, sheet metal workflow, advanced VBA-backed part, assembly, drawing, or an insufficient-evidence case.

Close the current SolidWorks model.

Closes the currently active SolidWorks document with an option to save changes before closing. This is essential for proper model lifecycle management and preventing data loss.

Compare different versions of drawing files.

Compare two templates and generate difference report.

This tool analyzes differences between templates to help understand variations in formatting and properties.

Convert a SolidWorks file from one format to another.

Supports exporting source files to target formats such as STEP, IGES, STL, PDF, or other adapter-supported conversion outputs.

Create a new SolidWorks assembly document.

Creates a new SolidWorks assembly document using the default assembly template. The new assembly becomes the active document and is ready for component insertion, mating, and assembly-level operations.

Create a reference axis along a principal direction.

Builds an axis from the intersection of two built-in planes: x from Top + Front, y from Front + Right, z from Top + Right.

Cut material from the active model using the current sketch profile.

Creates a Cut-Extrude feature (Insert > Cut > Extrude) from the active sketch. Use this after exit_sketch when you want to remove material — e.g. to create windows, holes, slots, or any through/blind cut in an existing solid body.

Create a detail view of a specific area.

Generates magnified detail views of specific regions to show fine features, tight tolerances, and intricate geometry that requires enhanced visibility for manufacturing and inspection.

Create a new SolidWorks drawing document.

This tool creates a new drawing document using the default drawing template. The new drawing will become the active document.

Create a drawing view of a SolidWorks model.

Creates technical drawing views including orthographic projections, isometric views, section views, and detail views from 3D models. Essential for generating production drawings and technical documentation.

Create an extrusion feature from the active sketch.

Creates a 3D extrusion feature (boss or cut) from the currently active 2D sketch. Supports advanced options like draft angles, thin features, bidirectional extrusion, and various end conditions for professional modeling workflows.

Loft a solid between two or more profile sketches.

Creates a lofted boss/protrusion (Insert > Boss/Base > Loft) blending the listed profile sketches in order. Each profile must be a closed contour. Optional guide curves shape the transition between profiles.

Create a library of organized macros for team sharing and reuse.

This tool sets up a structured macro library with categorization, documentation, and version control.

Create a new SolidWorks part document.

Creates a new SolidWorks part document using the default part template. The new part becomes the active document and is ready for modeling operations such as sketch creation and feature addition.

Create a reference plane offset from an existing plane or planar face.

Adds a new plane to the feature tree, parallel to and offset from the named reference. The returned plane name can be passed straight to create_sketch to sketch anywhere other than the six built-in planes.

Angled planes are not supported by this tool: an angled plane needs a second reference (an axis or edge) to rotate about, which this signature cannot take. Use offset for parallel planes. An offset of zero is rejected — a plane coincident with its reference is not useful.

Create a reference point on the active part.

Two modes:

• along_curve — a point on the edge under (x, y, z) mm, placed distance mm from the edge start, or at percent (0–100) of its length. Give exactly one of distance / percent.

• face_center — a point at the centroid of the face under (x, y, z) mm.

The coordinate must lie on the target edge/face; SolidWorks resolves it with a coordinate pick. InsertReferencePoint always returns a feature, so success is confirmed by the feature tree growing.

Create a revolve feature from the active sketch.

Creates a 3D revolve feature by rotating the active 2D sketch profile around a specified axis of revolution. Supports full and partial revolves, thin features, and bidirectional revolution for comprehensive rotational modeling.

Create a section view of the current drawing.

Generates section views that show internal features by cutting through the part along a specified section line. Essential for revealing hidden geometry, internal structures, and complex assemblies.

Create a new sketch on the specified plane.

Creates a new sketch on a reference plane and enters sketch edit mode. This is the first step for creating any 2D geometry that will be used for 3D features like extrusions, revolves, or sweeps.

Sweep the active profile sketch along a named path sketch.

Creates a swept boss/protrusion (Insert > Boss/Base > Sweep). Requires two sketches in the active part: a closed profile sketch and an open path sketch named by path. The profile is inferred as the sketch that is not the path (in the usual "draw profile, draw path, sweep" flow this is unambiguous). Optionally applies a constant twist along the path.

Create a technical drawing from a SolidWorks part or assembly.

Supports selecting a template, output path, sheet format, scale, and optional auto- population of standard views for documentation.

Create a SolidWorks template file.

This tool creates templates for parts, assemblies, or drawings with standardized settings, materials, and configurations.

Delete a feature or sketch from the active model.

Deleting a parent feature also removes everything that depends on it — SolidWorks' normal cascade — so the response lists every feature that went, not just the one named.

Discover and index SolidWorks COM and VBA documentation.

Creates a searchable index of all available COM objects, methods, properties, and VBA libraries for the installed SolidWorks version. Useful for building context for intelligent MCP tool selection and documentation queries.

Handle execute macro.

This tool runs a previously recorded or written macro with optional parameters and repeat functionality.

Handle execute workflow.

This tool executes a series of automated steps in sequence, with support for parallel execution and error handling.

Exit sketch editing mode.

Exits the current sketch editing mode and returns to the 3D modeling environment. This is required after completing sketch geometry before creating 3D features like extrusions, revolves, or sweeps.

Returns: dict[str, Any]: A dictionary containing the resulting values.

Example: ```python # Complete sketch workflow await create_sketch({"plane": "Top"}) await add_circle({"center_x": 0, "center_y": 0, "radius": 5})

                result = await exit_sketch()
                if result["status"] == "success":
                    print("Sketch completed, ready for 3D operations")
                    # Now ready for extrude, revolve, etc.
                ```

            Note:
                - Must be called after sketch geometry creation
                - Required before executing 3D modeling operations
                - Automatically validates sketch geometry
                - Previous sketch remains selectable for feature creation

Export the current drawing to DWG format.

Converts SolidWorks drawings to DWG (Drawing) format, the native AutoCAD file format widely used in architecture, engineering, and construction industries for 2D technical drawings.

Export the current model to IGES format.

Exports SolidWorks models to IGES (Initial Graphics Exchange Specification) format, a legacy neutral CAD format still widely used for surface modeling and older CAD system compatibility.

Export images of the current model.

Captures high-quality rendered images of SolidWorks models from various view orientations for documentation, presentations, marketing materials, and web publication.

Export the current model or drawing to PDF format.

Creates PDF documents from SolidWorks drawings, assemblies, or parts for documentation, sharing, review, and archival purposes. Essential for design review and manufacturing documentation.

Export the current model to STEP format.

Exports SolidWorks models to STEP (Standard for the Exchange of Product Data) format, the preferred neutral CAD format for interoperability between different CAD systems and manufacturers.

Export the current model to STL format.

Exports SolidWorks models to STL (Stereolithography) format, the standard file format for 3D printing, rapid prototyping, and additive manufacturing applications.

Extract template from existing SolidWorks model.

Find API members related to a known interface or member name.

For an interface: its own members. For a member: the other members of every interface that also exposes it, plus name-substring matches.

Generate comprehensive drawing analysis report.

Generate VBA code for assembly component insertion.

Generate VBA code for assembly mate creation.

Generate VBA code for batch file export operations.

Generate VBA code for SolidWorks automation.

Analyzes operation description and generates appropriate VBA code with SolidWorks API calls, error handling, and documentation.

Generate VBA code for creating drawing dimensions.

Creates macro for various dimension types in drawings.

Generate VBA code for drawing view creation.

Generate VBA code for complex extrusion operations.

Generate VBA code for file management operations.

Generate VBA code using macro recording patterns.

Generate VBA code for complex part modeling operations.

Generate VBA code for complex revolve operations.

Get the value of a dimension from the current model.

Retrieves the current value of a named dimension from the active SolidWorks model. Dimensions can be from sketches, features, or global dimensions. Useful for parametric modeling and design validation.

Get properties of the current SolidWorks file.

Retrieves comprehensive metadata and properties of the currently active SolidWorks document. Provides essential file information for document management, version control, and project organization.

Returns: dict[str, Any]: A dictionary containing the resulting values.

Example: ```python result = await get_file_properties()

                if result["status"] == "success":
                    props = result["properties"]

                    # Basic file info
                    file_info = props["file_info"]
                    print(f"File: {file_info['file_name']}")
                    print(f"Size: {file_info['file_size']}")
                    print(f"Type: {file_info['file_type']}")

                    # Technical properties
                    tech = props["technical_properties"]
                    print(f"Material: {tech['material']}")
                    print(f"Units: {tech['units']}")

                    # Document info
                    doc = props["document_info"]
                    print(f"Author: {doc['author']}")
                    print(f"Description: {doc['description']}")
                ```

            Note:
                - Requires an active SolidWorks document
                - Properties may vary based on document type
                - Some properties may be empty if not set
                - Technical properties depend on document configuration

Backward-compatible alias for calculate_mass_properties.

Get material properties of the current model.

This tool retrieves the material properties assigned to the model including density, elastic modulus, yield strength, etc.

Returns: dict[str, Any]: A dictionary containing the resulting values.

Get metadata for the active SolidWorks document.

Returns a compact summary of the current model context that is useful for read-before- write LLM flows (document type, active configuration, and feature count).

Returns: dict[str, Any]: A dictionary containing the resulting values.

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.

List the top-level components of the active assembly.

Returns: dict[str, Any]: Status and the component instance names.

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.

Returns: dict[str, Any]: A dictionary containing the resulting values.

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 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.

Returns: dict[str, Any]: status and documents — a list of {title, path, type, is_active} entries, plus count.

Example: python await list_open_documents()

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.

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.

Rebuild the active SolidWorks document via ForceRebuild3.

Local SW2020 integration: expose the existing real COM adapter operation so MCP hosts can explicitly rebuild without a macro or UI.

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.

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.

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.

Returns: dict[str, Any]: A dictionary containing the resulting values.

Example: ```python # Learn basic sketching workflow result = await sketch_tutorial_simple_hole()

                if result["status"] == "success":
                    print("Tutorial completed successfully!")
                    print("Steps performed:")
                    for step in result["steps"]:
                        print(f"  - {step}")
                    print(f"Next: {result['next_steps']}")
                ```

            Workflow:
                1. Creates sketch on Top plane
                2. Adds 2.5mm radius circle at origin (5mm diameter hole)
                3. Exits sketch editing mode
                4. Returns sketch ready for extrusion or cutting operations

            Note:
                - Demonstrates complete sketch creation workflow
                - Creates standard 5mm diameter hole geometry
                - Result is ready for negative extrusion to create hole
                - Perfect starting point for learning SolidWorks automation

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.

Update the sheet format and title block information.

Applies drawing templates and updates title block fields with project information, revision data, and drawing metadata. Essential for standardized documentation and drawing control.

Update title block fields for the active drawing.

Applies drawing metadata such as title, drawing number, and approval fields to keep documentation aligned with standards.

Validate drawing completeness for production readiness.