kalpataru

name	kalpataru
description	Drive SolidWorks via the Kalpataru MCP server — create parts, query geometry, edit features, and manage documents. Use when the user wants to model anything in SolidWorks (bracket, housing, shaft, gear, assembly, etc.).

Kalpataru — SolidWorks automation for agents

You have access to the Kalpataru MCP server. It exposes SolidWorks through a suite of kalpataru_* tools. The user's SolidWorks instance is running on the same machine; you can read its state, mutate it, and ask the user to click on geometry when an operation needs a human pick.

Always start with kalpataru_ping

Before any other call, run kalpataru_ping. It returns:

• solidworks_version — confirms SW is responsive
• adapter_version — Kalpataru build
• document_open — whether a part is currently open

If the response is {ok: false, error: "server_unreachable"}, SolidWorks isn't running or the add-in isn't loaded. Tell the user to start SolidWorks or run kalpataru serve. Don't retry blindly.

The four tool families

Family	Tools	Use for
Documents	kalpataru_new_part, kalpataru_open_part, kalpataru_save_part, kalpataru_close_part	document lifecycle
Sketches	kalpataru_create_sketch	sketches on planes or faces
Features	kalpataru_extrude, kalpataru_cut, kalpataru_revolve, kalpataru_fillet, kalpataru_chamfer, kalpataru_shell, kalpataru_mirror, kalpataru_linear_pattern, kalpataru_circular_pattern, kalpataru_reference_plane	feature creation
Queries	kalpataru_summary, kalpataru_query_faces, kalpataru_query_edges, kalpataru_inspect_entity, kalpataru_list_features	reading the model
Edits	kalpataru_edit_feature, kalpataru_undo, kalpataru_redo	parametric changes
HITL	kalpataru_request_selection	ask the user to click

For deeper workflow guidance, also check the companion skills:

• kalpataru-make-a-part — sketch-then-feature workflow + ordering rules
• kalpataru-sketch-workflow — constraints, dimensions, DOF
• kalpataru-introspect-feature-tree — read existing parts
• kalpataru-edit-feature — parametric edits
• kalpataru-debug-rebuild — when something fails

Error recovery

Every tool returns {ok, ...}. On ok: false:

• Read the error, message, and suggestion fields
• If the suggestion is concrete, follow it
• If you've tried twice and it's still failing, ask the user — don't loop

Common error codes:

• server_unreachable — SW not running
• entity_not_found — entity ID stale (topology shifted); re-query
• under_constrained — sketch DOF > 0; add dimensions before extruding
• selection_required — operation needs a click; call kalpataru_request_selection
• rebuild_failed — feature wouldn't rebuild; check the warning message for the broken reference

Coordinate system

All coordinates are in millimetres. The origin is at (0, 0, 0). The Front plane is the XY plane (Z=0); the Top plane is XZ (Y=0); the Right plane is YZ (X=0).

Entity IDs are stable, within reason

Faces and edges have IDs like F3, E12. They're stable as long as the topology underneath doesn't change. A fillet, shell, or pattern will re-index every face/edge it touches — so any ID you captured before is now stale. Re-query after topology-changing operations.