Skip to main content
Glama
FullyDefined – AI for SOLIDWORKS

FullyDefined – AI for SOLIDWORKS

FullyDefined – AI for SOLIDWORKS

Tell your AI app what to build. It builds it in SOLIDWORKS, fully defined and measured, and you keep working on it like any part you made yourself.

FullyDefined – AI for SOLIDWORKS MCP server – quality and maintenance score on Glama

Download the installer · Examples · Practice results · All tools

Why FullyDefined

  • 121 tools. Parts, sheet metal, weldments, assemblies, drawings and export, from a first sketch to a drawing with a bill of materials.

  • Tested on official problems. Given only the drawing from SOLIDWORKS' own practice problems, the AI built 20 of 22 parts within 0.5% of the official answer. Both misses were sizes the drawing doesn't give, not a tool. All results are published.

  • Measured, not guessed. After each step the tools read the model back: volume, mass, distances, sketch status. If something is off, you see it.

  • Real CAD. Sketches are fully defined from your dimensions, and the feature tree is clean. You can edit everything afterwards.

  • One-click install. A normal Windows installer, with no admin rights and no Python or Git to set up. It tests itself by building and measuring a small part.

  • Your files are safe. A copy of your file is made before the first change. Your own files are never auto-saved, and folders you protect are never written to.

Related MCP server: solidworks-mcp

What it can do

  • Parts: lines, arcs, circles, rectangles, polygons and slots, fully defined; extrude, cut, revolve, sweep, loft, fillet, chamfer, shell, mirror, patterns, Hole Wizard holes, reference planes, surfaces, materials, equations and configurations.

  • Sheet metal: base, edge and miter flanges, tabs, hems, sketched bends, forming tools, flat pattern and DXF.

  • Weldments: structural members and their cut list.

  • Assemblies: add, move, fix, hide and replace components; add and edit mates; interference checks; exploded views.

  • Drawings: standard, section and detail views, dimensions, balloons, a bill of materials with your own columns, centrelines, title block and sheets.

  • Files: STEP, STL and PDF export, and custom properties.

Install

For Windows with SOLIDWORKS 2022 or later. Tested on SOLIDWORKS 2026.

  1. Download FullyDefined-Setup-<version>.exe from the latest release.

  2. Windows warns because the installer is not code-signed yet. Click More info, then Run anyway.

  3. Tick your AI apps and click Install. When it finishes, fully quit and reopen your AI app.

Zip install, other apps and settings: Help.

Try it

Open SOLIDWORKS and ask your AI app:

Create a new part, sketch a 40 mm circle on the Front plane, extrude it 10 mm and tell me its volume.

Or give it a drawing of a part and ask it to build it.

Works with

  • Tested: Claude Desktop and Claude Code, with Claude Opus and Claude Sonnet.

  • Installed and used: Antigravity.

  • Should work: Gemini CLI, VS Code with GitHub Copilot, and other apps that run local MCP servers.

ChatGPT can't use it: it only connects to servers on the internet, and FullyDefined runs next to SOLIDWORKS on your PC.

Help

Full requirements are on the Install page; limits, settings and other setups are on the Help page. Something not working, or a tool you want? Open an issue. What changed in each version is on the Releases page.

Licence

MIT. SOLIDWORKS is a registered trademark of Dassault Systèmes SolidWorks Corporation. This project is not affiliated with or endorsed by Dassault Systèmes or Anthropic.

Available Tools

121 tools
activate_sheetA

Make a sheet of the active drawing the active one, which is the sheet the other drawing tools (set_title_block, add_section_view, add_drawing_dimension and the rest) work on. Returns the sheet's size and views. An unknown name is refused and the active sheet stays as it was.

Inputs: name (required).

add_balloonsA

Add item balloons to a view of an assembly in the active drawing: one per component, numbered as in the bill of materials (add_bom_table). Default view: the isometric view, if there is one. SolidWorks balloons each item once per sheet, so a second view only gets balloons for items the first one did not show. Returns the item numbers.

Inputs: view, layout.

add_bom_columnA

Add a column to the drawing's bill of materials (add_bom_table) that shows a custom property of each item: property is its name, e.g. Material, PartNo or Description; title is the column heading (default: the property name; the result says so). Returns the table as it now reads, and lists the items whose cell is empty (their part has no such property: set_custom_properties on that part). For each part's material, give every part a Material property linked to it ('"SW-Material@"' with set_custom_properties: the file name only, e.g. '"SW-Material@Bracket.SLDPRT"', quotes included) and show that: SW-Material itself is refused, as SolidWorks shows it as '$PRP:...' in the table.

Inputs: property (required), title.

add_bom_tableA

Add a bill of materials table to a drawing of an assembly: item number, part name and quantity per component. With SOLIDWORKS' default table the columns are ITEM NO., PART NUMBER (the file name unless the part says otherwise, not a custom property) and QTY.; add_bom_column adds a property's own column. bom_type: top_level (default; a sub-assembly counts as one item), parts_only or indented. The table goes in the top right corner of the sheet unless x_sheet / y_sheet give its top right corner. Returns the table's rows.

Inputs: unit, view, x_sheet, y_sheet, +1 more.

add_centerlinesA

Add centrelines to a drawing view, or with no view to every view on the active sheet: SolidWorks puts one on every cylinder, cone and slot seen from the side that has none (a template can add them when the view is made). Returns how many were added and how many the view now has; SolidWorks gives no position for a centreline.

Inputs: view.

add_center_marksA

Add centre marks to a drawing view: every hole and round edge in it without one gets a single mark, sized by the drawing's drafting standard. Marks already there (a template can add them when the view is made) are left as they are. Returns each new mark's centre in view coordinates (mm, as list_drawing_views gives them) with the edges it marks.

Inputs: view (required).

add_componentA

Insert a saved part or sub-assembly file into the active assembly, with the centre of its bounding box at x, y, z. It can be rotated about that centre: rx, ry, rz in degrees (applied about the assembly X, then Y, then Z axis), or one turn given as axis plus angle. The first component inserted is fixed; later ones float until mated (add_mate). set_component_fixed changes that, and move_component repositions a floating one.

Inputs: x (required), y (required), z (required), filepath (required), +6 more.

add_detail_viewA

Add a detail view to the active drawing: a circle on an existing view, shown enlarged at its own scale. The circle's centre (x, y) and radius are in view coordinates (mm on the model; see list_drawing_views). scale is the detail's own scale, e.g. '2:1' or '5:1' (default: twice the scale of the source view). Without x_sheet / y_sheet it goes beside the view, or to the nearest free place on the sheet. Returns the new view's name, label and scale.

Inputs: x (required), y (required), view (required), radius (required), +5 more.

add_drawing_dimensionA

Add a dimension to a drawing view between two of its edges or points, chosen by the ids that list_drawing_views(view=...) reports (E3 = an edge, P2 = a point). Two parallel lines, two points, a point and a line, or a circle and a line or circle (measured from the centre) give a distance; two crossing lines give an angle. With only first: the length of a line, the diameter of a circle or the radius of an arc. direction forces a horizontal or vertical measurement. The dimension is a reference (driven) one: it shows the model's size and cannot change it. The same dimension again on the same entities is refused; one equal in size to a dimension already in the view is added with a warning naming it. Returns its name, value and place. Several dimensions in one view: give the others in more (one call); if any is refused, none of the call's dimensions stays.

Inputs: view (required), first (required), more, unit, +4 more.

add_mateA

Add a mate in the active assembly between two references. Simple form: point1 / point2 are points in ASSEMBLY coordinates that lie on the component faces to mate, or plane1 / plane2 name assembly planes. Full form: ref1 / ref2 can also pick a face by component and face id (list_component_faces), a sketch point or segment of a component (list_component_sketches), a part's own plane, axis or origin, and anything on a part inside a sub-assembly (component path like 'Door-1/Slat-3'). An edge or vertex: {component, edge_id} or {component, vertex_id}, ids from list_component_faces with include ['edges', 'vertices']. mate_type: coincident, concentric, parallel, perpendicular, tangent, distance (value = distance) or angle (value = degrees). A distance between a flat face and a cylinder is measured to the cylinder's AXIS, not its surface: for a gap of 0.5 to a disc of radius 20, give 20.5. A distance mate with minimum and maximum is a LIMIT mate: the distance may sit anywhere in that range, so another mate (the drive) can move the part only between the two ends; a value outside the range is refused. The result states what was picked on each side (component, face id, type, normal or axis), which components moved, and where to.

Inputs: mate_type (required), flip, ref1, ref2, +9 more.

add_section_viewA

Add a section view to the active drawing by cutting an existing view along a straight line. (x1, y1) and (x2, y2) are two points on the cutting line in view coordinates (mm on the model, from the model origin as seen in that view; see list_drawing_views); the cut runs the whole line, right across the view. A horizontal line puts the section below the view, a vertical one beside it, unless x_sheet / y_sheet (sheet mm) say otherwise; a default place that is taken or off the sheet moves to the nearest free place (along the alignment first, else anywhere, breaking the alignment). Returns the new view's name and label.

Inputs: x1 (required), x2 (required), y1 (required), y2 (required), +5 more.

add_sheetA

Add a sheet to the active drawing, after the last one, and make it active (activate: false keeps the current sheet active). A blank sheet has the size of the current sheet unless sheet_size is given, and has no views or title block. With copy_from {drawing, sheet} the sheet is copied, with its views, dimensions and annotations, from that sheet of an open drawing (drawing defaults to this one; open another drawing first with open_document). The copy keeps its source's size, so sheet_size cannot be combined with copy_from. After a copy the result says how many views and dimensions came across and lists every dangling dimension (not attached to the model) in dangling_dimensions. A name that is empty, already used, or contains any of / \ : * ? " < > | is refused and nothing changes. list_drawing_views shows the sheets; activate_sheet switches between them.

Inputs: name (required), activate, copy_from, sheet_size.

add_sketch_dimensionA

Add a driving dimension in the open sketch and optionally set its value. What gets measured follows from the entities: one line = length, circle = diameter, arc = radius, two points / a point and a line / two parallel lines = distance, two non-parallel lines = angle (degrees). The value must be greater than 0. A dimension that over-defines the sketch replaces a size the tools added from the drawing (named DrawnN; the result says which); one that conflicts with the user's own dimensions or relations, or that the sketch cannot satisfy, is rejected and not left in it, naming the conflicting dimensions. Several dimensions in one call: the others in more; if any is rejected, none of the call's stays. Returns the sketch's definition status. A value on a model with more than one configuration needs configurations: without it the call is refused, listing them.

Inputs: entities (required), more, unit, value, +2 more.

add_sketch_relationA

Add a geometric relation in the open sketch. Entities are given by id (drawing order; see list_sketch_entities): 3 for a whole entity, '3:start', '3:end' or '3:center' for one of its points, or 'origin'. A relation that contradicts a size the tools added from the drawing (named DrawnN) replaces it (the result says which); one that contradicts the user's own dimensions or relations is refused, naming them, and not left in the sketch. Under-defined geometry is free to move, so for 'symmetric' first define the centerline (dimensions or relations) if it must stay put. 'fix' is refused in a part sketch (dimension from the user's references instead) and allowed in an assembly sketch.

Inputs: entities (required), relation (required), unit.

arrange_dimensionsA

Spread the dimensions of a drawing view (or of every view) so they stop overlapping; use it after create_drawing(dimensions=true) or after adding dimensions. Returns where each dimension text ended up and any pairs still closer than 2 mm.

Inputs: unit, view, spacing.

capture_viewA

Capture a PNG of the active document's graphics view, to inspect the model visually: a standard view, or a camera direction with an up direction (the default up is +Y; for a Z-up model give up = {x:0, y:0, z:1}). A picture wider or taller than 1280 pixels is written to output_path only, not sent back. A section cut by a plane can be added for the capture only. To see detail, return only part of the picture: region (fractions from the top left) or zoom (1-20, on the centre). The screen is left as it was: the on-screen view is restored afterwards, whatever view or zoom_to_fit was used.

Inputs: up, unit, view, zoom, +11 more.

chamfer_edgesA

Add an angle-distance chamfer to the selected edges. Select first with select_edges. A distance too large for the edges is refused.

Inputs: distance (required), flip, unit, angle.

check_interferenceA

Run SolidWorks' interference check on the whole active assembly (parts inside sub-assemblies are checked one by one). Returns the number of interferences and, for each, the two components and the overlapping volume. Faces that merely touch are not counted unless treat_coincident_as_interference is true. Read-only.

Inputs: unit, treat_coincident_as_interference.

circular_patternA

Pattern one or more features around a model axis through the origin (x, y or z), or around the axis of a cylindrical face or circular edge (axis_point). count includes the original. Instances are spread evenly over 360 degrees by default; angle_between sets a fixed step instead.

Inputs: count (required), axis, flip, unit, +3 more.

clear_selectionA

Empty the current selection.

Inputs: no named parameters.

close_documentA

Close the current document. save = true saves it first, but a document that was never saved is refused then (save_document first, or close with save = false).

Inputs: save.

close_sketchA

Exit the open sketch, rebuilding the features made from it. Call it before an extrude if the sketch has not been closed yet. In a part, the drawn sizes of rectangles, circles, arcs and polygons become dimensions where still free (listed in the result), and anything still free is named by id: dimension it from the references the user named before the feature, which refuses a sketch that is not fully defined.

Inputs: no named parameters.

connect_solidworksB

Attach to the running SolidWorks, or start it first when none is running.

Inputs: no named parameters.

convert_to_sheet_metalA

Turn the solid body of a part into sheet metal with SolidWorks' Convert to Sheet Metal: give fixed_face (a point on the face that stays fixed), bend_edges (a point on each edge that becomes a bend) and thickness; SolidWorks adds the rips itself. The result is checked by measuring the flat pattern (one piece), and what was made is removed again when that fails. Returns thickness, bend radius, K-factor and flat pattern size. Insert Bends on a shelled part is not offered.

Inputs: fixed_face (required), flip, unit, method, +4 more.

copy_fileA

Copy a file to a new path, keeping the extension. Refused when the target exists (unless overwrite), when the source is open with unsaved changes, when the target is open, and for protected folders. Files that reference the source keep pointing at the source.

Inputs: source (required), target (required), overwrite.

create_drawingA

Create a drawing of a saved part or assembly: front, top and side views, optionally an isometric view and the model's dimensions. The scale is chosen automatically unless given. end_view picks which end of the model the side view shows; spread (on by default) spaces the views evenly over the sheet. Save it with save_document (a .SLDDRW path keeps the drawing) and export it with export_pdf; list_drawing_views shows what is on the sheet. For a model whose 'up' is +Z give front_direction {x:0, y:-1, z:0} and up {x:0, y:0, z:1}: the other views are projected from the main one, the isometric view gets the same 'up', and the automatic scale fits the views on the sheet. The model file is not changed.

Inputs: projection (required), up, scale, spread, +6 more.

create_exploded_viewA

Make a new exploded view of the active assembly's configuration: steps move components along the assembly axes (direction +x, -x, +y, -y, +z or -z; distance required). Components are named as in list_components (a path such as Sub-1/Part-1 for a part in a sub-assembly). The view is left shown exploded (show_exploded collapses it); while it is shown, mates, measurements, check_interference and export_stl see the exploded positions, so collapse it first. Mates are not changed. Returns the view's name and each component's measured move per step.

Inputs: steps (required), unit.

create_new_assemblyA

Create an empty assembly from the default template and make it the active document; the result names the template's units and standard.

Inputs: no named parameters.

create_new_partA

Create an empty part from the default template and make it the active document; the result names the template's units and standard.

Inputs: no named parameters.

create_offset_planeA

Create a reference plane parallel to a plane or to a flat face of the body, at a given distance. Returns the new plane's name, to use with create_sketch.

Inputs: distance (required), flip, unit, face_x, +3 more.

create_sketchA

Start a sketch on one of the model's planes: Front, Top, Right (the standard planes, in any language), or another plane by name (for example 'Plane1' made by create_offset_plane). Refused while another sketch is open.

Inputs: plane.

create_sketch_on_faceA

Start a sketch on the flat body face that contains a given 3D model point (found by geometry, so the current view does not matter). The point must lie inside the face, not on an edge. The result gives the sketch origin and axis directions in model space and the point in sketch coordinates, which you need to place geometry.

Inputs: x (required), y (required), z (required), unit.

cut_extrudeA

Cut the most recent sketch through the body to remove material. Reports the volume removed. If the requested direction removes nothing (for example a sketch lying beside the body), the other direction is used and the result says so. A sketch that already belongs to a feature is not cut again: draw a new sketch first.

Inputs: flip, unit, depth, through_all, +2 more.

delete_componentA

Delete a top-level component from the active assembly. SolidWorks deletes the mates that use it with it; the result lists them (name and type), the components left, and any other mate that now has an error. A component inside a sub-assembly is refused (it belongs to the sub-assembly's file), as is an instance of a component pattern.

Inputs: component (required).

delete_drawing_dimensionA

Delete a dimension from a drawing view by the name list_drawing_views(view=...) gives, e.g. RD1. Only the drawing changes; the model dimension stays in the part.

Inputs: view (required), dimension (required).

delete_equationA

Delete an equation or global variable by name or index (see list_equations) and rebuild. A global variable that other equations use is refused.

Inputs: name, index.

delete_featureA

Delete a feature, sketch or plane by name; in an assembly also a mate by name. Refused when other features depend on it unless delete_children is true. Reports everything that was removed.

Inputs: name (required), delete_sketch, delete_children.

delete_mateA

Delete a mate by name (delete_feature also finds mates). Reports the mates that remain.

Inputs: name (required).

draw_arcA

Add an arc to the open sketch from its centre, radius and start / end angles (degrees), counter-clockwise from start to end. Equal angles are refused: use draw_circle for a full circle. In a part its radius becomes a dimension when the sketch is closed, unless set first.

Inputs: cx (required), cy (required), radius (required), end_angle (required), +2 more.

draw_centerlineA

Add a centerline (a construction line) to the open sketch. It is the axis for revolve_sketch and the mirror line of a 'symmetric' relation.

Inputs: x1 (required), x2 (required), y1 (required), y2 (required), +1 more.

draw_circleA

Add a circle to the open sketch, given its centre (x, y) and radius. In a part its diameter becomes a dimension when the sketch is closed, unless set first.

Inputs: x (required), y (required), radius (required), unit.

draw_lineA

Add a line to the open sketch at exactly the coordinates given: no snapping and no automatic relations. Lines that share an endpoint are joined. In a part, a line that touches nothing when the sketch is closed gets its length as a dimension (a line in a chain does not). Returns the id of the new entity.

Inputs: x1 (required), x2 (required), y1 (required), y2 (required), +1 more.

draw_pointA

Add a sketch point at x, y in the open sketch. A point is reference geometry: an extrude ignores it. In an assembly it can be mated to or measured from; list_component_sketches gives its id. list_sketch_entities shows such points under 'points'.

Inputs: x (required), y (required), unit.

draw_polygonA

Add a regular polygon whose corners lie on a circle of the given radius; the first corner is at angle 0. It is made of lines tied to a construction circle, so dimension that circle to resize the polygon; in a part that diameter becomes a dimension when the sketch is closed, unless set first. Returns line_ids (the sides, in order) and circle_id, the ids list_sketch_entities shows.

Inputs: cx (required), cy (required), sides (required), radius (required), +1 more.

draw_polylineA

Add a chain of lines through the points given, in one call (instead of one draw_line per side): each point joins the next, and closed: true also joins the last to the first, so an outline such as an L profile is one call. Exact coordinates, no snapping; lines along x or y get horizontal / vertical relations. In a part, a two-point polyline (one line) that touches nothing when the sketch is closed gets its length as a dimension, as with draw_line. Returns the new entity ids in order.

Inputs: points (required), unit, closed.

draw_rectangleA

Add a rectangle in the open sketch between opposite corners (x1, y1) and (x2, y2). Horizontal and vertical relations are normally added to its sides; list_sketch_entities shows them. In a part its width and height become dimensions when the sketch is closed, unless set first.

Inputs: x1 (required), x2 (required), y1 (required), y2 (required), +1 more.

draw_slotA

Add a straight slot to the open sketch: two half circles joined by two lines, around a construction centreline. x, y is the slot's centre, centre_distance the distance between the two arc centres, width the slot's width (twice the end radius), angle its direction from +X (0 = horizontal, the default; the result says so). At 0 or 90 degrees it is horizontal or vertical by a relation; centred on the origin it is tied there. In a part its centre distance and end radius (width / 2) become dimensions when the sketch is closed, unless set first: a slot on the origin is then fully defined. At any other angle it also gets a horizontal construction line, and its angle becomes a dimension from that line on closing. Returns the ids of its entities.

Inputs: x (required), y (required), width (required), centre_distance (required), +2 more.

edge_flangeA

Add an edge flange (a wall bent up) on the sheet metal edge through a point, with its length measured to the outer virtual sharp. position: inside (outer face on the edge), outside (inner face on the edge) or bend_outside (bend outside the edge). Returns the volume added, the flat size and what defining its profile sketch added (added_by_solidworks, relations_added: SolidWorks', not from your spec). Refused while flattened.

Inputs: edge (required), length (required), unit, angle, +2 more.

edit_mateA

Change an existing mate: value for a new distance or angle, flip_dimension to put the distance / angle on the other side, flip_alignment to swap aligned and anti-aligned (or alignment to set it directly). The assembly is rebuilt; a change the other mates do not allow is undone and refused. Reports the mate as read back and which components moved.

Inputs: name (required), unit, value, maximum, +4 more.

edit_sketchA

Reopen an existing sketch (for example 'Sketch1') for editing. The draw tools, add_sketch_relation and add_sketch_dimension then act on it, and close_sketch rebuilds the features made from it. Refused while another sketch is open.

Inputs: sketch (required).

export_flat_pattern_dxfA

Export the active sheet metal part's flat pattern as a DXF: outline and holes on layer 0, bend lines and bend notes (text) on their own layer BEND (so a cutting program can leave them out); layer 0 holds only what is cut. Forming tools are not drawn (a dimple leaves only the outline). The file is in the document's length unit (inches from an inch template; the file's $INSUNITS says which) unless dxf_unit asks for mm or inch: then the document's unit is switched for the export and put back. The part must be saved, and an existing file needs overwrite. Returns path, bytes, flat size, dxf_unit (the unit of the file's coordinates), bend_lines and bend_notes (how many are on layer BEND). SolidWorks marks the part modified.

Inputs: filepath (required), unit, dxf_unit, overwrite.

export_pdfA

Export the active drawing as a PDF. The drawing itself is not saved, renamed or changed. Without filepath the PDF is written next to the saved drawing under the same name. Reports the file size.

Inputs: filepath.

export_stepA

Export the active part or assembly as a STEP file (.step / .stp) for other CAD programs. protocol AP214 (the default) keeps colours; AP203 does not. The document is not saved, renamed or changed. Reports the file size and how many solid bodies and components the file holds.

Inputs: filepath (required), protocol.

export_stlA

Export the active part or assembly as an STL file (.stl) for 3D printing or meshing: one file, in the model's own coordinates. resolution: fine (the default), coarse, or custom with deviation and angle. file_unit is the unit the file's numbers are in (STL files carry none): the document's length unit by default, or mm if that is not mm, cm, m, inch or ft. The document is not saved, renamed or changed, and SolidWorks' STL settings are put back afterwards. Reports the triangles and the file's bounding box in mm next to the model's. An STL file carries no unit: tell the user the file_unit the result names.

Inputs: filepath (required), unit, angle, format, +3 more.

extrude_sketchA

Extrude the most recent sketch as a boss (Boss-Extrude). New material merges into the body it touches; the result warns if it made a separate body instead, which usually means the wrong direction. A sketch that already belongs to a feature is not extruded again: draw a new sketch first.

Inputs: flip, unit, depth, merge, +2 more.

extrude_surfaceA

Extrude the most recent sketch into a surface (Surface-Extrude). The sketch may be an open profile; construction geometry is ignored. Each sketch entity gives one face, so a sketch holding a single fit spline gives a single face. In an assembly the surface's faces are listed by list_component_faces (marked body = surface) and work in add_mate and measure_distance like any face.

Inputs: flip, unit, depth, end_condition.

fillet_edgesA

Add a constant-radius fillet to the selected edges (or to all edges of the selected faces). Select first with select_edges / select_faces. A radius too large for the edges is refused.

Inputs: radius (required), unit.

fit_splineA

In the open sketch, replace a chain of lines and arcs with ONE spline that follows them within a tolerance (default 0.001 mm). The entities must form one connected chain; they stay as construction geometry. Use it before extrude_surface when a track has to be a single face that points can be mated to along its whole length.

Inputs: unit, tolerance.

flattenA

Show the flat pattern of the active sheet metal part (unsuppress it). Returns the flat size, largest first. The document is marked modified. unflatten folds it up again.

Inputs: unit.

forming_toolA

Press a forming tool from the installed design library (e.g. dimple, louvers/louver, lances/...) into a flat face of a sheet metal part at a point. It pushes away from that face; flip presses from the other side, toward it. rotation turns it on the face. An unknown name is refused with the list. Returns the feature and its height. Refused while flattened.

Inputs: tool (required), point (required), flip, unit, +1 more.

fully_define_sketchA

Last resort, after the user's own dimensions: fully define the open sketch of a part, adding the dimensions and relations it still lacks, measured from the origin (baseline dimensions), with neutral relations only (horizontal, vertical, coincident, tangent; never equal, parallel, symmetric or midpoint). Add the user's own sizes first with add_sketch_dimension; this fills in the rest, mostly positions. Nothing moves. Returns the dimensions added (names and values; report them to the user as "added by SolidWorks, not from your spec"), how many relations were added, the sketch status and anything still free (construction geometry, such as fit_spline's helper lines, does not count, except a mirror line). Refused with no sketch open and on an over-defined sketch.

Inputs: no named parameters.

get_colorA

Read the colour (rgb 0 to 255) and transparency of the active part, or of components of the active assembly (all parts when none are named). For a component it also says whether the colour is set in the assembly or comes from the part file. Read-only.

Inputs: component, components.

get_cut_listA

Read the cut list of the active weldment part: for each item its name, quantity, length (measured along each member, tip to tip), description (profile), material and end angles.. After butt corners (structural_member butt1 / butt2: SolidWorks' pinwheel) every member is exactly as long as its path, with square ends. Read-only.

Inputs: unit.

get_document_infoA

Report the active document's title, file path ('Not saved' when it has none) and type.

Inputs: no named parameters.

get_sheet_metal_infoA

Read the active part's sheet metal settings (read only): thickness, default bend radius, K-factor, the bends (inside radius, angle in degrees and width of each), flat pattern size (bounding box, largest first), number of flat pieces, and whether the part is flattened now. A part with no unsaved changes is measured on a temporary copy, so the document is untouched and stays unmodified (measured_on = copy); an already modified part is measured in place, the flat pattern shown (or hidden) for a moment and then put back exactly as it was (measured_on = document). Refused on a part that is not sheet metal, and on assemblies and drawings.

Inputs: unit.

get_sketch_statusA

Report the sketch state: whether a sketch is open, how many sketches there are and their names in the feature tree.

Inputs: no named parameters.

get_solidworks_infoA

Report the SolidWorks installation, the server's version, the settings and log file it uses, and any tool modules that failed to load.

Inputs: no named parameters.

hemA

Fold a sheet metal edge back on itself (a hem), inside the old edge: closed, open (with a gap) or teardrop (angle, default 200 degrees; radius, default the part's). length is the folded-back leg of a closed or open hem (a teardrop has none). Returns the volume added. Refused while flattened.

Inputs: edge (required), type (required), gap, unit, +3 more.

hole_wizardA

Make a standard ISO Hole Wizard hole at a model point on a flat face. hole_type: 'simple' (drilled; size = standard ISO drill diameter in mm; with a unit other than mm write it '6.5mm'), 'counterbore' (socket head cap screw; size like 'M6'), 'countersink' (countersunk socket screw; size like 'M6') or 'tapped' (size like 'M6'; with depth, depth is the tap drill depth and the thread is 1 x the thread diameter deep). Leave depth out for a through hole. Several holes of the same type and size on one flat face: give points instead of x, y, z; they become one Hole Wizard feature (one call, one feature). The positions are dimensioned from the edges named in dimension_from (the user's references; one call per group of holes sharing their edges); what no named edge covers is dimensioned from the origin and listed in dimensions_from_origin (not from your spec); an edge dimension that could not be made is listed in edge_dimensions_missing with a warning.

Inputs: size (required), x, y, z, +5 more.

linear_patternB

Pattern one or more features along the model axes, in one direction or two (a grid). count includes the original. Warns if new instances fall outside the body.

Inputs: count (required), spacing (required), direction (required), unit, +4 more.

list_component_facesA

List the faces of one component of the active assembly: id, type (plane / cylinder / other), area, a point on the face, and the normal or the axis and radius, all in ASSEMBLY coordinates. The id is the face_id that add_mate and measure_distance take, for when picking a face by point is ambiguous. Works on a part inside a sub-assembly (component path). Read-only.

Inputs: component (required), unit, include, face_type.

list_componentsA

List the top-level components of the active assembly: name, file, fixed or floating, rigid or flexible for a sub-assembly, the position of the origin (and axes, if rotated) in the assembly, bounding box, and mates. A part inside a sub-assembly is addressed as 'Sub-1/Part-2'.

Inputs: unit.

list_component_sketchesA

List the sketches of one component of the active assembly. Given a sketch name, list that sketch's points and segments (line / arc / circle with start, end, centre, radius) in ASSEMBLY coordinates. The ids are the point_id / segment_id that add_mate and measure_distance take. They follow SolidWorks' order for a finished sketch, which is NOT the ids list_sketch_entities gave while drawing. Each point has an 'of' field saying what it is: ['2:center'] is the centre of circle or arc 2, ['1:end', '3:start'] a corner shared by two segments, [] a point made with draw_point. Read-only.

Inputs: component (required), unit, sketch.

list_custom_propertiesA

List the custom properties of the active document: name, value as typed, resolved value (a linked value such as '"SW-Mass@Bracket.SLDPRT"' shows its result) and type. The file's own properties unless configuration names one of its configurations. Read-only.

Inputs: configuration.

list_dimensionsA

List the model's dimensions by feature, with the names set_dimension uses (D1@Sketch1 for a sketch dimension, D1@Boss-Extrude1 for an extrude depth, for example). A dimension an equation drives shows that equation: change it with set_equation.

Inputs: unit, feature.

list_drawing_viewsA

List the views of the active drawing: name, type, scale, place on the sheet and number of dimensions. Given a view name it also lists that view's visible edges (E1, E2, ...), points (P1, P2, ...) and dimensions. Those ids are what add_drawing_dimension takes, and the coordinates are what add_section_view and add_detail_view take. The coordinates are VIEW COORDINATES: mm on the model, x to the right and y up on the sheet, measured from where the model origin appears in that view, independent of the view's scale and position. It also lists the sheets (name, size, views, dimensions, which is active). Changes nothing.

Inputs: view.

list_edgesA

List the edges of the solid body: id, type (line / circle / arc), length, end points, midpoint, and radius / centre for round edges. Filters are optional. Ids hold only until the geometry changes: select_edges refuses them after a change (list again). By default one short text line per item (fewer tokens); compact: false gives an object per item.

Inputs: unit, compact, edge_type, parallel_to.

list_equationsB

List the equations and global variables: index, text, name, expression, value (in the document's units) and comment.

Inputs: no named parameters.

list_facesA

List the faces of the solid body: id, type (plane / cylinder / other), area, outward normal, bounding box and a point on each face. Ids hold only until the geometry changes: select_faces refuses them after a change (list again). By default one short text line per item (fewer tokens); compact: false gives an object per item.

Inputs: unit, compact.

list_featuresB

List the features of the active model as the feature tree shows them.

Inputs: no named parameters.

list_materialsA

List materials from the SolidWorks material databases. With no input it returns the categories; give search (part of a name, e.g. '6061', 'ABS') or category (e.g. 'Steel', 'Plastics') to get material names and densities.

Inputs: search, category.

list_matesA

List every mate of the active assembly: name, type, value (distance or angle), the two components, what was picked on each (plane, cylinder, point, line), alignment, whether the dimension is flipped, whether it is suppressed, and its error state after the last rebuild. A limit mate has type limit_distance with its minimum and maximum. Read-only.

Inputs: unit.

list_open_documentsA

List every document that is open in SolidWorks: title, type, path (empty when never saved) and unsaved_changes (true when it was never saved or has changed since its last save; the result names those).

Inputs: no named parameters.

list_sketch_entitiesA

List the open sketch's entities (ids, coordinates, sizes), dimensions, relation count and definition status (under_defined / fully_defined / over_defined). The ids are what add_sketch_relation and add_sketch_dimension take. They follow drawing order (1 = the first entity drawn; a rectangle is 4 entities) and stay the same when more geometry is added. Every line, arc and spline also gets start_joins / end_joins: the ends of other entities at the same place, as 'id:start' / 'id:end'. open_ends lists the ends that touch nothing (construction geometry does not count), so an empty open_ends means every contour is closed.

Inputs: unit.

loftA

Loft a solid through two or more closed profile sketches on different planes, in the order given. By default the last two sketches are used. With cut=true the lofted volume is removed from the body instead (refused when the part has no solid body or the cut removes nothing).

Inputs: cut, merge, profiles.

measure_distanceA

Measure between two model points, or between the two faces or edges at those points. For faces and edges it returns the minimum distance, the normal distance when they are parallel, and the angle when they are not. In an assembly, measure between two references ref1 / ref2, picked as in add_mate, including edges and vertices by edge_id / vertex_id from list_component_faces with include (also on parts inside sub-assemblies): the result has the minimum distance, for two flat faces the angle between them and the gap when parallel, and for two cylinders the axis-to-axis distance. distance is always the MINIMUM (to a small face this can be to its edge); normal_distance is the PERPENDICULAR distance to the plane (parallel faces, or a point and a flat face). Read-only.

Inputs: ref1, ref2, unit, point1, +3 more.

measure_partA

Measure the part: bounding box (min and max corners along the model axes), overall size, volume, surface area, mass, density, centre of mass and number of solid bodies. Read-only.

Inputs: unit.

mirror_featureB

Mirror one or more features about a plane (Front, Top, Right or any plane by name) or about a flat body face. Warns if the mirrored copy has no effect.

Inputs: plane (required), unit, face_x, face_y, +2 more.

miter_flangeA

Add a miter flange: an open profile sketch (lines and arcs on a plane across a sheet edge, starting at that edge) swept along a chain of edges, mitred at the corners. edges: a point on each edge of the chain (default: the one edge the profile starts on). Returns the feature and the volume added. Refused while flattened.

Inputs: sketch (required), gap, unit, edges, +1 more.

move_componentA

Move a floating top-level component to a position and orientation in the assembly. x, y, z are where its ORIGIN goes, in assembly coordinates (an omitted one stays). Orientation: rx, ry, rz in degrees applied about the assembly X, then Y, then Z axis starting from axes parallel to the assembly's, or one turn of angle degrees about axis. With relative = true, both are a shift from the current pose, about the component's own origin. Mates still apply: the result says where the component ended up and whether that is where it was put. A fixed component is refused.

Inputs: component (required), x, y, z, +7 more.

move_drawing_viewA

Move a drawing view so that its outline centre (see list_drawing_views) lands at x_sheet, y_sheet (mm from the lower left corner). Projected views follow. A view aligned to its parent moves only along that alignment unless keep_alignment is false, which breaks it. Refused if a moved view would leave the sheet. Warns, naming them, when the moved view now overlaps other views.

Inputs: view (required), x_sheet (required), y_sheet (required), unit, +1 more.

open_documentA

Open a SolidWorks file and make it the active document. A file that is already loaded (in the background, or only as a component of an open assembly) is brought to the front instead. The result names the active document; it is an error if the file could not be made active.

Inputs: filepath (required).

replace_componentA

Replace a top-level component of the active assembly by another part or assembly file. SolidWorks keeps the component's place and re-attaches the mates it can; nothing is fixed silently: the result lists every mate as kept, broken (with its error) or gone, and the new component's name and position. all_instances (default false) replaces every instance of the same file; configuration is the new file's configuration (default its active one; the result says which). A file named like one already in use (another folder) is refused: SolidWorks cannot load both, so copy_file it to a new name first.

Inputs: filepath (required), component (required), all_instances, configuration.

revolve_sketchA

Revolve the most recent sketch about a centerline drawn in that sketch (draw_centerline). The profile must be closed and lie on one side of the centerline. cut=true makes a revolved cut.

Inputs: cut, axis, flip, angle, +1 more.

save_documentA

Save the current document. With filepath it is saved under that name and the extension chooses the format: .SLDPRT / .SLDASM / .SLDDRW keep the document, while .pdf, .step, .stl, .dxf and the like export a copy; without filepath it saves in place. Saving a drawing or assembly that has open referenced files with unsaved changes is refused (naming them) unless save_referenced is true, and a Save As onto an existing file (other than the document's own) is refused unless overwrite is true. A refusal saves nothing.

Inputs: filepath, overwrite, save_referenced.

select_edgesA

Select body edges by geometry (the view does not matter), ready for fillet_edges / chamfer_edges. Choose by points (the edge nearest each point), face_points (one point = every edge bordering that face; two points = the edge the two faces share) or edge_ids from list_edges (refused if the geometry changed since it listed them; points are safer). With none of these, a filter alone selects from all edges. The filters edge_type, parallel_to and loop narrow the choice.

Inputs: loop, unit, append, points, +5 more.

select_facesA

Select body faces by geometry (the view does not matter): by points (the face containing each point), face_ids from list_faces (refused if the geometry changed since it listed them), or normal (every flat face facing +x, -x, +y, -y, +z or -z).

Inputs: unit, append, normal, points, +2 more.

set_colorA

Set the colour of the active part, or of components of the active assembly. On a part the colour is stored in the part, so every assembly using it shows it (save the part to keep it). On an assembly, give components (names, or paths into sub-assemblies such as 'Door-1/Slat-3'; a list does several at once): the colour is stored in the assembly and the part files stay unchanged. Colour as a name (red, green, blue, yellow, orange, purple, cyan, magenta, pink, brown, white, black, grey, light_grey, dark_grey, silver, gold), hex '#rrggbb', or rgb [r, g, b] with 0 to 255 each; transparency from 0 (solid) to 1 is optional. Reports the colour read back for each target.

Inputs: rgb, color, component, components, +1 more.

set_component_fixedA

Fix a top-level component of the active assembly where it is, or release it (fixed = false). Mates and move_component cannot move a fixed component. The state read back is reported; list_components shows it as 'fixed'.

Inputs: component (required), fixed.

set_component_visibilityA

Hide or show components of the active assembly (visible = false hides). Hiding only stops the drawing: the component's mates still hold, it still counts in check_interference and it can still be mated to. A part inside a sub-assembly is addressed by path ('Door-1/Slat-3'), and a list changes several components in one call. list_components marks hidden ones with 'hidden': true.

Inputs: visible, component, components.

set_custom_propertiesA

Set or delete custom properties of the active document (part, assembly or drawing): properties gives name -> text (a number is written as its text; the result says so), delete lists names to remove. They go on the file itself unless configuration names one of its configurations. A value can link to another property, e.g. '"SW-Mass@Bracket.SLDPRT"'. Every property touched is read back: value as typed and resolved value. Nothing changes if any input is refused.

Inputs: delete, properties, configuration.

set_dimensionA

Change a dimension by name and rebuild the model. Works on sketch dimensions and feature dimensions (depths, pattern spacing, fillet radius, ...). If the new value breaks a feature on rebuild, the old value is restored and the call fails. A size the tools dimensioned from the drawing (DrawnN) becomes the user's when set: it is renamed (the result says to what). A dimension an equation drives is refused, naming the equation (change it with set_equation). With more than one configuration, configurations is required: without it the call is refused, listing them.

Inputs: name (required), value (required), unit, configurations.

set_dimension_precisionA

Set how many decimals drawing dimensions show: one dimension by its name (list_drawing_views(view=...)), or every dimension in a view. tolerance_decimals sets the decimals of their tolerances too (default: left as they are). Only the display changes, not the model's values; dimensions added later keep the template's decimals, so call it last. Each dimension's precision is read back.

Inputs: decimals (required), view, dimension, tolerance_decimals.

set_dimension_styleB

Change how a drawing dimension looks: kind shows a round dimension as a radius or a diameter; text_color sets its text colour as {r, g, b} (0-255). The dimension is found by name among the views of the active sheet (list_drawing_views).

Inputs: dimension (required), kind, text_color.

set_equationA

Set an equation and rebuild. name is a global variable ('Wall'; created when new) or a dimension ('D1@Sketch1'); alternatively give index from list_equations. expression is the right-hand side, e.g. '3mm' or '"Wall" * 2'; a number without a unit is in the document's unit (20 is 20 inch in an inch document). A change that breaks the model is rolled back. A size the tools dimensioned from the drawing (DrawnN) becomes the user's when an equation drives it: it is renamed (the result says to what).

Inputs: expression (required), name, index.

set_materialA

Assign a material to the active part by its exact name from list_materials (e.g. '6061 Alloy', 'AISI 304', 'ABS'). Returns the resulting density and mass.

Inputs: name (required).

set_subassembly_solvingA

Make a sub-assembly component rigid or flexible in the active assembly. Rigid (SolidWorks' default) moves as one piece; flexible lets the sub-assembly's own parts move, within its own mates, when they are mated or dragged in this assembly. The state read back is reported; list_components shows it as 'solving'.

Inputs: component (required), solving.

set_title_blockA

Put a title block in the bottom right corner of the active sheet, or update the one already there (title, drawn by, date, scale, material, sheet size; every input is optional). The first call fills missing fields from the drawing (title = the model's name, date = today, scale = the sheet scale, material = the drawn part's material, sheet size = the sheet); later calls change only the fields given. Returns the block as it now reads.

Inputs: date, scale, title, drawn_by, +2 more.

set_unitsA

Set the default length unit, mm, inch, cm or m, used when a tool's unit input is left out.

Inputs: unit (required).

sheet_metal_base_flangeA

Make the first feature of a sheet metal part from a sketch. A CLOSED sketch (a plate; holes allowed) becomes a flat plate of the given thickness. An OPEN sketch (one chain of lines and arcs) becomes a bent profile extruded to depth, its corners turning into bends. The sketch is the OUTSIDE of the part: the thickness is built inward. Refused when the part already has a base flange (a tab on a face comes later) or a solid body. Returns the thickness, bend radius, K-factor and number of bends read back from the part.

Inputs: thickness (required), flip, unit, depth, +3 more.

shellA

Hollow out the body, leaving walls of the given thickness. The openings are the faces given by open_faces (points on them) and / or open_normal; with neither, the faces currently selected are removed, and with nothing selected the body becomes a closed hollow.

Inputs: thickness (required), unit, outward, open_faces, +1 more.

show_explodedA

Show the active assembly's exploded view exploded (exploded true) or collapsed (false). name picks the view when the configuration has several (default: its only one). Returns the state read back and which components moved.

Inputs: exploded (required), name.

sketched_bendA

Bend sheet metal along the single line of a sketch on its flat face, toward the sketch's side (reverse bends the other way). SolidWorks chooses the side that stays; fixed_point in the result is on it. position: centerline (the line is the middle of the bend), inside, outside or bend_outside. Refused while flattened.

Inputs: angle (required), sketch (required), unit, radius, +2 more.

solidworks_guideA

Read how to operate SolidWorks through these tools: recipes (the order of steps and the tools for a plate with holes, a revolved part, sheet metal and its flat DXF, an assembly with mates, a finished drawing, looking inside an assembly, equations, a weldment frame), verifying by measurement, units and coordinates, pitfalls and limits, and what to do when a call fails. Call it before a multi-step build, or when unsure how to do something. Without topic it lists the topics. Every answer starts with the short rules (In short). Read-only.

Inputs: topic.

step_mateA

Step a distance or angle mate through a list of values, optionally saving a picture (named .png; an existing file is never replaced: the next free name, ' (2).png', is used and reported) and counting interferences at each step: this is how a mechanism is moved and shown. For each value the mate is set, the assembly rebuilt and the mate errors read. The call stops by itself before max_seconds runs out and returns the values still to do, to pass on as first_index; it also stops at the first value the mates do not allow. A PUSHED chain folds if the driven point moves more than one link pitch along its track in one move: set max_change (about half the pitch) and the way between values is walked in smaller moves.

Inputs: name (required), values (required), up, unit, +14 more.

structural_memberA

Make weldment structural members along the lines and arcs of a sketch, from the installed profile library: standard (e.g. iso, ansi, DIN), type (e.g. square tube) and size (e.g. 20 x 20 x 2). corner decides how members meet: miter, butt1, butt2 or none; butt1 / butt2 give SolidWorks' pinwheel: each member runs through at one end and stops at the other, so every member is exactly as long as its path (the butt joint as built, nothing to trim). An unknown standard, type or size is refused with the list of choices. Returns the feature, the bodies and their lengths.

Inputs: size (required), type (required), sketch (required), standard (required), +1 more.

suppress_mateA

Suppress a mate: it stays listed but holds nothing, so the components it joined can move. Reports the state read back.

Inputs: name (required).

sweepA

Sweep a solid along a path sketch. Give a closed profile sketch and a path sketch (the path must start on the profile's plane), or give a diameter to sweep a round bar along the path without a profile sketch. By default the profile is the last sketch and the path the one before it. With cut=true the swept volume is removed from the body instead (refused when the part has no solid body or the cut removes nothing).

Inputs: cut, path, unit, merge, +2 more.

tabA

Add a tab to a sheet metal part: a closed sketch drawn on the sheet's flat face (it may overlap the part) becomes sheet of the part's thickness, merged into the part. Returns the feature and the volume added. Refused while flattened.

Inputs: sketch (required).

unflattenA

Fold the active sheet metal part again (suppress its flat pattern). Returns the folded size, largest first.

Inputs: unit.

unsuppress_mateA

Turn a suppressed mate back on and rebuild. Reports the state read back, which components moved, and any mates that now have errors.

Inputs: name (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 121 tools

    Disambiguation3/5

    The tools are grouped by CAD subdomain and descriptions are unusually detailed, but there are many near-neighbors that require careful reading (e.g. set_dimension vs add_sketch_dimension vs set_dimension_precision; list_faces vs list_component_faces; delete_mate vs delete_feature). With 121 tools, an agent has a high chance of choosing a plausible but wrong operation unless it scans descriptions closely.

    Naming Consistency4/5

    Names are consistently snake_case and mostly action-oriented, with clear verb_noun patterns such as draw_line, add_mate, list_drawing_views, and set_custom_properties. There are noticeable deviations where SolidWorks feature names or bare verbs are used (hole_wizard, structural_member, shell, sweep, loft, hem, tab), but the naming remains readable and largely predictable.

    Tool Count1/5

    121 tools is far beyond the 3-15 well-scoped range and represents an extreme surface even for a complex CAD domain. The server would be more coherent split into focused modules or with merged convenience tools.

    Completeness4/5

    The surface covers documents, sketches, features, assemblies and mates, drawings, sheet metal, weldments, exports, properties, materials, colors, and measurement, so core SOLIDWORKS workflows are well represented. Gaps remain around configuration management and broader drawing export options, but most domain tasks have a viable path.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents such as Claude to drive SolidWorks through its COM API using natural language, creating parts and assemblies, sketching geometry, and adding features without clicking menus. Also supports running arbitrary API scripts and verifying results through model reports, rendered views, interference checks, and exports.
      1
      MIT
    • F
      license
      B
      quality
      C
      maintenance
      Enables AI agents to drive SolidWorks for parametric modelling, aerospace part generation, sheet metal, weldments, assemblies, drawings, simulation, inspection, and file export. It provides approval-gated operations, verification tools, and journaling for safe, recoverable design automation.
      94
      -
    • A
      license
      B
      quality
      B
      maintenance
      Enables AI agents to create and edit parametric SolidWorks parts and assemblies, measure resulting geometry, and iteratively verify their work against specifications.
      91
      96 PyPI
      1
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      Connects an AI assistant to a running SOLIDWORKS session to build and inspect native models, validate explicit design requirements, compare isolated part variants, and generate native Visualize product-shot packs with measurable artifacts.
      123
      MIT

    Appeared in Searches