kernelcad

Get Project

get_project

Read-only

Use this when you need to reopen a saved project or browse what the user has saved — it fetches a kernelCAD Studio project, or lists the signed-in user's saved projects. Pass slug (from a /p/ link or a prior listing) to fetch that project's full .kcad source and metadata — then edit and open_in_studio with the same slug so the user's open tab updates live. Private projects require their owner's OAuth connection. OMIT slug to list the signed-in user's saved projects (most recently updated first); that listing mode requires the OAuth connection and does NOT paint — prefer list_my_projects to find a project to continue. Read-only: this tool never shows a viewer (only open_in_studio does, once per response). Paint phases: projectSaved/meshReady reflect fetch state; viewerPainted stays false. Use open_in_studio (with code) to publish+paint — do NOT call get_model_mesh or get_latest_render for interactive paint.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`slug`	No	The project slug from a listing or a /p/<slug> Studio link. Omit to list the signed-in user's saved projects.

Output Schema

TableJSON Schema

Name	Required	Description
`ok`	No	Whether the read succeeded.
`url`	No	Fetch mode: revision-pinned /p/<slug>?version= link.
`code`	No	Fetch mode: the full .kcad source.
`slug`	No	Fetch mode: the project slug.
`title`	No	Fetch mode: the project title.
`assets`	No	Complementary files keyed by source-relative path.
`meshUrl`	No	Fetch mode: revision-matched mesh artifact URL when available — FunnelViewer loads it instead of re-executing CAD. When meshStatus is building, this is the expected CDN URL (retry until ready).
`privacy`	No	Fetch mode: the project privacy.
`version`	No	Fetch mode: the project version.
`embedUrl`	No	Fetch mode: revision-pinned chrome-free /embed/<slug>?revision= viewer URL (includes meshUrl when available).
`meshHint`	No	Fetch mode: when meshStatus=building — transient; poll again or re-open_in_studio; never imply permanent 404.
`projects`	No	List mode (no slug): the user's saved projects.
`meshError`	No	Fetch mode: sanitized repair/persist error when meshStatus is failed.
`meshReady`	No	Fetch mode: true only when meshStatus===ready.
`paintHint`	No
`meshStatus`	No	Fetch mode: ready \| building \| failed \| missing — explicit CDN artifact state (never silently omit meshUrl under CDN mode).
`parameters`	No	Fetch mode: the model's editable parameters.
`updated_at`	No	Fetch mode: last-updated timestamp.
`serverBuild`	No	Deploy identity (package+git SHA@boot time) so connector lag is observable.
`projectSaved`	No	Fetch mode: true when the project was loaded.
`viewerPainted`	No	Always false on tools/call; widget sets true after correlated model_displayed.

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedSep 24, 2026

addedOutput schema / properties / meshHint

Added value: +{
+  "description": "Fetch mode: when meshStatus=building — transient; poll again or re-open_in_studio; never imply permanent 404.",
+  "type": "string"
+}

Changed4 schema fields changedSep 23, 2026

addedOutput schema / properties / meshReady

Added value: +{
+  "description": "Fetch mode: true only when meshStatus===ready.",
+  "type": "boolean"
+}

addedOutput schema / properties / paintHint
```
Added value: +{
+  "type": "string"
+}
```

addedOutput schema / properties / projectSaved

Added value: +{
+  "description": "Fetch mode: true when the project was loaded.",
+  "type": "boolean"
+}

addedOutput schema / properties / viewerPainted

Added value: +{
+  "description": "Always false on tools/call; widget sets true after correlated model_displayed.",
+  "type": "boolean"
+}

Changed3 schema fields changedSep 23, 2026

addedOutput schema / properties / meshError

Added value: +{
+  "description": "Fetch mode: sanitized repair/persist error when meshStatus is failed.",
+  "type": "string"
+}

addedOutput schema / properties / meshStatus

Added value: +{
+  "description": "Fetch mode: ready | building | failed | missing — explicit CDN artifact state (never silently omit meshUrl under CDN mode).",
+  "type": "string"
+}

changedOutput schema / properties / meshUrl / description

Previous value: -"Fetch mode: revision-matched mesh artifact URL when available — FunnelViewer loads it instead of re-executing CAD."New value: +"Fetch mode: revision-matched mesh artifact URL when available — FunnelViewer loads it instead of re-executing CAD. When meshStatus is building, this is the expected CDN URL (retry until ready)."

Changed4 schema fields changedSep 22, 2026

addedOutput schema / properties / embedUrl

Added value: +{
+  "description": "Fetch mode: revision-pinned chrome-free /embed/<slug>?revision= viewer URL (includes meshUrl when available).",
+  "type": "string"
+}

addedOutput schema / properties / meshUrl

Added value: +{
+  "description": "Fetch mode: revision-matched mesh artifact URL when available — FunnelViewer loads it instead of re-executing CAD.",
+  "type": "string"
+}

addedOutput schema / properties / serverBuild

Added value: +{
+  "description": "Deploy identity (package+git SHA@boot time) so connector lag is observable.",
+  "type": "string"
+}

addedOutput schema / properties / url

Added value: +{
+  "description": "Fetch mode: revision-pinned /p/<slug>?version= link.",
+  "type": "string"
+}

Changed1 schema field changedJul 27, 2026

addedOutput schema / properties / assets

Added value: +{
+  "additionalProperties": true,
+  "description": "Complementary files keyed by source-relative path.",
+  "type": "object"
+}

Changed1 schema field changedJun 15, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "properties": {
+    "code": {
+      "description": "Fetch mode: the full .kcad source.",
+      "type": "string"
+    },
+    "ok": {
+      "description": "Whether the read succeeded.",
+      "type": "boolean"
+    },
+    "parameters": {
+      "description": "Fetch mode: the model's editable parameters.",
+      "items": {},
+      "type": "array"
+    },
+    "privacy": {
+      "description": "Fetch mode: the project privacy.",
+      "type": "string"
+    },
+    "projects": {
+      "description": "List mode (no slug): the user's saved projects.",
+      "items": {},
+      "type": "array"
+    },
+    "slug": {
+      "description": "Fetch mode: the project slug.",
+      "type": "string"
+    },
+    "title": {
+      "description": "Fetch mode: the project title.",
+      "type": "string"
+    },
+    "updated_at": {
+      "description": "Fetch mode: last-updated timestamp.",
+      "type": "string"
+    },
+    "version": {
+      "description": "Fetch mode: the project version.",
+      "type": "number"
+    }
+  },
+  "type": "object"
+}

Changed2 schema fields changedJun 13, 2026

changedInput schema / properties / slug / description

Previous value: -"The project slug from list_my_projects or a /p/<slug> Studio link."New value: +"The project slug from a listing or a /p/<slug> Studio link. Omit to list the signed-in user's saved projects."