CONNECT YOUR AGENT
A CAD MCP server. A live view of the work.
A CAD MCP server exposes modeling and inspection tools to an AI assistant through the Model Context Protocol. FORM provides a hosted MCP endpoint at https://app.formgeometry.com/api/mcp. The endpoint relays modeling operations to your open, signed-in browser workspace, where the geometry is calculated.
How do I connect an AI assistant to FORM?
- Open the FORM workspace and sign in to your account.
- Open Connect agent and choose your AI client. Follow the client-specific instructions shown there.
- Add FORM as a remote MCP server using the endpoint below. Choose Streamable HTTP where your client asks for a transport.
- Authenticate with FORM through the browser approval flow if your client supports OAuth. For clients using headers, generate a FORM API key and put it in the client’s MCP configuration.
- Keep the workspace open, enable FORM’s tools in your assistant, and make a read-only request first.
https://app.formgeometry.com/api/mcpCompatible clients need remote MCP support and a supported authentication method. Available connection options depend on the client version and workspace permissions; the in-app setup panel is the place to start.
What should I ask the agent first?
Use FORM to list my projects and describe the current model. Do not change anything yet.
Check that the assistant identifies the expected project. Then ask it to create one simple object with explicit units and dimensions. Confirm that the new object appears in the same workspace before attempting a multi-part design.
When you have several projects or browser tabs open, name the intended project explicitly. A successful connection only proves the server is reachable; a visible, verified modeling change confirms the full path to the browser.
Can I connect with an API key?
Yes. Clients that accept a remote URL and custom headers can use a FORM API key. This example uses the common JSON configuration shape; some clients use different property names. Copy the version provided by FORM for your client.
{
"mcpServers": {
"form": {
"url": "https://app.formgeometry.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_FORM_API_KEY"
}
}
}
}Replace the placeholder in your local MCP settings. Keep the key out of chat messages, screenshots, and shared repositories. See Cursor’s MCP documentation for one client that supports remote server configuration.
What can an agent do through CAD MCP?
FORM exposes tools for creating and updating geometry, organizing objects, inspecting a document, changing parameters, working with NURBS curves and surfaces, exporting files, and undoing changes. Supported operations are defined by FORM’s current tool interface.
MCP standardizes the connection between the client and its tools. It does not make every CAD application interchangeable or add unsupported modeling operations. See the official MCP architecture guide for the protocol model.
Why is the agent connected but nothing is changing?
- No live workspace: reopen FORM, sign in, and keep the intended project open. The hosted workflow needs the browser to execute modeling commands.
- Tools unavailable: confirm that FORM is enabled in the client and reconnect or start a fresh conversation after setup.
- Authentication failed: repeat the authorization flow, or check that the API key belongs to the account signed in to the workspace.
- An operation failed: ask the agent to inspect the current document and report the error before retrying. Reduce a complex change to a small operation you can verify.
New account projects are public by default and can share a display preview in Community. Choose Private for a project you do not want shown there. Source documents and exported files stay restricted to your account; see FORM’s privacy notice.
Written by the FORM team. Product details can change; the linked references and current workspace describe the available workflow. Tell us if something needs correcting.