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.
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. |
Recommended workflow
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.