Fusion Toolsmith Mcp

Fusion Toolsmith MCP

Safety-first, diagnostic, tool-first Autodesk Fusion 360 MCP server for serious agent-assisted CAD work.

Choose Toolsmith when you want guarded workflows, runtime diagnostics, and structured Fusion tools before raw scripts. Choose a simpler Fusion MCP server when you only need a minimal bridge into Fusion and are comfortable managing safety yourself.

Quick Start

Requirements: Windows, Autodesk Fusion 360, Python 3.9 or newer, and an MCP-capable client.

git clone https://github.com/NeonN3mesis/fusion-toolsmith-mcp.git
cd fusion-toolsmith-mcp
python -m pip install -e .
fusion-mcp install-addin

Start the add-in in Fusion 360:

Utilities > Add-Ins > Scripts and Add-Ins > Add-Ins > FusionMCP > Run

Verify it:

fusion-mcp doctor
fusion-mcp test-live

The installed Fusion add-in folder is named FusionMCP for compatibility with existing local installs. The add-in is opt-in by default and does not start automatically with Fusion.

Client Config

After the add-in is running, print client snippets:

fusion-mcp print-client-config

Prefer the Streamable HTTP endpoint with bearer auth when your client supports headers. Legacy SSE/query-token support remains for older clients.

FusionMCP writes live discovery data to:

C:\Users\\.fusion_mcp.json

For Antigravity/Gemini-style config, the add-in auto-syncs:

C:\Users\\.gemini\config\mcp_config.json

Why Toolsmith

Generic Fusion MCP servers often expose a raw script bridge. Toolsmith adds a careful CAD workflow around that bridge:

• inspect the live model before editing
• prefer structured tools before raw Fusion API scripts
• preflight model changes and exports
• isolate dangerous tools from normal profiles
• record a redacted local change journal
• diagnose stale installs, missing tools, task backlog, and auth/config issues

What It Is Good At

• Existing-design inspection: sketches, features, parameters, projected geometry, dependencies, selection sets, assemblies, and physical properties.
• Safer model mutation: explicit modeling tools, profile-loop operations, insert/socket workflows, validation, and before/after design-state comparisons.
• Export and presentation: preflighted STL/STEP/3MF/PDF/Fusion archive exports, multibody 3MF planning, screenshots, viewport staging, and demo capture.
• Local runtime hardening: fixed port 9100, bearer-token support, token-free /health, session cleanup, backpressure diagnostics, and stale-source fingerprint checks.

Common Fix

If the server is reachable but tools are missing or old behavior remains after an update, stop and run the FusionMCP add-in again from Fusion 360, or restart Fusion. Fusion can keep old Python modules loaded after files are replaced.

Documentation

• [Installation and troubleshooting](docs/installation.md)
• [Client configuration](docs/client-config.md)
• [Features and tool profiles](docs/features.md)
• [Safety model](docs/safety-model.md)
• [Development and releases](docs/development.md)
• [Mock payload examples](docs/mock-payload-examples.md)
• [Tooling roadmap](docs/tooling-roadmap.md)
• [External Fusion MCP comparison notes](docs/external-fusion-mcp-sweep.md)
• [Starter prompts](examples/prompts.md)

Development

python -m unittest discover -s tests
fusion-mcp dump-schemas --output dist\mcp-schemas.json
fusion-mcp package-addin

GitHub Actions runs the unit suite, checks the no-Fusion mock/schema surfaces, and builds the add-in ZIP on pushes and pull requests.

License

MIT. See [LICENSE](LICENSE).

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: NeonN3mesis
• Source: NeonN3mesis/fusion-toolsmith-mcp
• License: MIT

Install and usage instructions live in the source repository linked above.