CommunityCAD MCP
Uploading from your AI app
Uploading models, versions, pictures and datasheets, editing details, and the rules.
With your permission, your AI app can upload models to your CommunityCAD account and keep them up to date: new models, new versions, pictures, datasheets and details. It never deletes anything, and it never uploads without your yes.
Uploads from an AI app follow the same rules and moderation as uploading on the site. See Uploading models and Rules, reports and takedowns.
What it can do#
| Your AI app can | |
|---|---|
| New models | Upload a model, public or private, with its pictures, README and datasheets |
| New versions | Upload a new version of your own model, with version notes |
| Pictures and datasheets | Add pictures and datasheet PDFs to your own models |
| Details | Change the title, description, README, tags, license and visibility of your own models |
It can only change your models. It can't delete a model, a version, a picture or a datasheet, and it can't comment, rate, like or follow. To delete something, use Edit model on the site (see Versions and editing).
Turning it on#
Uploading needs its own permission, which you approve on the website:
- When you link, the approval screen lists Upload models and edit your models' details (public or private). It can't delete anything. Approve it there.
- Already linked without it? Ask your AI app to upload something. It asks for the extra permission with a new code, and you approve it on communitycad.dev/link the same way you linked.
Without the permission, your AI app can still search, read and download, and tells you uploading isn't allowed yet.
Your yes comes first#
Before uploading, adding or changing anything, your AI app tells you exactly what it will do: which file, the title and description, the tags, the license, and whether it will be public or private. Nothing happens until you say yes. Afterwards it gives you the link to the model page, so you can check it.
Read the summary before you agree. A public upload is visible to everyone as soon as it's processed.
Public or private#
You decide. A public model can be found, viewed and downloaded by everyone, like any model on the site. A private model is visible only to you; you can make it public later, from your AI app or on the site. See Visibility.
If you don't say, your AI app asks.
License#
A public model needs a license you choose. Your AI app must ask you which one; it never picks one for you. It uses the same list as the upload form: CC0, CC BY 4.0, CC BY-SA 4.0, MIT, BSD 3-Clause, Apache 2.0, GPL v3 and the others. See Choosing a license.
A private model can wait for its license until you make it public.
A license from a LICENSE file in your ZIP, or from a model synced from GitHub, can't be changed from your AI app. Change it in the file or the repo instead.
Documentation it must include#
Every model uploaded from an AI app needs real documentation, so it's useful from the first day:
- A short description of at least 80 characters.
- A README of at least about 400 characters, with these sections (other common names work too):
- What it is
- Dimensions (or Specifications)
- How to use (or Usage, Printing, Assembly, Mounting)
- Materials (or Hardware, Bill of materials)
- At least one picture.
Datasheet PDFs are optional, but please add them when the part has one: they're what people check dimensions against. See Documenting your model.
If something is missing, nothing is uploaded and your AI app is told exactly what to add. Your AI app writes the documentation with you, from your files and what you tell it. Check it before you say yes: it's published under your name.
New versions#
Your AI app can upload a new version of a model you own. Each version needs version notes saying what changed. If the dimensions changed, it should update the README too.
Models synced from GitHub get new versions from the repo, not from your AI app. See Sync from GitHub.
Pictures, datasheets and details#
Your AI app can add pictures (up to 10 at a time) and datasheet PDFs (up to 5 at a time) to your models, and edit the title, description, README, tags, license and visibility. Edited descriptions and READMEs must still meet the documentation rules.
Limits#
There's no daily limit on uploads from AI apps. Each file can be up to 250 MB.
18+ content#
Content that must be marked 18+ on the site (adult content, firearms and firearm parts, graphic content) must be marked when uploaded from an AI app too. Tell your AI app if a model is 18+. See Age and 18+ content.
Where it came from#
On the model page, you see Uploaded from and the connection's name, for example Uploaded from Claude Code on DESKTOP-ABC. Only you (and moderators) see it; other visitors don't.
After uploading, a model takes a moment to process: pictures, previews and search are ready a little later, as with any upload. See What happens after you upload.
Example prompts#
- "Upload the bracket in ./bracket as a private CommunityCAD model."
- "Upload this enclosure to CommunityCAD, public, under CC BY 4.0."
- "Upload version 2 of my fan duct: the mounting holes moved 2 mm."
- "Add these photos to my cable clip model."
- "Add the datasheet PDF to my stepper mount."
- "Make my bracket public under CC BY-SA 4.0."