Docs · Agents & MCP

Your AI, working
in real CAD.

Axle Keys is operable by AI. You bring your own assistant — Claude, ChatGPT, or any MCP-compatible agent — and connect it to your projects with a single URL. It then works through the same controlled tools a person uses in Studio: reading models, writing model code, adjusting parameters, checking geometry, and producing drawings, cut lists, and renders.

Physical objects need more than a good prompt. They need context, rules, validation, and review — which is what the tools, the skills, and the draft workflow on this page are for.

Connect your AI

One URL.
No install.

Axle Keys is a hosted MCP server. Add it as a connector in Claude or ChatGPT, sign in with your Axle account, and approve — there is nothing to download and no API key to manage on this path.

MCP endpointhttps://api.axlekeys.com/mcp

Model builds run on Axle's servers, so your agent can work whether or not you have a Studio tab open. If you do have one open, you'll watch the model change as the agent works.

Step-by-step setup for each app lives on the Connect page → Local tools such as Claude Code can also connect over stdio with an API key from your Account page.

The basic idea

One agent.
Many kinds of work.

Axle Keys does not run a hidden crowd of AI agents behind your back. Your agent is the one doing the thinking — Axle supplies the tools it acts through, and the knowledge it needs to act well.

What the system has to understand

—What is the user trying to build?
—What System does it belong to?
—What files are available?
—What model already exists?
—What parts are involved?
—What parameters should be exposed?
—What code should change?
—Did the model build correctly?
—Did the geometry fail?
—What should be repaired?
—What should the user approve?

The safest agent is not the most autonomous one. The safest agent knows its job, uses the right context, and makes changes in reviewable steps.

Working modes

Six hats, one agent.

Building an object involves distinct kinds of thinking, and the skill pack covers each — in its master file or in a section of its own. These are hats your agent puts on as the work demands — not separate agents Axle runs on your behalf. Not every request needs every one: a parameter change may need none of them, a new model may walk the chain.

Plan the project→Plan the geometry→Design parameters→Write the code→Validate→Repair
Plan the project
Orient first

Establish what the user is trying to build and what already exists — the open model, the bound Systems, the files on the project. The single biggest source of bad output is an agent guessing at context that was available to read.

Plan the geometry
Before any code

Turn the request into a modelling plan: object type, the main parts, how they relate in space, the build sequence, and the things that genuinely need confirming with the user before work starts.

Design parameters
Decide the controls

Choose which dimensions and options become editable, with labels, safe ranges, and sensible defaults — and which stay internal. The goal is useful control, not endless control.

Write the code
Build the model

Author or update the model code. Read the existing model before changing it, preserve what works, and make focused changes. Geometry comes from deterministic code, so the model is built rather than guessed.

Validate
Prove it

Confirm the model actually built, and measure it against the dimensions that were asked for. Axle returns the build verdict inline on every write, so an agent never has to assume its change worked.

Repair
Smallest useful fix

When something fails, identify the failure and make the smallest change that fixes it — not a redesign. Read the error, inspect the current model, preserve working parts, re-validate.

Reading references

One section for whatever
the user attached.

A photo, a DXF, a spec sheet, a client brief — the skill pack has one section, reading-references, on turning any of them into geometry your agent can defend. It replaced three role prompts from the archived multi-agent pipeline; the craft survives, addressed to the one agent doing the work.

Pictures

Turn images, sketches, screenshots, or visual references into project context — object type, proportions, visible parts, style cues, layout, likely dimensions, and areas that need confirmation. Useful when the user uploads reference images.

Technical files

Read drawings, manuals, diagrams, specifications, or CAD files — extracting dimensions, constraints, material references, part names, hardware references, tolerances, and warnings.

Written briefs

Turn notes, emails, client descriptions, or project instructions into structured requirements — goals, constraints, object types, dimensions, user preferences, missing information, and action items.

Build-System knowledge

The domain sections apply the conventions of a way of building — panels, openings, shelves, material thickness, edge banding, or extrusion profiles, cut lengths, brackets and clearances — so the model follows how that thing is actually made. Depth here grows with each System.

Skills

Reusable knowledge
for repeatable work.

A skill is a reusable packet of knowledge, instructions, rules, examples, or tool guidance. Without skills, agents guess. With skills, agents follow established patterns.

The agent is the role

The skill is the knowledge

The tool is the action

The project is the context

Skills make the workflow consistent: same startup process, same routing logic, same validation approach, same System rules, same repair process. A skill is not just documentation for humans — it is operational context for agents.

Master Skill

Entry point for an agent session. Defines what to do at startup: identify the active model, load the sections the job needs, read existing model code before changing it, use drafts for meaningful changes, and validate before promoting.

Working-mode skills

The master file carries orientation, the build loop, and how to verify a result; four sections go deeper on one kind of thinking each — writing code, revising an existing model, designing parameters, and repairing a failed build. Each describes what to read first, what to produce, and what to do when something fails.

System skills

Describe a way of building. Open Design is the live base every model starts from; named Systems add the parts, rules, material defaults, constraints, and checks of a specific build methodology. This is what makes an agent more useful here than a generic CAD helper.

API and tool skills

How to use the modelling API and the platform's tools correctly — the geometry API reference, view rules, and tool guidance. Keeps agents from inventing actions that don't exist.

Example skills

Working patterns — a piece of furniture, a frame, a curved form, a sound parameter setup, a known repair. Agents perform better with a known pattern to follow.

Draft. Validate.
Promote after review.

Axle Keys works with physical objects, so the safe pattern is to stage a change, check it, and promote it after review — the same pattern whether a human or an agent is driving. A direct write to the live model exists and is fast; the drafts room is what makes a change reversible.

01ReadInspect the active model, code, parameters, and files.
→
02DraftStage changes without touching the live project.
→
03ValidateCheck syntax, build status, and geometry correctness.
→
04PromoteMake the draft live. Previous version is snapshotted.
→
05ReviewConfirm the result is what was intended.
→
06ExportRun a job for fabrication output or downstream use.

When review matters most

  • —Changes to model code
  • —Fabrication outputs
  • —Published configurators and public links
  • —Billing and plan changes
  • —Account settings
  • —Destructive actions
  • —Public visibility changes
  • —Safety-sensitive details

What agents should never do

  • —Guess when project context already exists
  • —Overwrite live models without review
  • —Rewrite working code unnecessarily
  • —Ignore validation failures
  • —Claim a model is fabrication-ready without review
  • —Expose private files, or make something public the owner did not ask for
  • —Spend money or change account settings without approval
How the pieces fit

Tools, skills,
and context.

Four layers, and it helps to keep them straight. Your agent reasons; skills tell it how this platform expects work to be done; tools are the actions it can actually take; Systems and the project supply the context those actions happen inside.

Your agentthe reasoning
Skillshow to work here
MCP toolsthe actions
Systems & projectthe context
● Hosted MCP

Connect by URL.

The recommended path. Add the endpoint as a connector in Claude or ChatGPT, sign in, approve — no install, no keys. Builds run server-side, so your agent works with or without a Studio tab open.

→ Claude — custom connector→ ChatGPT — MCP connector, OAuth→ Any MCP-compatible client→ Revoke access anytime from Account
● Local / stdio

For local tools.

For a coding agent running on your own machine — Claude Code or your own MCP client — connect over stdio with an API key from your Account page. Same projects, different front door: the local client lists all of its tools up front, while the hosted endpoint lists a core set and reaches more through Code Mode. Codex connects to the hosted URL with an API key; if its tool calls fail on your network, switch it to the local client.

→ Claude Code→ Your own MCP client→ API keys managed in Account
Tool rooms

Tools grouped
by purpose.

Tools are organised into rooms so the toolset stays understandable as it grows. The main rooms are below; the full list is served from the endpoint itself, so a connected agent always sees the current set rather than whatever was true when it was installed.

01

Session

Orient the agent — which project and workspace is open, what the user is looking at, and which Systems are bound.

02

Models

Read and write model code, create projects and models, and see the result as an image.

03

Parameters

Adjust dimensions, counts, and options without rewriting model code.

04

Assembly

Compose multi-part assemblies — instances, constraints, and mates between parts.

05

Validation

Check the build, measure against the dimensions that were asked for, and certify a model.

06

Drafts

Stage, validate, promote, and roll back changes safely.

07

Materials

Define the stock a product may be built from, and assign it across parts.

08

Parts

Name, group, and organise the parts a model is made of.

09

Drawings

Produce dimensioned shop drawings, lint them, and export SVG, PDF, or DXF.

10

Cut list

Tabulate parts and nest them onto real sheet stock.

11

Motion

Author assembly sequences and render animation or video.

12

View

Drive the user's live Studio tab — navigate, capture the viewport, read UI state.

13

Files

Upload, list, and assign roles to reference files.

14

Jobs

Create and track longer operations — exports, renders, batch runs.

15

Exports

Download finished fabrication output via signed URL.

16

Knowledge

Load System rules and skills, search what the platform knows, and record lessons.

Related pages

Structured work
produces better objects.

Reusable knowledge, real validation, and reversible changes make agent-assisted CAD more reliable — not less. Connect your assistant and give it something real to build.