Get design name, bodies, sketches, features, camera info

Get detailed info about a named body or sketch

Axis-aligned bounding box for a body or component by name. Returns min, max, size, and center in cm (Fusion internal units). For components, unions bounding boxes of all contained bodies. Useful for measuring imported reference geometry.

Create a new sketch on xy/yz/xz plane, optionally offset

Draw a rectangle in the most recent sketch

Draw a circle in the most recent sketch

Draw a line in the most recent sketch

Extrude a sketch profile

Revolve the most recent sketch's profile about an axis. axis_origin and axis_direction are model space (cm). The axis must be coplanar with the profile: a world-aligned direction through the model origin uses Fusion's own construction axis, anything else becomes a construction line in the sketch, and an axis leaving the sketch plane is refused with AXIS_OUT_OF_PLANE. The result reports axis_model_start/axis_model_end.

Round edges of a body

Chamfer edges of a body

Hollow out a body by removing a face

Mirror a body across a construction plane

Rename a body (searches root and all components)

Translate a named body by (x, y, z)

Export a named body as an STL file

Combine two named bodies (join/cut/intersect)

Clear the design (delete all timeline items)

Step the design back one operation. Parametric designs move the timeline marker back one step (synchronous and verified; the feature stays in the timeline, suppressed, and returns if you roll forward). Direct designs issue Fusion's asynchronous undo command and report undone: 'issued', verified: false — confirm with get_scene_info. Reports undone: false when there is nothing to undo.

Run arbitrary Python in Fusion 360. The last expression's value is returned (REPL-style). Pre-defined names: app, ui, design, component, adsk, math.

Sweep a sketch profile along a path (sketch curve)

Loft between two or more sketch profiles

Draw a regular polygon in the most recent sketch

Draw an arc in the most recent sketch (center + start point + sweep angle)

Create a hole feature on a body face

Pattern a body in rows and columns

Pattern a body around an axis

Create a new design document and make it active. Every other tool needs an active design, and Fusion sits at the data tab with none after a fresh launch, so this is the way in from a cold start. The document is created through the API on purpose: documents created in the Fusion UI are Part Design documents, which reject addNewComponent, so components and joints are impossible in them.

Create a new component (sub-assembly) in the design

Add a joint between two components using a pair of faces as joint geometry. face_one/face_two are mandatory: a joint cannot be built from component origins, because a bare point carries no component association. Pass a cylindrical face on each side (see get_object_info for the face indices) - for a hinge that is the knuckle bore on each leaf. NOTE: creating a joint MOVES the components so the joint geometry becomes coincident - use create_as_built_joint when the parts are already positioned.

Drive a joint to a value and confirm Fusion kept it. Angles are in degrees unless units='rad'; slide values are lengths in cm and are never converted. Works on as-built joints unless as_built=False. Fusion resets joint values to zero on the next design.computeAll(), so avoid recomputing after this call - the command itself does not.

List all components in the design

Export a body or component as a STEP file

Export the design as a native Fusion 360 archive (.f3d)

Render canonical orthographic + isometric views as PNGs and emit a self-contained HTML sheet suitable for sharing with a mechanical engineer. Opens in any browser; Print -> Save as PDF for a static artifact. Restores the viewport camera after rendering.

Unified export wrapper — dispatches to export_stl / export_step / export_f3d based on format or file extension. Format is auto-detected from file_path extension if not specified. STL and STEP require body_name; F3D exports the whole design.

Import a mesh file (STL, OBJ, or 3MF) as a mesh body. Returns the mesh name and bounding box. Use for reference geometry (e.g. exported SketchUp model).

List all user parameters in the design

Create a new user parameter

Update the value of an existing user parameter

Remove a user parameter

Add several equally spaced circles to the most recent sketch in a single solve. Fusion re-solves the sketch on every entity insert, so adding circles one per call is superlinear in the entity count; this defers the solve across all inserts and restores the previous state afterwards. Measured at 100 circles: 68 ms against 912 ms for the same inserts one at a time.

Add a geometric constraint in the active sketch. Entities are referenced by index within the sketch.

Automatically add geometric constraints and dimensions to fully constrain a sketch (Fusion 2026+ AutoConstrain API). result_option: 1 = thorough/slow (default), 2 = fast, 3 = may move geometry within tolerance.

Add a driving dimension to constrain sketch geometry. Value is in cm for distances, degrees for angles.

Create a construction plane for sketching

Create a construction axis

Create a UCS at (x, y, z) with optional rotation (Fusion 2026+ UCS API, preview). A hidden reference sketch is created to anchor the UCS — do not delete it.

Draw a spline in the most recent sketch. Use fit_points for a curve through points, or control_points for a control-polygon spline.

Offset connected sketch curves by a distance. Direction is determined by the direction_point.

Trim a sketch curve at its intersections. The segment nearest to the given point is removed.

Extend a sketch curve to the nearest intersection. The end nearest to the given point is extended.

Add threads to a cylindrical face (cosmetic or modeled)

Add a draft angle to faces of a body (for mold release / injection molding)

Split a body using a plane or face

Split faces of a body using a plane

Push/pull faces of a body by a distance

Scale a body uniformly or non-uniformly

Create a box primitive (non-parametric via TemporaryBRepManager)

Create a history-based rectangular box via sketch rectangle + extrude (unlike create_box which uses TemporaryBRepManager). length/width/height accept a number (cm, Fusion internal unit) or a string expression referencing User Parameters (e.g. 'boxL', '56 mm', 'outer - 2 * wall_t'). Call create_parameter first to define named parameters.

Create a cylinder primitive (non-parametric via TemporaryBRepManager)

Create a sphere primitive (non-parametric via TemporaryBRepManager)

Create a torus primitive (non-parametric via TemporaryBRepManager)

Create a joint that keeps both components exactly where they are, capturing the current pose instead of enforcing a new one. Use this when the parts are already positioned correctly; add_joint instead moves components to make the joint geometry coincident. Fusion needs a face pair (face_one/face_two) for every joint type except rigid.

Lock multiple components together

Measure minimum distance between two entities

Measure angle between two entities

Get mass, volume, surface area, center of mass, and density of a body

Cut a section plane through the model

Detect collisions between components/bodies

Compare two mesh bodies and return deviation statistics (min/max/mean/RMS signed distance in cm) — e.g. validate an imported STL against a reference mesh. Requires Fusion 2026+.

Assign a material appearance to a body, face, or component from the Fusion appearance library

Assign a flat RGB color to a body (creates/reuses a design-local appearance). Useful for visually distinguishing parts before render_view.

Project edges or bodies onto the active sketch plane

Suppress (disable) a feature in the timeline

Unsuppress (re-enable) a feature in the timeline

Create a patch surface from boundary edges

Stitch surface bodies into a single body

Thicken a surface body into a solid

Create a ruled surface from an edge or sketch curve

Trim a surface body with another body

Create a sheet metal flange on an edge

Add a bend to a sheet metal body

Create a flat pattern from a sheet metal body

Unfold specific bends in a sheet metal body

Create a manufacturing setup for a body. Defines the stock, coordinate system, and operation type (milling/turning/cutting).

Add a machining operation to a setup. Strategy determines the toolpath type.

Generate toolpaths for a specific operation or all operations in a setup

Post-process toolpaths to generate NC code (G-code)

List all manufacturing setups in the document

List operations within a setup

Get details about a specific operation (strategy, tool, parameters, toolpath status)

Health check — returns immediately without touching Fusion API

Check if the design is in parametric or direct mode. Use this to detect accidental mode switches.

Switch design type between 'parametric' and 'direct'. Use 'parametric' to recover from accidental direct-mode switches (equivalent to Capture Design History in the UI).

Capture the active viewport as a PNG so you can visually verify the model. Pass a canonical view (iso/front/top/etc.) to reposition the camera first, or 'current' to keep it as is. Returns base64-encoded image bytes alongside metadata; the MCP server delivers it as an image content block.