Tools and Language Support

The Autodesk Inventor MCP Server exposes tools for working with Inventor documents, parameters, properties, assemblies, representations, materials, and iLogic rules. This reference reflects the tools available in Inventor 2027.2. Your AI client always shows the tools that your installed version provides, so the list may differ after updates.

Important:

Several tools modify your documents, files on disk, or Inventor settings. execute_python_script and execute_ilogic_code run code with your Windows user permissions. Python scripts are screened for unsafe modules, but this screening is not a sandbox. Review code and proposed changes before you approve them, and back up important files first.

Tools that only read data are marked as read-only, so some AI clients can run them without asking for approval. Tools that change documents, files, or settings are marked as such, and AI clients typically ask before running them. Approval behavior depends on your AI client and its settings.

Tool reference

The following table describes the tools available in the Autodesk Inventor MCP Server.

Files and documents

Tool Purpose / when to use it
get_file_information Retrieves detailed filesystem information about a file.
open_file Opens an Inventor file by path. Supports an optional Model State to open with a specific Model State active, and an optional openVisibleAndActivated parameter to control document visibility. Supports part (.ipt), assembly (.iam), drawing (.idw, .dwg), and presentation (.ipn) files.
get_files Retrieves a paginated list of files from a specified folder with optional filtering. Designed to handle large directories efficiently. Supports filtering by file extensions (for example, ["*.ipt", "*.iam"]), recursive directory search, and pagination with a fixed page size of 50. Results are cached for about 3 minutes to speed up pagination across multiple page requests.
close_documents Closes one or more Inventor documents by path, optionally all open documents, or the active document when no paths are given.
get_all_open_documents Lists all currently open Inventor documents with comprehensive information including file path, display name, document type, active Model State, up-to-date status, dirty status, and units. Optionally filters by visibility. Uses pagination with a fixed page size of 50. Cache auto-invalidates when documents are modified or closed.
get_document_info Gets information about the active Inventor document, or one specified by document.
save_document Persists the active or target document's edits to disk. Supports both in-place save and Save As via an optional outputPath. In-place save only writes when there are unsaved changes. Save As writes the document to a new location; saveCopyAs=true writes a copy and leaves the active document on its original path. Prefer supplying outputPath to save a newly created document without a dialog. If a file already exists at outputPath, it is overwritten without a confirmation prompt. This tool does not connect to Vault — check out Vault-managed files before saving them.
get_document_settings Retrieves comprehensive document-level settings including units, material, lighting, BOM settings, sketch grid configuration, display options, parameter settings, and drawing sheet preferences.
get_document_selections Returns the objects currently selected in the active document.
find_document_objects Finds objects in a document by object type and name. Supports component occurrences, part features, work features, constraints, drawing views, surface bodies, sketches, and drawing elements. Can find all objects of a type or filter by name, and optionally perform actions on the found objects, such as selecting, renaming, suppressing or unsuppressing, and hiding or showing them.
update_document Updates out-of-date entities in a document and forces a recompute of out-of-date entities. Entities become out-of-date when their referenced files or dependencies are modified.
export_document_as_pdf Exports one or more Inventor documents as PDF files. Supports drawing-only PDF options such as all-color-as-black, remove line weights, vector resolution, and sheet ranges. For drawings, only the current sheet is exported unless you ask for all sheets or a sheet range. If no output path is given, the PDF is saved next to the document. Returns batch results with per-item output paths.
export_document_as_image Exports one or more Inventor documents as image files (BMP, JPEG, PNG, TIFF, GIF). Supports width, height, image type, transparent background, and background colors. Returns batch results with per-item output paths.
edit_document_settings Edits document-level configuration including units, lighting, material and appearance assignments, BOM settings, sketch grid settings, display options, parameter settings, and drawing sheet preferences. Only supplied fields are changed. This tool changes settings — it does not recompute the model; use update_document when geometry or references need refreshing.

Properties

Tool Purpose / when to use it
get_document_property_sets Retrieves all iProperty sets available in an Inventor document. Property sets do not differ between Model States.
get_document_properties Gets properties and their values from all property sets in one or more Inventor documents. Accepts a documents array for batch queries. Properties include author, title, material, mass, custom properties, and more.
get_occurrence_properties Retrieves all instance properties for a component occurrence. Instance properties can differ from the document properties. The document parameter must refer to the assembly document (.iam file) containing the occurrence, not the component's own document file.
edit_properties Edits one or more properties in Inventor documents or component occurrences (adds custom or instance properties when the display name does not yet exist). Supports batch operations across multiple documents, Model States, property types, or occurrences in a single call.
delete_properties Deletes one or more properties from Inventor documents or component occurrences. Supports batch operations. If any request fails, the entire operation fails and no deletions are committed.

Parameters

Tool Purpose / when to use it
get_document_parameters Gets all parameters from an Inventor document, or a specific parameter if paramName is provided.
create_user_parameter Creates a new user parameter in an Inventor document. The value parameter accepts a number, a boolean, or an expression (for example, d0 * 2). Units must be specified (for example, in, mm, deg).
edit_parameter Edits properties of an existing parameter. Only the specified properties are changed. After successful edits, the model may be out of date — use update_document to recompute.
delete_parameters Deletes one or more user parameters from an Inventor document. Only user parameters can be deleted; model, reference, and derived parameters cannot. All parameter names are validated before any deletion begins.

Views

Tool Purpose / when to use it
set_view Sets the camera to a standard view: Front, Back, Left, Right, Top, Bottom, or Isometric. Works in part, assembly, presentation, and iFeature documents. Drawings are not supported because they have no 3D camera.

Components

Tool Purpose / when to use it
place_component Inserts an existing Inventor component (part .ipt or subassembly .iam) into the active host assembly as a new occurrence. By default, auto-drops the component at the model origin, ungrounded; positions it interactively only on explicit request; and grounds it only when grounded: true is explicitly passed. Works with an active assembly document only. This tool does not connect to Vault — check out Vault-managed files before placing them.
get_component_states Gets detailed state information for component occurrences in an Inventor assembly. Returns visibility, suppression, enabled, transparency, selection, grounded, excluded, BOM structure states, and parent path for nested components. By default, returns only components with non-default states to minimize response size for large assemblies.
set_component_state Modifies the state of component occurrences in an Inventor assembly. Can modify visibility, suppression, enabled, grounded, transparent, excluded, and BOM structure states, and can switch the iPart or iAssembly member or the Model State of an occurrence. Can change several occurrences in one call. Only specified states are changed.
get_referenced_components Gets referenced components from an Inventor part document — derived components, imported components, iFeature components, and shrinkwrap components — including name, type, referenced file path, link status, embedded status, and health status. Works with part documents only (.ipt files).

Representations

Tool Purpose / when to use it
get_representations Gets all available representations from an Inventor part or assembly document — Model States, Design View Representations, Positional Representations, and sheet metal state. Also returns iPart/iAssembly/ModelState factory status.
get_member_table Gets table data for iPart/iAssembly/ModelState factories, showing all members/rows with their complete variation data. Use this tool to compare factory members. The table includes every value that differs between members.
edit_member_table Edits cell values in iPart/iAssembly/ModelState factory tables and optionally sets the default/active row. All edits are processed within a single transaction.
edit_representation Edits representations in an Inventor part, assembly, or drawing document — create, activate, delete, rename, or edit them. Supports Model States, Positional Representations, Design View Representations, Drawing Sheets, and iPart/iAssembly members, and can switch a sheet metal part between folded and flat pattern. Edits include Model State generate-on-save, member edit scope, and Model State BOM references (assemblies only). The active representation cannot be deleted; activate a different one first.

Projects and materials

Tool Purpose / when to use it
get_project_info Gets information about the active Inventor project, or one specified by file path. Can query information about any project by file path, whether it is currently active or not.
find_materials Finds material or appearance information from an Inventor document. Returns a list of all available materials or appearances in the document and asset libraries. Can filter results by properties like name, description, category, keywords, and usage status using regular expressions. Materials are available in part documents; appearances are available in part and assembly documents.

Scripting guidance

Tool Purpose / when to use it
get_script_documentation Returns scripting guidance and API reference. Set docType to ILOGIC for iLogic coding guidelines, PYTHON for the Python author guide, or INVENTORAPI with a query (for example, Documents.Add or DocumentTypeEnum) to look up an Inventor API interface, member, or enum.

iLogic

Tool Purpose / when to use it
execute_ilogic_code Executes ad-hoc VB.NET iLogic code against an Inventor document. Code runs in a temporary external rule file. To run an existing saved rule, use run_ilogic_rule instead. Runs outside an Inventor transaction, so code that fails partway may leave partial changes.
list_ilogic_rules_and_forms Lists iLogic rules and iLogic forms with metadata. Rules include name, active/suppressed status, auto-fire settings; forms include name and location (internal/external).
read_ilogic_rule Reads the metadata and full VB.NET source code for one specific iLogic rule. Use list_ilogic_rules_and_forms first for discovery, then read_ilogic_rule to inspect a specific rule.
run_ilogic_rule Runs an existing iLogic rule by name. Supports both internal document rules and external rule files. Prefer this over execute_ilogic_code when the user's existing rule already accomplishes the task. Runs outside an Inventor transaction, so a rule that fails partway may leave partial changes. Supports a security check (check_only) that reports flagged APIs without running the rule. Saved rules can open dialog boxes in Inventor; the call waits until you respond.
create_ilogic_rule Creates a new iLogic rule (create-only — fails if the rule already exists). For internal rules, adds to the document. For external rules, creates a new file on disk in a configured external rule directory. Compile errors are reported, but the rule is still created.
edit_ilogic_rule Modifies an existing iLogic rule. Can update source code, toggle active state, and rename. Supports partial edit modes: replace, prepend, append, and find_replace. Rules authored as code blocks can be renamed or suppressed, but their source cannot be edited. Edits to external rule files are saved immediately and cannot be undone.
delete_ilogic_rule Deletes an iLogic rule. Internal rules are removed inside an Inventor transaction and can be undone with Undo (Ctrl+Z) while the document is open. Directory-based external rule files are moved to the Windows Recycle Bin. For manually added external rules, only the entry is removed from the iLogic configuration by default; the file stays on disk unless you ask to delete it too, in which case it is moved to the Recycle Bin.
manage_external_rule_directories Adds or removes a directory in the user-scoped iLogic External Rule Directories configuration list. Changes a user-level setting that applies to all documents and Inventor sessions, and cannot be undone.

Python automation

Tool Purpose / when to use it
execute_python_script Runs inline Python code or a .py file against the running Inventor session. Provide exactly one of script or scriptPath. Requires Python 3.13 or later, set in Application Options > File > Python Executable or available on PATH. Scripts that import modules such as os, subprocess, pathlib, io, or network libraries, or that call exec/eval, are blocked. Runs time out after 30 seconds by default (maximum 300); a script that times out is stopped.

Event triggers

Tool Purpose / when to use it
get_event_triggers Lists iLogic event triggers (the rules that run on document/application events) for either the global event triggers or a specific document.
edit_event_triggers Edits event triggers for one target (a single global scope or a single document) via a batch of operations — add, delete, and reorder. Document-target edits run in an Inventor transaction — atomic and undoable. Global-target edits are application-global and not undoable.

The tools are designed to be chained. Follow this order for common goals:

Goal Tools (typical order)
Inspect a document open_file → get_document_info → get_document_parameters
Change a dimension get_document_parameters → edit_parameter → update_document
Compare Model States get_member_table
Place a component open_file (assembly) → place_component
Export a drawing open_file (drawing) → export_document_as_pdf
Run an existing rule list_ilogic_rules_and_forms → run_ilogic_rule
Write new iLogic code get_script_documentation (ILOGIC) → create_ilogic_rule
Write a Python script get_script_documentation (PYTHON) → execute_python_script
Run Python automation execute_python_script

Language support

Response language is determined by your MCP client and assistant — ask in the language you want the answer. The server itself does not take a locale parameter; document values such as dimensions and masses are returned in the document's own units and should be reported exactly as returned.

Resources and prompts

This server does not expose MCP resources or prompts. Only the tools capability is advertised.