Upload a model
upload_modelPublishes a CAD model to CommunityCAD as public or private after user confirmation, with pictures, README and optional datasheets; blocks missing docs and returns the page link.
Instructions
Upload a new model to CommunityCAD (public or private) from a file or folder, with pictures, README and optional datasheets. Only after the user explicitly said yes and chose the visibility, the licence (for public) and whether it's 18+. Nothing is uploaded when documentation is missing. Same moderation as the website. Returns the page link.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>",
"title": "<title>",
"description": "<description>",
"readme_markdown": "<readme_markdown>",
"visibility": "<visibility>",
"is_mature": "<is_mature>",
"image_paths": "<image_paths>"
},
"name": "upload_model"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | The CAD file, or a folder to upload as a ZIP (hidden files, .venv, node_modules and __pycache__ are left out). | |
| tags | No | ||
| title | Yes | ||
| license | No | SPDX id the user chose, required for public: MIT, Apache-2.0, GPL-3.0, BSD-3-Clause, CC-BY-4.0, CC-BY-SA-4.0, CC0-1.0. | |
| sourcing | No | Where to buy it: auto (let the site find it), own (the user's links), none. | |
| is_mature | Yes | 18+ (adult content, firearms or firearm parts, graphic content). Always ask. | |
| visibility | Yes | The user's choice. Always ask. | |
| description | Yes | What the part is, at least 80 characters, from what the user and the CAD say. | |
| image_paths | Yes | At least one picture of the part (JPEG, PNG, GIF or WebP). | |
| image_captions | No | One caption per image, or none. | |
| datasheet_paths | No | PDF datasheets. Attach the part's datasheet when it has one. | |
| readme_markdown | Yes | Markdown with the sections What it is, Dimensions, How to use and Materials (at least ~400 characters). Never invent dimensions. | |
| datasheet_titles | No | One title per datasheet, or none. |