CAD MCP server for Claude, Cursor & more
Free, hosted, nothing to install
Connect BuildCAD AI to any AI assistant with our MCP server. Your AI writes parametric CAD, sees renders and print checks, and saves parts you download as STEP, STL or 3MF, with your own AI subscription.
https://buildcad.ai/api/mcpUse BuildCAD AI to design a spur gear pair: module 1.5, 20 and 40 teeth, 8 mm bores with a keyway. Check it and save it.
Saved. Both gears are valid solids and mesh at a 45 mm centre distance. Open it in BuildCAD to change the teeth or the bores with the sliders, and download STL, 3MF or STEP.

Spur gear pair
buildcad.ai

Works with the AI apps and coding tools you already use
How it works
Connected in two minutes, no API key
Add the URL to your AI app
Claude, ChatGPT, Gemini, Cursor and the others each have a setting to add a connector or MCP server. Paste the URL; leave everything else as it is.
Sign in to BuildCAD and click Allow
A BuildCAD window opens. Sign in with Google (a free account is created if you don't have one) and allow the app to use your designs.
Ask for a part
Mention BuildCAD in your message. Your AI writes the model, checks it, and saves it; open it in BuildCAD to move sliders and download.
A connected app can read and save your designs and run models. It can't spend your credits, see your billing or change your account.
Setup guide
Pick your AI app
The steps for each app, the plan it needs, how to check it worked, and what to do if it doesn't.
Connect Claude
claude.ai, desktop and mobile apps
What you need. Any plan. Free plans can add one custom connector. On Team and Enterprise, an Owner adds it once in Organization settings, then you click Connect.
- 01Click Add to Claude above, or open Customize > Connectors in Claude, click + Add, then Add custom connector.
- 02Name:
BuildCAD AI. URL:https://buildcad.ai/api/mcp. Leave the other settings as they are and click Add. - 03Click Connect. A BuildCAD window opens: sign in (or create a free account) and click Allow.
- 04In a chat, click + > Connectors and check that BuildCAD AI is on.
Check it worked
Ask Claude: “Use BuildCAD AI to list my designs.” You get your designs, or a note that you have none yet.
If it doesn't work
- Add custom connector is greyed out: on the Free plan you already have one custom connector. Remove it, or upgrade.
- Claude answers without using BuildCAD: turn it on under + > Connectors for that chat, and say "Use BuildCAD AI" in your message.
- Team or Enterprise: ask a workspace Owner to add the connector first.
Connect ChatGPT
chatgpt.com
What you need. A plan with developer mode or custom apps. In Business and Enterprise workspaces an admin may need to allow custom MCP servers.
- 01Open chatgpt.com/plugins, click +, then Add custom MCP server. If you don't see it, turn on Developer mode in Settings > Security and login.
- 02Name:
BuildCAD AI. Description:Design 3D-printable parts. Connection: public endpointhttps://buildcad.ai/api/mcp. Authentication: OAuth. - 03Confirm with I understand and want to continue, then create it and install it.
- 04A BuildCAD window opens: sign in (or create a free account) and click Allow.
- 05In a new chat, type @ and pick BuildCAD AI.
Check it worked
Ask ChatGPT: “@BuildCAD AI list my designs.” You get your designs, or a note that you have none yet.
If it doesn't work
- No + or custom server option: turn on developer mode, or ask your workspace admin to allow custom apps.
- ChatGPT doesn't use BuildCAD: start the message with @BuildCAD AI.
Connect Gemini
gemini.google.com
What you need. A personal Google account where Google offers custom connected apps (it is still rolling out: if you don't see + Custom, your account doesn't have it yet). No client ID or secret needed.
- 01On a computer, open Customize > Connectors in Gemini.
- 02Click + Custom. In Connect to an MCP server, paste
https://buildcad.ai/api/mcp. - 03Leave Additional settings closed. You don't need a client ID or secret: Gemini registers itself with BuildCAD. Click Next.
- 04A BuildCAD window opens: sign in (or create a free account) and click Allow. You land back in Gemini.
- 05In a chat, type @ and pick BuildCAD AI.
Check it worked
Ask Gemini: “@BuildCAD AI list my designs.” You get your designs, or a note that you have none yet.
If it doesn't work
- No + Custom button: Google hasn't opened custom apps for your account yet (work and school accounts, and some countries, don't have it). Use Claude or ChatGPT meanwhile: same account, same designs.
- Gemini asks for a Client ID and Secret: leave them empty. Those fields are only for servers that can't register Gemini automatically.
- It doesn't connect after you click Allow: try a browser window signed in only to the Google account you use in Gemini, then add the app again.
Connect Grok
grok.com
What you need. A grok.com account with connectors.
- 01Open grok.com/connectors and click New Connector, then Custom.
- 02Paste
https://buildcad.ai/api/mcpand click Connect. Allow pop-ups from grok.com if your browser asks. - 03A BuildCAD window opens: sign in (or create a free account) and click Allow.
Check it worked
Ask Grok: “Use BuildCAD AI to list my designs.”
If it doesn't work
- Nothing opens when you click Connect: your browser blocked the pop-up. Allow pop-ups for grok.com and try again.
Connect Perplexity
perplexity.ai (web)
What you need. A paid Perplexity plan. Web only.
- 01In Perplexity, open Settings > Connectors and add a custom connector.
- 02Paste
https://buildcad.ai/api/mcpand choose OAuth. - 03A BuildCAD window opens: sign in (or create a free account) and click Allow.
Check it worked
Ask Perplexity: “Use BuildCAD AI to list my designs.”
If it doesn't work
- The connector option is missing: custom connectors need a paid plan and the web app.
Connect Claude Code
terminal, IDE extensions
What you need. Any Claude Code install.
Terminal
claude mcp add --transport http --scope user buildcad-ai https://buildcad.ai/api/mcp- 01Run the command above.
- 02In Claude Code, type
/mcp, pick buildcad-ai, then Authenticate. Sign in to BuildCAD and click Allow.
Check it worked
Run claude mcp list: you should see buildcad-ai marked Connected. Then ask: “Use BuildCAD AI to list my designs.”
If it doesn't work
- Already added on claude.ai? Claude Code shows your claude.ai connectors in
/mcpwhen you're logged in with the same account. No need to add it twice. - Needs authentication: run
/mcp, pick buildcad-ai and Authenticate again.
Connect Cursor
Cursor editor
What you need. Any Cursor plan.
~/.cursor/mcp.json
{
"mcpServers": {
"buildcad-ai": {
"url": "https://buildcad.ai/api/mcp"
}
}
}- 01Click Add to Cursor, or paste the config above into
~/.cursor/mcp.json(all projects) or.cursor/mcp.json(one project). - 02In Settings > Tools & MCP, click Needs login next to buildcad-ai. Sign in to BuildCAD and click Allow.
Check it worked
The server shows a green dot and 5 tools in Settings > Tools & MCP. Ask the agent: “Use BuildCAD AI to list my designs.”
If it doesn't work
- Red dot or no tools: toggle the server off and on, then click Needs login again.
Connect VS Code
GitHub Copilot agent mode
What you need. VS Code with GitHub Copilot. Your organization's Copilot policy can turn MCP servers off.
.vscode/mcp.json
{
"servers": {
"buildcad-ai": {
"type": "http",
"url": "https://buildcad.ai/api/mcp"
}
}
}- 01Click Add to VS Code, or create
.vscode/mcp.jsonwith the config above. In VS Code the key isservers, notmcpServers. - 02Open the Command Palette, run MCP: List Servers, pick buildcad-ai, then Start Server. Allow the sign-in, then sign in to BuildCAD and click Allow.
Check it worked
In Copilot Chat (agent mode), open Configure Tools: BuildCAD's 5 tools are listed. Ask: “Use BuildCAD AI to list my designs.”
If it doesn't work
- The server isn't listed: check the file uses
serversand"type": "http", then reload the window.
Connect Codex
Codex CLI, IDE extension, ChatGPT desktop app
What you need. Any Codex install. The CLI, the IDE extension and the ChatGPT desktop app share this config.
Terminal
codex mcp add buildcad-ai --url https://buildcad.ai/api/mcp
codex mcp login buildcad-ai~/.codex/config.toml (alternative)
[mcp_servers.buildcad-ai]
url = "https://buildcad.ai/api/mcp"- 01Run the two commands above. The second opens a BuildCAD window: sign in and click Allow.
Check it worked
Run codex mcp list, or /mcp inside Codex: buildcad-ai is listed. Then ask: “Use BuildCAD AI to list my designs.”
If it doesn't work
- Not logged in: run
codex mcp login buildcad-aiagain.
Connect Antigravity
Antigravity CLI and IDE, Gemini CLI
What you need. Antigravity (which replaced Gemini CLI for personal accounts), or Gemini CLI on a work or API-key account.
~/.gemini/config/mcp_config.json (Antigravity)
{
"mcpServers": {
"buildcad-ai": {
"serverUrl": "https://buildcad.ai/api/mcp"
}
}
}Gemini CLI
gemini mcp add -s user --transport http buildcad-ai https://buildcad.ai/api/mcp- 01Antigravity: add the config above. It uses
serverUrl, noturl. - 02Sign in: in the CLI, type
/mcpto open the MCP manager. In the IDE, open Agent settings > Customizations and click Authenticate. - 03Gemini CLI: run the command above, then
/mcp auth buildcad-ai.
Check it worked
/mcp shows buildcad-ai connected. Ask: “Use BuildCAD AI to list my designs.”
If it doesn't work
- Config ignored: Antigravity reads
serverUrl; Gemini CLI'shttpUrlwon't work there.
Connect Windsurf
Windsurf (Devin Desktop), Cascade
What you need. Any Windsurf install.
mcp_config.json
{
"mcpServers": {
"buildcad-ai": {
"serverUrl": "https://buildcad.ai/api/mcp"
}
}
}- 01In the Cascade panel, click ... then MCPs, then Open MCP config file, and add the config above (
serverUrl, noturl). - 02Save. Windsurf asks you to sign in: sign in to BuildCAD and click Allow.
Check it worked
The MCPs list shows buildcad-ai with 5 tools. Ask Cascade: “Use BuildCAD AI to list my designs.”
If it doesn't work
- No tools: refresh the MCPs list after saving the file.
Connect Other
opencode, pi, Zed, Goose, Kiro, any MCP client
What you need. Any client that supports remote MCP servers with OAuth.
Set up every agent on this computer
npx add-mcp https://buildcad.ai/api/mcp -gOr add it by hand
URL: https://buildcad.ai/api/mcp
Transport: Streamable HTTP
Auth: OAuth (sign-in window, no API key or headers)- 01
npx add-mcpfinds the agents installed on your computer and writes each one's config in its own format. - 02Or point your client at the URL. It registers itself with BuildCAD automatically (dynamic client registration and client metadata documents are both supported), then opens a sign-in window.
Check it worked
Ask your agent: “Use BuildCAD AI to list my designs.”
If it doesn't work
- Your client asks for an API key: BuildCAD has none. Choose OAuth, or a client that supports it.
Try it out
What to ask once you're connected
Start with the first one: it shows the connection works. Mentioning BuildCAD helps your AI choose the right tools.
Use BuildCAD AI to list my designs.
Use BuildCAD AI to design a 30 mm cube with a 10 mm hole through it, check it, and save it.
Use BuildCAD AI to design a wall hook for a 20 mm towel rail that prints without supports, then save it.
Make a Gridfinity 2x1 bin, 6 units tall, with a label lip, and save it to BuildCAD.
Open my latest BuildCAD design and make the walls 2.4 mm thick.
Add M3 screw holes in each corner of my bracket design, 4 mm from the edges.
CAD MCP tools
Everything your AI needs to design CAD
Your AI reads the guide, writes a model, runs it until the checks pass, and saves it: the same loop as our built-in designer.
get_cad_guide
How to write a parametric build123d model, plus 3D-printing defaults
list_designs
List all your CAD designs with IDs, names, and timestamps
get_design
Read the current Python code, parameters and checks of any design
run_model
Run CAD code on our build123d engine: errors, measurements, print checks, and iso + drawing renders
save_design
Save a version with history, then open it in BuildCAD AI to tweak sliders and download STL, 3MF or STEP
What is MCP?
Model Context Protocol: a universal plugin for AI
MCP is an open standard by Anthropic that lets AI assistants connect to external tools. Instead of copy-pasting code or switching between apps, your AI talks directly to BuildCAD AI to create, preview, and save CAD designs.
- Open standard, not locked to any single AI provider
- Your AI subscription does the thinking; BuildCAD AI is free
- Every run returns measurements, print checks and renders

Troubleshooting
Not working?
The usual causes, and how to fix them. Still stuck? Email hello@buildcad.ai with your app, plan, country and the error you see.
There's no "custom connector", "+ Custom" or "custom MCP server" option
Your plan or account doesn't offer custom apps (Claude Free already has one; Gemini is still rolling out; ChatGPT needs developer mode)
Check the requirements in your app's tab, ask your workspace admin, or use another app
The sign-in window doesn't open, or closes without connecting
A blocked pop-up, or the browser is signed in to another account
Allow pop-ups for your AI app, use a window signed in to one account, and try again
Gemini asks for a Client ID and Client Secret
Those fields are optional
Leave them empty: Gemini registers itself with BuildCAD
Connected, but the AI doesn't use BuildCAD
The connector is off for this chat
Claude: + > Connectors. ChatGPT and Gemini: type @BuildCAD AI. Or start with "Use BuildCAD AI"
"Needs authentication" (Claude Code, Cursor, Codex, VS Code)
Sign-in not done yet, or expired
Claude Code: /mcp then Authenticate. Codex: codex mcp login buildcad-ai. Cursor: Needs login. VS Code: MCP: List Servers > Start Server
You see no designs, or someone else's
Signed in to another BuildCAD account
Remove BuildCAD AI from the app, add it again and sign in with the right account
It worked before October 2026 and stopped
Connections from the old version expired
Remove BuildCAD AI from the app and add it again
You edited a config file but the server isn't listed
Each app has its own format
Copy the config from your app's tab (VS Code: servers; Windsurf and Antigravity: serverUrl) and restart the app
Using Fusion, FreeCAD, Onshape or OpenSCAD?
Our guide compares ten CAD MCP servers, ours included: what each runs on, STEP or mesh output, local or hosted, what the AI can check, and the setup for each client.
FAQ
Frequently asked questions
Everything about using BuildCAD AI with MCP. Can’t find what you’re looking for? Get in touch.
What is an MCP server?
Is the BuildCAD AI MCP server free?
Which AI assistants support MCP?
Does it work with Gemini?
What can I do with the BuildCAD AI MCP server?
Do I need a BuildCAD AI account?
Can the AI spend my credits or see my billing?
How does this compare to using BuildCAD AI directly?
Start designing CAD with your AI
Paste one URL, sign in, and ask for a part. Free to use with your own AI subscription.
https://buildcad.ai/api/mcp