Skip to content
ShapeAnywhere Wiki
AI & MCP

AI and MCP: connection and tool reference

Connect a client, understand approval and look up every available MCP tool.

Updated:

Choose your connection route first

CAD chat, LM Studio chat, external AI clients through MCP and the separate plugin have different requirements. Start with the four-route comparison; this page is the complete tool reference.

What MCP provides

MCP connects an AI client to the CAD application. The language model plans the construction and selects tools. The app computes geometry and returns verifiable results. Successful connection does not guarantee a mechanically sensible design. The reference distinguishes automatic geometry commands, read-only checks and interactive tool activation. Opening a tool is not a completed edit. Parametric programs, model images and assembly inspection support general construction. See free AI modeling. For external MCP clients, Connect cloud AI through MCP and OAuth explains sign-in, permissions and revocation. Permanent MCP tokens remain available for other clients.

Further construction guides

Edit existing features and parameter rows, measure distances and hearts, splines, lettering and planar embossing explain the general tools with examples and limitations.

Complete reference

AI / MCP Help

Design in ShapeAnywhere using AI

Describe your part in your own words. A connected AI assistant can create, edit and check CAD bodies in your open project.

Tip: Be specific about dimensions and positions. When editing existing parts, ask the assistant to list the bodies first.

Get started in a few steps

  1. Sign in to ShapeAnywhere and open the CAD project you want to edit.
  2. Under “Tools → AI / MCP → Connections”, choose where you want to chat. The wiki compares all four routes.
  3. For external chats, connect CAD and enable it as the MCP target. For CAD chat, enable the local LM Studio server and CORS instead.
  4. Set up your chosen client and start by asking there: “Which parts are in my project?” Approve edits in CAD.

Connect your AI assistant

LM Studio’s own chat uses a personal permanent MCP token from your ShapeAnywhere account here. External AI clients such as ChatGPT and Claude can use OAuth when supported. The separate ChatGPT plugin also uses OAuth. Integrated CAD chat uses the local LM Studio API instead; a configured API key there is a different credential.

Open MCP connections in your account

Treat your access token like a password. The full value is shown only when it is created. You can revoke it from your account at any time.

Example: show MCP configuration for LM Studio

Replace YOUR_SHAPEANYWHERE_TOKEN with your personal token. Do not copy the placeholder.

{
  "mcpServers": {
    "shapeanywhere": {
      "url": "https://mcp.shapeanywhere.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SHAPEANYWHERE_TOKEN"
      }
    }
  }
}

You can also copy the setup from the AI/MCP window. Refresh the AI client’s tool list to see newly available tools.

Things you can ask the AI to do

Start with a simple part, then extend it step by step. Copy and adapt these examples.

Create a cylinder 75 mm in diameter and 40 mm tall.

Create a 100 × 10 × 80 mm base plate with four 6 mm through-holes at the corners.

Create a tube with an outer diameter of 75 mm, inner diameter of 68 mm and height of 50 mm. Add a flange with eight holes on a 90 mm pitch circle.

List all bodies first. Then check whether the flange is valid CAD geometry and report its dimensions.

All available AI tools

These are the functions a connected AI assistant can currently call. You do not need to know the command names: describe what you want in plain language. The names are listed for advanced users.

73 / 73 tools

Inspect and verify your project

Audit CAD project and print placement

cad_audit_project

Checks up to twelve existing bodies for actual closed-solid geometry, volume and world bounds. Reports placement relative to the print plane and optionally checks a specified X/Z build area. Without ids, starts at solid 0; use offset and nextOffset to page through 12 solids at a time, or ids to inspect selected solids. Bodies not checked in the current pass are counted. Never changes the model. This does not prove wall thickness, collision freedom, material strength or printability. If a technical check fails, the body is unverified rather than automatically invalid. Total audit budget is 90 seconds.

Example request

„Audit the current project and check whether its solids fit a 220 × 220 mm build plate centered at X=0, Z=0.“

Check body interference

cad_check_interference

Checks whether two bodies overlap in their current positions. Individual checked poses do not prove an entire motion path or printability.

Example request

„Check whether the box and lid overlap in their current positions.“

View body details

cad_get_body

Shows stored dimensions, position and modeling steps of a selected body. This information does not replace geometry verification.

Example request

„Show the dimensions and modeling steps of the flange.“

Read history and editable dimensions

cad_get_history

Shows feature and edge operation IDs, available dimensions and saved parameter rows. designChecks reports design warnings for simple analytic shapes (not global wall-thickness analysis). featureDependencies includes recognized multi-level links such as base → boss → through-hole, with center, top, bottom and side-face anchors. Ambiguous, imported and freeform features do not receive invented constraints. Refresh historyToken after each change. designChecks flags thin walls, close bores and ineffective features for simple analytical shapes only. Not a global wall-thickness measurement.

Example request

„Inspect the dependency chain of this base, boss and through-hole.“

Inspect a sketch outline

cad_get_sketch

Shows outline points, plane and stored curve data for a sketch. The current sketch token is required for subsequent edits.

Example request

„Show the outline and plane of my rectangle sketch.“

Read sketch constraints and actual dimensions

cad_get_sketch_constraints

Reads connected sketch sources with actual point/rectangle-edge picks, plane axes, fix records, relationships and available mm or degree dimensions. Intrinsic rulers belong to their owner; saved dimensions have their own IDs. Refresh the token after every edit and read further pages through nextOffset. Does not claim full constraint; splines expose fit points rather than an invented width ruler. Per-source issues identify existing conflicts by constraint ID; diagnosis does not repair geometry or prove full constraint.

Example request

„Check existing sketch constraints for conflicts and report the affected IDs without changing the sketch.“

Inspect faces and edges

cad_get_topology

Reads current faces and edges with IDs and a selection token. Straight edges between planar faces are classified as concave or convex using adjacent face triangles; unsupported cases remain unknown. Edge groups apply to the returned page. The normal filter affects faces only. Query again after edits.

Example request

„Show the confirmed concave inner corners of this shell with current IDs, without changing the model.“

Inspect an actual model image

cad_get_view

Returns a PNG image of current CAD geometry to the AI client. Isometric and straight views are available. The image contains no application UI; viewport and document placement stay unchanged. The client must pass image data to the model as an image input. The wiki explains the optional ShapeAnywhere Vision adapter for affected LM Studio versions. Shallow raised details remain visible in top views.

Example request

„Inspect the two new bodies in isometric and top views before assessing the result.“

Inspect an assembly on copies

cad_inspect_assembly

Checks up to six actual bodies for volume, world bounds, distance from the bed and pairwise material overlap. Optional test rotation affects a copy only; actual document placement stays unchanged. Valid individual solids or collision-free samples do not prove mechanical function or printability.

Example request

„Check box and lid at Y=0 and test the lid rotated 90 degrees on a copy around the specified hinge axis.“

List bodies

cad_list_bodies

Lists IDs, enclosing bounding-box centers and stored bounding dimensions. Adding a hinge or other feature changes this center without moving the original housing. Do not infer a corrective move from that difference. Use the verification tool to validate geometry.

Example request

„Which parts are in my project?“

List sketches

cad_list_sketches

Lists existing sketch profiles and lines with their IDs and positions.

Example request

„Which sketches and lines are in my project?“

Measure point distance

cad_measure

Measures distance and X/Y/Z differences between two supplied points in millimeters.

Example request

„Measure the distance between [0,0,0] and [3,4,0].“

Measure body or plane separation

cad_measure_geometry

Measures native minimum distance between two bodies. With two selected planar faces it instead returns their angle and, when parallel, separation of the infinite supporting planes. This is not an automatic global minimum wall-thickness check. Geometry remains unchanged.

Example request

„Check the gap between box and lid, then measure wall thickness between the selected parallel inside and outside faces.“

Check connection

cad_status

Shows whether your CAD project is connected to your AI assistant.

Example request

„Check whether ShapeAnywhere is connected.“

View tool palette

cad_tool_palette

Shows the complete app palette and which tools support automatic commands or require manual selection.

Example request

„Which tools can you use automatically and which require my selection?“

Validate CAD body

cad_verify_body

Checks whether a part is a valid closed CAD solid and reports its volume.

Example request

„Check whether my flange is a valid CAD solid.“

Create new bodies

Create box

cad_create_box

Creates a box with a chosen width, height and depth.

Example request

„Create a box measuring 100 × 20 × 60 mm.“

Create cylinder

cad_create_cylinder

Creates a solid cylinder with a specified diameter and height.

Example request

„Create a cylinder 50 mm in diameter and 30 mm tall.“

Create a print-in-place hinged box

cad_create_hinged_box

Optional product generator for one defined hinged-box design. Creates a box and lid with a captured printed hinge pin and optional flexible snap latch. Width and depth are closed external housing dimensions excluding the hinge and latch. Defaults: height 35 mm, walls/bottoms 2.5 mm, radial clearance 0.4 mm, inner/outer housing chamfers 0.5 mm, latch enabled. Both bodies are created together in their open print pose at Y=0. Bearing holes and five hinge poses are checked on copies. The latch needs elastic deflection; material suitability and printer clearance require a trial print. Export both bodies together without changing their relative pose.

Example request

„Create a box with lid, external dimensions 80 by 60 mm, a print-in-place hinge and snap latch.“

Create revolved profile

cad_create_profiled_body

Creates a rotationally symmetric part with multiple radii, an optional inner profile and rounded arcs. Inner and outer radii are compared at the same height, allowing hollow bodies that widen toward the top.

Example request

„Create a 36 mm tall hollow holder widening from 24 to 32 mm outside diameter and from 18 to 26 mm inside diameter.“

Create a sketch

cad_create_sketch

Creates independent rectangles, circles, ellipses, slots, polygons, lines, guides, three-point arcs or splines on a specified plane. Closed splines provide extrudable profiles. Optional tangents control corners and tips; a zero vector creates a sharp point. The modeling outline is a bounded approximation of the spline.

Example request

„Draw a 100 by 70 mm rectangle on the XZ plane at Y=0.“

Create text sketch outlines

cad_create_text

Creates actual lettering outlines using the bundled Roboto font. Height is font size, not guaranteed cap height. Holes in letters such as B and O remain intact. Disconnected letters return multiple profiles for individual extrusion or combined embossing. An optional up direction controls upright lettering; the default XZ plane reads along +X with the top towards -Z.

Example request

„Create SCREWS at an 8 mm font size as editable sketch profiles.“

Create tube

cad_create_tube

Creates a tube with an inner and outer diameter.

Example request

„Create a tube 75 mm outside diameter, 68 mm inside diameter and 40 mm tall.“

General parametric CAD program

cad_execute_program

Runs freely chosen supported CAD tools with numeric parameters, bounded arithmetic, result references and repetition. All steps commit together or roll back on failure. At most 40 executed steps; no arbitrary JavaScript, interactive tools or nested programs. Input parameters do not automatically become persistent Builder dimension actions.

Example request

„Build a plate using width and depth variables and use its result ID in subsequent operations.“

Extrude a sketch

cad_extrude_sketch

Extrudes a closed profile from its sketch plane along its normal. operation=new defaults to a new body. add, cut and intersect require targetId and preserve its ID, name and history. distance is signed; a new name applies only to new. Ineffective or invalid target edits roll back entirely. The source stays linked by default. linked=false creates a snapshot; consume=true removes a source not already used by another body and creates no link. Spline regions retain the validated curve fit with at most 0.01 mm extra deviation; polygons stay faceted. Through-all and up-to-face extents and direct-edit target histories are not supported.

Example request

„Cut my closed slot sketch 5 mm against its normal into the existing bracket and keep the sketch linked.“

Loft through sketches

cad_loft_sketches

Connects two to sixteen distinct, ordered closed profiles into one solid. mode selects ruled or smooth transitions. Hole counts must match. Sections remain linked by default; source edits regenerate the solid after joint validation. linked=false or consume=true creates a snapshot. Guided loft variants are available in the normal CAD tools.

Example request

„Create a smooth handle through these three elliptical sections. Then widen the middle section while preserving the existing bore.“

Revolve a sketch

cad_revolve_sketch

Creates a new revolved solid around an axis in the profile plane. axisId links a straight sketch or construction line; alternatively, origin and direction define a fixed world axis. The profile and selected sketch axis remain linked by default. Source and body edits commit after validation. linked=false or consume=true creates an independent snapshot.

Example request

„Revolve this wall section 360 degrees around the existing construction line. Keep the profile and axis as editable sources.“

Sweep a sketch along a path

cad_sweep_sketch

Sweeps a closed profile without holes along a path. pathIds links connected existing sketch curves including splines; the alternative path uses fixed world points. The profile and selected curves remain linked by default. The path start must match the profile. Tight bends or impossible downstream operations are rejected. linked=false or consume=true disables linkage.

Example request

„Sweep this circle along the existing spline. Then increase the profile diameter and verify the updated body and image.“

Add features and cutouts

Add rectangular boss

cad_add_box

Adds a box-shaped boss to an existing part.

Example request

„Add a rectangular boss measuring 20 × 8 × 15 mm to the base plate.“

Add round boss

cad_add_cylinder

Adds a cylindrical boss to an existing part.

Example request

„Add a round boss 20 mm in diameter and 8 mm tall to the base plate.“

Register a persistent feature dimension

cad_add_parameter

Registers a named persistent feature dimension without rebuilding unchanged native geometry. Analytic revolutions expose outer diameter, inner diameter and height; other features report supported dimensions in cad_get_history.parameterizableParameters. Rows appear immediately in the normal CAD panel. Reuse the returned historyToken for each subsequent registration.

Example request

„Save outer diameter, inner diameter and height as three persistent dimensions on this analytic ring.“

Add insertion ring

cad_add_ring

Adds a ring-shaped projection, for example to form a push-fit connection.

Example request

„Add an insertion ring to my tube, 70 mm outer diameter, 64 mm inner diameter, 5 mm tall.“

Create a persistent sketch dimension

cad_add_sketch_dimension

Creates a normal dimension visible and saved in CAD using actual picks and a current token: point distance, point-to-line, parallel line spacing, line angle or arc angle/chord/length. Values are absolute millimeters or degrees. Point dimensions support aligned, horizontal and vertical modes in the sketch plane. Reference dimensions measure without a target; driving dimensions change geometry. No free-form equation editor.

Example request

„Dimension the horizontal center distance of these circles to 30 mm, using the fixed first center as reference.“

Apply a normal sketch constraint

cad_apply_sketch_constraint

Applies the same geometric relationships as CAD using a current token and actual picks. Symmetry takes leader, follower and straight axis; matching lines, arcs, circles and spline pairs are supported. It does not make one closed spline self-symmetric. Reapplying Fix never unlocks. Conflicts or invalid linked solids reject the complete draft.

Example request

„Keep the right open spline half mirrored from the left half about our fixed centerline.“

Combine existing bodies

cad_boolean_bodies

Unites existing bodies, subtracts tool bodies or keeps their common intersection. The result must be a single connected solid. Tool bodies are kept by default; independent tools can optionally be removed. Run this command individually. A union or subtraction with no volume change is rejected.

Example request

„Subtract the “Drill” body from the “Base plate” and keep the drill.“

Chamfer body edges

cad_chamfer_edges

Chamfers selected sharp edges. For concave inner corners, use matching IDs from current topology. “All” also includes opening rims and outer edges. Concave chamfers can add material; large chamfers at thin convex rims may be impossible. Failure leaves the body unchanged.

Example request

„Apply a 5 mm chamfer only to the confirmed concave inner floor and wall corners of my open box. Keep the upper rim unchanged.“

Cut rectangular pocket

cad_cut_box

Cuts a rectangular pocket in an existing part.

Example request

„Cut a rectangular pocket 20 × 5 × 12 mm into the base plate.“

Drill hole or pocket

cad_cut_cylinder

Cuts a round hole or cylindrical pocket in an existing part.

Example request

„Drill an 8 mm through-hole in the base plate.“

Cut annular groove

cad_cut_ring

Creates a ring-shaped groove, such as a seat for an insertion ring.

Example request

„Cut a 3 mm deep ring groove with 72 mm outer and 65 mm inner diameter.“

Emboss free sketch profiles

cad_emboss_sketch

Applies up to 64 closed sketch profiles, including spline outlines, to a selected planar face. Sources must already lie in that face plane. They are neither automatically moved nor scaled and remain after embossing.

Example request

„Engrave the existing closed heart outline 0.5 mm into the flat top of the plate.“

Emboss or engrave text

cad_emboss_text

Applies text to a selected planar CAD face. Operation and positive depth control raised lettering or engraving. Position and orientation are explicit; oversized or out-of-face outlines are rejected. Curved targets still require the interactive emboss tool.

Example request

„Engrave SCREWS at a 7 mm font size and 0.8 mm depth in the center of the flat lid face.“

Fillet body edges

cad_fillet_edges

Rounds selected or all sharp body edges with the specified radius. Selection tokens must match the current body.

Example request

„Round the four vertical outer edges of my box with a 1 mm radius.“

Create circular hole pattern

cad_hole_pattern

Places multiple equally sized holes along a circular pattern.

Example request

„Create eight 6 mm holes on a 90 mm pitch circle.“

Hollow a body

cad_hollow_body

Hollows a body inward with uniform wall thickness and opens the selected faces. Query the current selection first.

Example request

„Hollow my box with 2.5 mm walls and remove the top face.“

Join sketch curves into closed regions

cad_join_sketches

Finds closed regions from two to 32 selected coplanar curves or profiles. Sources remain intact. Endpoints must already match; gaps are not automatically bridged. Returned profile IDs can be extruded or embossed.

Example request

„Join the two open heart halves at their matching endpoints and extrude the closed region to 4 mm.“

Offset a face

cad_offset_face

Offsets a selected body face normally by a positive or negative distance. The body is verified before committing.

Example request

„Offset the top face of my box outward by 2 mm.“

Remove one specific sketch relationship

cad_remove_sketch_constraint

Removes exactly one returned relationship, point binding or saved dimension from its owner using a current token. The object-lock record explicitly unlocks the object. Removing an automatic rectangle condition also releases its regeneration. Other conditions remain; linked solids validate before committing. Orphaned saved dimensions can be removed by diagnosis ID even without a visible label. Other pre-existing defects may remain during incremental cleanup; new issues are rejected.

Example request

„Remove the orphaned distance dimension using its reported ID, then check the remaining sketch conditions.“

Set saved parameter rows

cad_set_parameters

Sets existing unfrozen parameter rows by ID to absolute values in their reported unit: millimeters or degrees. Register new feature dimensions first with cad_add_parameter. Does not change transient program variables. The result is validated before committing. Simple through-cuts follow body height while pockets and bosses follow their recorded anchor. Explicit child dimensions take precedence; this is not a general equation system. Unambiguous multi-level boss-and-hole chains are propagated together; explicit child dimensions take precedence. Freeform chains still require separate inspection. A concentric bore that removes its cylindrical host wall is rejected. Nonblocking design warnings are reported in designChecks. Native edge and feature edits appended after row registration are incorporated into the replay baseline before a later parameter change; unsafe cases are rejected rather than silently losing operations.

Example request

„Set the saved hole-diameter parameter to 8 mm and verify the body.“

Edit an existing sketch dimension

cad_set_sketch_dimension

Edits a returned intrinsic ruler or saved sketch dimension using a current token. Edited intrinsic rulers also become visible in CAD. Saved dimensions support driving or reference behavior; point dimensions additionally support aligned, horizontal or vertical mode. Reference dimensions cannot take driving targets. Conflicts, violated fix anchors or invalid downstream solids preserve the complete previous document.

Example request

„Change the saved circle-center spacing from 30 to 35 mm and validate its linked extrusion.“

Fillet or chamfer a sketch corner

cad_sketch_corner

Modifies two selected straight sketch legs with an analytic arc or chamfer. Returns the new elements and closed profiles.

Example request

„Round the front-left corner of my rectangle sketch with a 2 mm radius.“

Offset a sketch outline

cad_sketch_offset

Creates an independent offset copy of a circle or polygonal closed outline. Positive distance expands it.

Example request

„Create a copy of my circle profile offset outward by 2 mm.“

Split a body at a plane

cad_split_body

Splits a body at a specified plane into two editable bodies. Both halves and their total volume are verified.

Example request

„Split my box at the plane through [0,0,0] with normal [1,0,0].“

Model a thread

cad_thread

Creates a verified internal or external modeled thread on a full cylindrical face. Default end margins and length match the CAD panel. Choose fit (exact/snug/normal/loose) or clearance (mm), not both; leadIn adds an optional modeled entry chamfer. Incompatible carrier geometry is rejected.

Example request

„Get topology, then create an M8 external thread with fit=normal and leadIn=0.3 mm and verify geometry.“

Edit an existing fillet or chamfer

cad_update_edge_operation

Changes the positive radius or chamfer amount of a saved edge operation using a current token. Preserves edge selection and style. Impossible dimensions or invalid downstream steps reject the whole draft. For parameter-managed bodies, set the corresponding saved row instead.

Example request

„Change the existing 1 mm chamfer to 1.5 mm and validate the body.“

Edit an existing feature

cad_update_feature

Changes supported primitive dimensions, extrusion heights, hole diameters and feature positions, wall thickness, face offset, revolve angle or text embossing. History reports allowed fields. Preserves body identity and extrusion start; symmetric extrusions keep their center. Downstream dimensions are not automatically resized. Invalid drafts are discarded. Analytic revolution profiles can change outer/inner diameter and height when those dimensions are listed in history. Simple native downstream features can follow base edits; separately dimensioned or complex features retain their own behavior. Unambiguous concentric bores removing the host boss wall are rejected; low remaining walls are warnings.

Example request

„Increase the existing box wall thickness from 2.5 to 3 mm while preserving its external dimensions.“

Edit sketch dimensions and spline points

cad_update_sketch

Changes basic profile dimensions or spline fit points and tangents using a current token. Preserves dimensions, fixed anchors and relationships including mirrored spline pairs. Jointly validates shared regions and linked extrusions, revolves, sweeps and lofts. Conflicts or invalid geometry preserve the document. Legacy or unlinked solids remain snapshots. Remove indexed point bindings before changing spline fit-point count.

Example request

„Make the existing heart spline narrower symmetrically by editing its fit points while keeping the outline closed.“

Arrange and manage bodies

Align a body

cad_align_body

Aligns the minimum, center or maximum bounding coordinate of one body with another, with an optional offset.

Example request

„Align the X center of the lid with the X center of the box.“

Circular body pattern

cad_circular_pattern

Distributes 2 to 64 bodies including the original around an X, Y or Z axis through a given point, rotating the copies with it. A full 360° circle does not duplicate the starting body; partial arcs include both ends. The original center must be off the axis. Each new copy counts as an editing step in automatic mode. Independent copies preserve geometry but do not inherit source sketch links or saved parameter rows.

Example request

„Distribute six instances of the bracket at X=40 mm, including the original, through 360 degrees around the Y axis through [0,0,0].“

Delete body

cad_delete_body

Removes a selected part from the current project.

Example request

„Delete only the copy of the flange.“

Duplicate body

cad_duplicate_body

Creates an independent, offset copy of a part. Independent copies preserve geometry but do not inherit source sketch links or saved parameter rows.

Example request

„Copy the flange and place it 120 mm to the right.“

Linear body pattern

cad_linear_pattern

Creates independent copies with equal spacing in X, Y and Z. The count from 2 to 64 includes the original. All copies are verified together and can be undone in one step. In automatic mode, each new copy counts as an editing step. Independent copies preserve geometry but do not inherit source sketch links or saved parameter rows.

Example request

„Arrange five instances of the bracket at 30 mm intervals along X, including the original.“

Mirror a body

cad_mirror_body

Mirrors a body across a plane and creates an independent copy by default. Can instead mirror the original.

Example request

„Create a mirrored copy of my bracket across the YZ plane through the origin.“

Move body

cad_move_body

Moves a part along the X, Y and Z axes.

Example request

„Move the cylinder 25 mm to the right.“

Color a body

cad_paint_body

Changes a body display color without changing geometry or assigning a print material.

Example request

„Color the lid blue using #336699.“

Rename body

cad_rename_body

Changes the name of an existing body.

Example request

„Rename the cylinder to Connector.“

Rotate body

cad_rotate_body

Rotates a body around its center or a supplied world point, such as a lid hinge axis.

Example request

„Rotate my lid 45 degrees around the X axis through [0,17.5,-40.1].“

Scale uniformly

cad_scale_body

Scales the entire body proportionally.

Example request

„Scale the selected cylinder to 110 percent.“

Transform a sketch

cad_transform_sketch

Moves, rotates, scales or mirrors an independent sketch. Rebuilds shared regions and linked bodies while preserving dimensions, fix anchors and relationships. Incompatible transforms reject the draft. An optional independent copy does not inherit foreign bindings. Use refreshed profile IDs afterward.

Example request

„Create a copy of my sketch shifted 20 mm along X.“

Control editing steps

Open interactive tool

cad_activate_tool

Opens an existing app tool. You then select and finish in the CAD window; opening the tool alone does not complete a geometry edit.

Example request

„Open the emboss tool so I can select the faces myself.“

Delete a sketch

cad_delete_sketch

Deletes an independent sketch or line and derived regions. Does not delete bodies.

Example request

„Delete only the unused helper sketch you created.“

Run multiple steps as one job

cad_execute_plan

Runs an explicitly requested multi-step CAD job with up to 40 steps.

Example request

„Create a base plate with four holes in one CAD job.“

Undo last change

cad_undo

Reverts the last CAD modification.

Example request

„Undo the last change.“

Not every request can be completed in one call. The AI may use several tools in sequence. More difficult geometry can still fail.

Approve changes or work automatically

By default, you approve each model change in the CAD window. If you want the AI to continue on its own, enable Automatic mode in the AI/MCP window.

  • Automatic mode applies only to your open project for up to 30 minutes or 80 editing steps.
  • You can stop Automatic mode or disconnect at any time.
  • Review the AI’s result. You can undo changes; in step-by-step mode each change is stored separately.

If something goes wrong

The assistant cannot find my project

Open the desired CAD project and check the connection and “Use this project as MCP target” setting. If several projects are open, select only one target.

The AI only prints commands or JSON text

Check that ShapeAnywhere tools are enabled in your AI client. Choose a model that supports tool calling and test a real cad_status call.

A tool is missing in the AI client

Refresh the AI client’s tool list and start a new chat if needed.

A part could not be computed

Read the error and check the dimensions. Ask the AI to retry that step with corrected values or use cad_verify_body to check the part.

The AI reports success but the model looks wrong

Ask the AI to read actual body IDs using cad_list_bodies and validate finished bodies with cad_verify_body. Compare the result with your requested dimensions.

ShapeAnywhere · AI/MCP Help · The described features match the current tool catalog.