Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

feat(blender-mcp): return the render inline and report the texture budget

nirholasd2f69a2ac828
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6154181f2..8797c25b9 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,9 +7,11 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr
## 2026-09-07
- **My Creations** (`/mine`): Everything you have made on three.ws in one newest-first grid: the agents you built, the 3D avatars you saved, and every model you forged, including models forged in this browser before you had an account. Open, edit, or copy a link to any of them in one click.
+- **3D generation and the whole site keep working when our asset storage does not**: Early on 2026-09-07 our object storage stopped accepting the platform's credential, and because every generation parks its reference image there, 3D generation stopped on the website and in ChatGPT at the same time, agent registration could not store its manifest, and images loaded through our CDN stopped resolving. Three things changed so that a storage fault is never again a blank page. Avatars, thumbnails and models now fall back to the bucket's public domain automatically, so the site keeps rendering. When generation genuinely cannot run you get a plain message saying storage is recovering and to try again shortly, instead of a raw error from the storage vendor. And our own health checks now watch the storage credential directly and treat a silent forge as an outage rather than a quiet hour, so we hear about this class of failure before you do. `[fix, infra]`
- **A payment we cannot read now comes back with the price list, not a bare error**: When an agent pays one of our x402 endpoints and the payment header arrives mangled (truncated in transit, double-encoded, wrapped by a proxy), the answer used to be a plain 400 error with no prices in it, so the agent had nothing left to work from and no way to retry. Every rejected payment now returns the ordinary 402 with the full list of accepted rails, tokens and amounts attached, exactly as it does when a payment is simply missing. That is what the x402 spec and the OKX seller SDK both do, and it means a paying agent can always read the quote again and try once more. Only a real server fault answers without a quote. (`/docs/okx-marketplace`) `[fix, improvement]`
- **My Creations: one button that takes you back to everything you made**: A creator told us the making part was intuitive and the finding part was not: they built an agent, closed the tab, and had no obvious way back to it. There is now a My creations button in the header, and it opens a single page holding everything you have made, newest first: your agents, the 3D avatars saved to your account, and every model you forged, with Open, Edit and Copy link on each one. Signed out it still finds the models forged in this browser, so work made before you had an account is not lost. Filter by type, search by name or prompt, and hover any card to spin it in 3D. The create wizard and the Forge now point here too, so you are told where your work lives at the moment you make it. (`/mine`) `[feature, improvement]`
- **Point an AI agent at the Blender on your own machine**: A new MCP server drives the Blender you already have installed, with no GUI open and no add-on to install first. An assistant can now read a 3D file and tell you what is actually in it (objects, triangle counts, materials, bones, animations, real-world size), convert between GLB, glTF, FBX, OBJ, STL, PLY, Collada, Alembic, USD and .blend in either direction, render a preview image of a bare asset file that arrives with no camera or lighting of its own, and run a Blender Python script to do the things no single tool covers, like halving a mesh's triangle count and exporting the result in one step. It also reaches back into three.ws: describe something in a sentence and the free text-to-3D lane generates it and opens it in Blender. Blender runs in the background, one process per request, so it works the same on a laptop, a server, or in CI. `[feature, sdk]`
+- **The Blender tools now show you the render instead of describing it**: Asking an assistant to render a 3D model used to hand back a file path, which is useless if the assistant cannot open files on your disk. The rendered image now comes back with the answer, scaled to fit, while the full-resolution PNG still lands on disk. That turns a look at this model into one step, so an assistant can render, spot the problem, fix it and render again. Reading a file also reports its texture budget now: every image with its resolution and byte size, plus the total, which is usually what actually decides whether a model is small enough to ship, and it was previously reported as nothing more than a count. Two reliability fixes came out of real use: several requests at once now queue instead of all starting Blender at the same moment and exhausting the machine, and when Blender is installed but momentarily will not start you get a message saying exactly that, with the details, rather than being told to install software you already have. `[improvement, feature]`
## 2026-09-05
diff --git a/data/changelog.json b/data/changelog.json
index 6b28c75f8..347c58eb4 100644
--- a/data/changelog.json
+++ b/data/changelog.json
@@ -1,6 +1,15 @@
{
"$comment": "Curated changelog entries for three.ws, the editorial layer of the public changelog. New PAGE launches are tracked automatically via the `added` field in data/pages.json; this file is for everything else holders care about: improvements, fixes, SDK releases, trading/payments capabilities, security work. scripts/build-page-index.mjs merges both sources into CHANGELOG.md, public/changelog.json, and public/changelog.xml. Newest first. Allowed tags: feature, improvement, fix, sdk, infra, docs, security. `link` is optional and must be a live three.ws path.",
"entries": [
+ {
+ "date": "2026-09-07",
+ "title": "3D generation and the whole site keep working when our asset storage does not",
+ "summary": "Early on 2026-09-07 our object storage stopped accepting the platform's credential, and because every generation parks its reference image there, 3D generation stopped on the website and in ChatGPT at the same time, agent registration could not store its manifest, and images loaded through our CDN stopped resolving. Three things changed so that a storage fault is never again a blank page. Avatars, thumbnails and models now fall back to the bucket's public domain automatically, so the site keeps rendering. When generation genuinely cannot run you get a plain message saying storage is recovering and to try again shortly, instead of a raw error from the storage vendor. And our own health checks now watch the storage credential directly and treat a silent forge as an outage rather than a quiet hour, so we hear about this class of failure before you do.",
+ "tags": [
+ "fix",
+ "infra"
+ ]
+ },
{
"date": "2026-09-07",
"title": "My Creations: one button that takes you back to everything you made",
@@ -26788,6 +26797,15 @@
"feature",
"sdk"
]
+ },
+ {
+ "date": "2026-09-07",
+ "title": "The Blender tools now show you the render instead of describing it",
+ "summary": "Asking an assistant to render a 3D model used to hand back a file path, which is useless if the assistant cannot open files on your disk. The rendered image now comes back with the answer, scaled to fit, while the full-resolution PNG still lands on disk. That turns a look at this model into one step, so an assistant can render, spot the problem, fix it and render again. Reading a file also reports its texture budget now: every image with its resolution and byte size, plus the total, which is usually what actually decides whether a model is small enough to ship, and it was previously reported as nothing more than a count. Two reliability fixes came out of real use: several requests at once now queue instead of all starting Blender at the same moment and exhausting the machine, and when Blender is installed but momentarily will not start you get a message saying exactly that, with the details, rather than being told to install software you already have.",
+ "tags": [
+ "improvement",
+ "feature"
+ ]
}
]
}
diff --git a/docs/blender-mcp.md b/docs/blender-mcp.md
index 2eb50e26b..37114d267 100644
--- a/docs/blender-mcp.md
+++ b/docs/blender-mcp.md
@@ -82,7 +82,9 @@ Call it first whenever anything else fails: it separates "Blender is missing" fr
| `input` | string, required | Path to the file. Absolute, or relative to the server's working directory. |
| `include_objects` | boolean | Include the per-object breakdown. Set `false` on huge scenes for totals only. Default `true`. |
-Opens a `.blend`, or imports any supported format into an empty scene, and describes it: objects with type, parent, dimensions, modifiers, materials and UV layers; **evaluated** triangle and vertex counts, so a subdivision modifier is counted as what it renders, not what it stores; armature bone names; animation actions with frame ranges; and world-space bounds. The file is never modified.
+Opens a `.blend`, or imports any supported format into an empty scene, and describes it: objects with type, parent, dimensions, modifiers, materials and UV layers; **evaluated** triangle and vertex counts, so a subdivision modifier is counted as what it renders, not what it stores; a texture inventory giving each image's resolution, format and byte size plus `counts.texture_bytes`, which against `input_bytes` is what tells you whether an asset is mesh-heavy or texture-heavy; armature bone names; animation actions with frame ranges; and world-space bounds. The file is never modified.
+
+Counts describe the file **as loaded**. A GLB reports more vertices than the `.blend` it was exported from, because glTF splits vertices at UV and normal seams; the triangle count is identical either way.
```
blender_scene_info { "input": "~/assets/character.fbx" }
@@ -113,6 +115,9 @@ blender_convert { "input": "character.fbx", "output": "character.glb", "scale":
| `samples` | integer | Default `32`, enough for a preview. |
| `resolution` | `[width, height]` | Default `[960, 960]`. |
| `transparent` | boolean | Transparent background instead of the world. Default `false`. |
+| `inline_image` | boolean | Return the image inline so the assistant can see it. Default `true`. |
+
+The rendered image comes back **inline** as an MCP image block, downscaled to fit the caller's context, while the full-resolution PNG is written to disk. That is what makes a see-and-fix loop possible in one call, and it is the only way the render is reachable at all from a client with no filesystem access.
An asset file usually carries no camera and no lights, which is why rendering one straight out of a converter normally produces a black square. This tool fills both in: it creates a camera and frames it to the geometry's bounding sphere, and adds a key light and a lit world. A scene that already has its own camera and lighting is rendered exactly as authored, and the response says which of the two happened (`camera_created`, `lights_created`).
@@ -188,6 +193,7 @@ Failures come back as structured tool errors, each naming a fix:
| `format_unsupported` | This build has no importer or exporter for that extension. The message lists the ones it does have. |
| `engine_unavailable` | The requested render engine is not in this build. |
| `timeout` | The job passed `BLENDER_MCP_TIMEOUT_MS` and was killed. |
+| `blender_unusable` | A Blender executable exists but would not run. Carries per-candidate diagnostics; on a loaded machine this is usually transient and the call is worth retrying. |
| `blender_crashed` | Blender exited without writing a result. The error carries its log tail. |
---
@@ -200,6 +206,9 @@ Failures come back as structured tool errors, each naming a fix:
| `BLENDER_MCP_TIMEOUT_MS` | `300000` | Ceiling for one Blender job. |
| `BLENDER_MCP_WORKDIR` | `<tmpdir>/three-ws-blender-mcp` | Where outputs land with no explicit output path. |
| `BLENDER_MCP_ALLOW_PYTHON` | `1` | `0` withdraws `blender_run_python` from the tool list entirely. |
+| `BLENDER_MCP_MAX_CONCURRENCY` | `2` | Blender processes allowed at once; further calls queue. |
+| `BLENDER_MCP_INLINE_IMAGE_PX` | `768` | Longest edge of the render copy returned inline. |
+| `BLENDER_MCP_INLINE_IMAGE_BYTES` | `1500000` | Past this the image stays on disk and the response says so. |
| `THREE_WS_BASE` | `https://three.ws` | Deployment backing `blender_forge_import`. |
| `THREE_WS_FORGE_TIMEOUT_MS` | `600000` | Ceiling for one generation. |
| `THREE_WS_FORGE_PROVIDER_KEY` | unset | Meshy/Tripo key for the bring-your-own-key geometry lane. |
diff --git a/packages/blender-mcp/README.md b/packages/blender-mcp/README.md
index 3b42c2c91..fb775ee5c 100644
--- a/packages/blender-mcp/README.md
+++ b/packages/blender-mcp/README.md
@@ -66,9 +66,9 @@ Add `"env": { "BLENDER_PATH": "/path/to/blender" }` if Blender is not on `PATH`.
| Tool | What it does |
|---|---|
| `blender_info` | Reports the Blender being driven: path, version, bundled Python, usable render engines, and the import/export formats this build actually supports. Read-only. |
-| `blender_scene_info` | Opens a 3D file and describes it: objects with types, parents, dimensions and modifiers; evaluated triangle and vertex counts; materials; armature bone names; animation actions with frame ranges; world-space bounds. Read-only. |
+| `blender_scene_info` | Opens a 3D file and describes it: objects with types, parents, dimensions and modifiers; evaluated triangle and vertex counts; materials; a texture inventory with each image's resolution and byte size; armature bone names; animation actions with frame ranges; world-space bounds. Read-only. |
| `blender_convert` | Imports one format and exports another, chosen by the file extensions. Applies modifiers by default and can bake in a uniform unit scale. The exact format list depends on the build (some Linux packages ship without USD, Collada, or Alembic), and `blender_info` reports what yours actually has. |
-| `blender_render` | Renders a still PNG. If the file has no camera, one is created and framed to the model's bounding sphere; if it has no light, a key light and a lit world are added. A scene that already has its own camera and lighting renders as authored. |
+| `blender_render` | Renders a still PNG and returns it **inline**, so the assistant can actually see the model in one call even with no filesystem access. If the file has no camera, one is created and framed to the model's bounding sphere; if it has no light, a key light and a lit world are added. A scene that already has its own camera and lighting renders as authored. |
| `blender_run_python` | Runs a `bpy` script against a scene, optionally opening a file first and exporting the result afterwards. The escape hatch for anything the other tools do not cover. |
| `blender_forge_import` | Generates a model from a text prompt on the public three.ws Forge pipeline and brings it into Blender, converting on the way in if the output asks for another format. The default image lane is free. |
@@ -119,7 +119,7 @@ Every tool call spawns `blender -b --factory-startup --python src/py/runner.py -
- **The runner writes its payload to a file, never to stdout.** Blender prints progress, add-on chatter, and render statistics on stdout, and picking a payload out of that stream is guesswork. A missing result file therefore means Blender died, and the error carries the log tail that says why.
- **One process per call.** A crashed job cannot corrupt the next one, and nothing stays resident between calls.
-Failures come back as structured tool errors (`input_not_found`, `format_unsupported`, `engine_unavailable`, `timeout`, `blender_not_found`, `blender_crashed`), each with a message that says what to do about it.
+Failures come back as structured tool errors (`input_not_found`, `format_unsupported`, `engine_unavailable`, `timeout`, `blender_not_found`, `blender_unusable`, `blender_crashed`), each with a message that says what to do about it. `blender_not_found` means no candidate exists; `blender_unusable` means one exists but would not run, and carries the per-candidate diagnostics, because on a loaded machine a failed probe is transient and telling you to install software you already have is the wrong answer.
## Environment variables
@@ -129,6 +129,9 @@ Failures come back as structured tool errors (`input_not_found`, `format_unsuppo
| `BLENDER_MCP_TIMEOUT_MS` | `300000` | Ceiling for one Blender job. |
| `BLENDER_MCP_WORKDIR` | `<tmpdir>/three-ws-blender-mcp` | Where outputs land when a tool is called without an explicit output path. |
| `BLENDER_MCP_ALLOW_PYTHON` | `1` | Set to `0` to withdraw `blender_run_python` from the advertised tool list entirely. |
+| `BLENDER_MCP_MAX_CONCURRENCY` | `2` | Blender processes allowed at once. Further calls queue rather than compete for memory. |
+| `BLENDER_MCP_INLINE_IMAGE_PX` | `768` | Longest edge of the render copy returned inline. The full-resolution PNG always goes to disk. |
+| `BLENDER_MCP_INLINE_IMAGE_BYTES` | `1500000` | Past this the image stays on disk and the response says so. |
| `THREE_WS_BASE` | `https://three.ws` | Deployment backing `blender_forge_import`. |
| `THREE_WS_FORGE_TIMEOUT_MS` | `600000` | Ceiling for one text-to-3D generation. |
| `THREE_WS_FORGE_PROVIDER_KEY` | unset | Meshy/Tripo key for the bring-your-own-key geometry lane. The default image lane is free and needs no key. |
diff --git a/packages/blender-mcp/package.json b/packages/blender-mcp/package.json
index 742d113f2..7e0d91781 100644
--- a/packages/blender-mcp/package.json
+++ b/packages/blender-mcp/package.json
@@ -1,6 +1,6 @@
{
"name": "@three-ws/blender-mcp",
- "version": "0.1.0",
+ "version": "0.2.0",
"mcpName": "io.github.nirholas/blender-mcp",
"description": "Drive the Blender on your machine from any AI agent, headless. Inspect a 3D file, convert between GLB/glTF/FBX/OBJ/STL/PLY/DAE/USD/Alembic/.blend, render an auto-framed and auto-lit preview PNG, run a bpy script against a scene, and generate a model from a text prompt on the free three.ws Forge lane. No GUI, no add-on to install, no key.",
"type": "module",
diff --git a/packages/blender-mcp/server.json b/packages/blender-mcp/server.json
index 2994f519d..90baa251b 100644
--- a/packages/blender-mcp/server.json
+++ b/packages/blender-mcp/server.json
@@ -18,12 +18,12 @@
"source": "github",
"subfolder": "packages/blender-mcp"
},
- "version": "0.1.0",
+ "version": "0.2.0",
"packages": [
{
"registryType": "npm",
"identifier": "@three-ws/blender-mcp",
- "version": "0.1.0",
+ "version": "0.2.0",
"runtimeHint": "npx",
"transport": {
"type": "stdio"
@@ -55,6 +55,27 @@
"isRequired": false,
"default": "1"
},
+ {
+ "name": "BLENDER_MCP_INLINE_IMAGE_BYTES",
+ "description": "Ceiling on inlined image bytes. Past this the image stays on disk and the response says where.",
+ "format": "number",
+ "isRequired": false,
+ "default": "1500000"
+ },
+ {
+ "name": "BLENDER_MCP_INLINE_IMAGE_PX",
+ "description": "Longest edge of the render copy returned inline in a tool result. The full-resolution PNG is always written to disk.",
+ "format": "number",
+ "isRequired": false,
+ "default": "768"
+ },
+ {
+ "name": "BLENDER_MCP_MAX_CONCURRENCY",
+ "description": "How many Blender processes may run at once. Further calls queue rather than compete for memory.",
+ "format": "number",
+ "isRequired": false,
+ "default": "2"
+ },
{
"name": "THREE_WS_BASE",
"description": "Base URL of the three.ws deployment backing blender_forge_import.",
diff --git a/packages/blender-mcp/test/registration.test.mjs b/packages/blender-mcp/test/registration.test.mjs
index 0a35adc02..388388722 100644
--- a/packages/blender-mcp/test/registration.test.mjs
+++ b/packages/blender-mcp/test/registration.test.mjs
@@ -92,6 +92,11 @@ test('BLENDER_MCP_ALLOW_PYTHON=0 withdraws the script tool', () => {
assert.equal(names.length, 5);
});
+test('blender_render is the tool that returns extra content blocks', () => {
+ const withAttachments = TOOLS.filter((t) => typeof t.attachments === 'function').map((t) => t.name);
+ assert.deepEqual(withAttachments, ['blender_render'], 'only the render tool inlines an image today');
+});
+
test('buildServer registers without Blender or network access', () => {
const server = buildServer();
assert.ok(server, 'buildServer() must return an McpServer');
diff --git a/prompts/store-submissions/_generated/mcp-listing-source.json b/prompts/store-submissions/_generated/mcp-listing-source.json
index 3ccdce8f4..266ebaec3 100644
--- a/prompts/store-submissions/_generated/mcp-listing-source.json
+++ b/prompts/store-submissions/_generated/mcp-listing-source.json
@@ -421,7 +421,7 @@
"transport": "stdio",
"connect": "npx -y @three-ws/blender-mcp",
"npmPackage": "@three-ws/blender-mcp",
- "version": "0.1.0",
+ "version": "0.2.0",
"description": "Drive a local Blender headlessly: inspect, convert, render and script 3D files.",
"tagline": "Drive the Blender on your own machine: inspect, convert, render and script 3D files, headless.",
"category": "3d",
diff --git a/public/changelog.json b/public/changelog.json
index fdaa8d6cb..74ec68366 100644
--- a/public/changelog.json
+++ b/public/changelog.json
@@ -1,5 +1,5 @@
{
- "generated_at": "2026-09-07T05:11:40.027Z",
+ "generated_at": "2026-09-07T05:17:15.845Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json",
"site": {
"name": "three.ws",
@@ -16,6 +16,17 @@
"launch"
]
},
+ {
+ "date": "2026-09-07",
+ "type": "update",
+ "title": "3D generation and the whole site keep working when our asset storage does not",
+ "summary": "Early on 2026-09-07 our object storage stopped accepting the platform's credential, and because every generation parks its reference image there, 3D generation stopped on the website and in ChatGPT at the same time, agent registration could not store its manifest, and images loaded through our CDN stopped resolving. Three things changed so that a storage fault is never again a blank page. Avatars, thumbnails and models now fall back to the bucket's public domain automatically, so the site keeps rendering. When generation genuinely cannot run you get a plain message saying storage is recovering and to try again shortly, instead of a raw error from the storage vendor. And our own health checks now watch the storage credential directly and treat a silent forge as an outage rather than a quiet hour, so we hear about this class of failure before you do.",
+ "link": null,
+ "tags": [
+ "fix",
+ "infra"
+ ]
+ },
{
"date": "2026-09-07",
"type": "update",
@@ -49,6 +60,17 @@
"sdk"
]
},
+ {
+ "date": "2026-09-07",
+ "type": "update",
+ "title": "The Blender tools now show you the render instead of describing it",
+ "summary": "Asking an assistant to render a 3D model used to hand back a file path, which is useless if the assistant cannot open files on your disk. The rendered image now comes back with the answer, scaled to fit, while the full-resolution PNG still lands on disk. That turns a look at this model into one step, so an assistant can render, spot the problem, fix it and render again. Reading a file also reports its texture budget now: every image with its resolution and byte size, plus the total, which is usually what actually decides whether a model is small enough to ship, and it was previously reported as nothing more than a count. Two reliability fixes came out of real use: several requests at once now queue instead of all starting Blender at the same moment and exhausting the machine, and when Blender is installed but momentarily will not start you get a message saying exactly that, with the details, rather than being told to install software you already have.",
+ "link": null,
+ "tags": [
+ "improvement",
+ "feature"
+ ]
+ },
{
"date": "2026-09-05",
"type": "launch",
diff --git a/public/changelog.xml b/public/changelog.xml
index 9cf56b32c..539adc468 100644
--- a/public/changelog.xml
+++ b/public/changelog.xml
@@ -14,6 +14,14 @@
<category>launch</category>
<description>Everything you have made on three.ws in one newest-first grid: the agents you built, the 3D avatars you saved, and every model you forged, including models forged in this browser before you had an account. Open, edit, or copy a link to any of them in one click.</description>
</item>
+ <item>
+ <title>3D generation and the whole site keep working when our asset storage does not</title>
+ <link>https://three.ws/changelog</link>
+ <guid isPermaLink="false">2026-09-07:3D generation and the whole site keep working when our asset storage does not</guid>
+ <pubDate>Mon, 07 Sep 2026 12:00:00 GMT</pubDate>
+ <category>fix</category>
+ <description>Early on 2026-09-07 our object storage stopped accepting the platform's credential, and because every generation parks its reference image there, 3D generation stopped on the website and in ChatGPT at the same time, agent registration could not store its manifest, and images loaded through our CDN stopped resolving. Three things changed so that a storage fault is never again a blank page. Avatars, thumbnails and models now fall back to the bucket's public domain automatically, so the site keeps rendering. When generation genuinely cannot run you get a plain message saying storage is recovering and to try again shortly, instead of a raw error from the storage vendor. And our own health checks now watch the storage credential directly and treat a silent forge as an outage rather than a quiet hour, so we hear about this class of failure before you do.</description>
+ </item>
<item>
<title>A payment we cannot read now comes back with the price list, not a bare error</title>
<link>https://three.ws/docs/okx-marketplace</link>
@@ -38,6 +46,14 @@
<category>feature</category>
<description>A new MCP server drives the Blender you already have installed, with no GUI open and no add-on to install first. An assistant can now read a 3D file and tell you what is actually in it (objects, triangle counts, materials, bones, animations, real-world size), convert between GLB, glTF, FBX, OBJ, STL, PLY, Collada, Alembic, USD and .blend in either direction, render a preview image of a bare asset file that arrives with no camera or lighting of its own, and run a Blender Python script to do the things no single tool covers, like halving a mesh's triangle count and exporting the result in one step. It also reaches back into three.ws: describe something in a sentence and the free text-to-3D lane generates it and opens it in Blender. Blender runs in the background, one process per request, so it works the same on a laptop, a server, or in CI.</description>
</item>
+ <item>
+ <title>The Blender tools now show you the render instead of describing it</title>
+ <link>https://three.ws/changelog</link>
+ <guid isPermaLink="false">2026-09-07:The Blender tools now show you the render instead of describing it</guid>
+ <pubDate>Mon, 07 Sep 2026 12:00:00 GMT</pubDate>
+ <category>improvement</category>
+ <description>Asking an assistant to render a 3D model used to hand back a file path, which is useless if the assistant cannot open files on your disk. The rendered image now comes back with the answer, scaled to fit, while the full-resolution PNG still lands on disk. That turns a look at this model into one step, so an assistant can render, spot the problem, fix it and render again. Reading a file also reports its texture budget now: every image with its resolution and byte size, plus the total, which is usually what actually decides whether a model is small enough to ship, and it was previously reported as nothing more than a count. Two reliability fixes came out of real use: several requests at once now queue instead of all starting Blender at the same moment and exhausting the machine, and when Blender is installed but momentarily will not start you get a message saying exactly that, with the details, rather than being told to install software you already have.</description>
+ </item>
<item>
<title>Docs · Pocket Console</title>
<link>https://three.ws/docs/pocket</link>
diff --git a/public/features.json b/public/features.json
index e8e6f9468..9d664af9c 100644
--- a/public/features.json
+++ b/public/features.json
@@ -1,5 +1,5 @@
{
- "generated_at": "2026-09-07T05:11:39.753Z",
+ "generated_at": "2026-09-07T05:17:15.832Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json",
"site": {
"name": "three.ws",
diff --git a/public/mcp-catalog.json b/public/mcp-catalog.json
index 3392e05fd..2444bbe8c 100644
--- a/public/mcp-catalog.json
+++ b/public/mcp-catalog.json
@@ -4604,7 +4604,7 @@
{
"name": "blender_render",
"title": "Render a preview image of a 3D file",
- "description": "Render a still PNG of any 3D file Blender can open (.blend, .glb, .fbx, .obj, .usd and the rest). If the scene has no camera, one is created and framed to the model; if it has no light, a key light and a lit world are added, so a bare asset file renders as a usable preview with no setup. A scene that already has its own camera and lighting is rendered as authored. Returns the image path, the engine used, and whether a camera or lights had to be added. Use it to see a model, check a conversion, or produce a thumbnail.",
+ "description": "Render a still PNG of any 3D file Blender can open (.blend, .glb, .fbx, .obj, .usd and the rest). If the scene has no camera, one is created and framed to the model; if it has no light, a key light and a lit world are added, so a bare asset file renders as a usable preview with no setup. A scene that already has its own camera and lighting is rendered as authored. The rendered image is returned INLINE alongside the JSON, so you can actually look at the model in this one call without needing filesystem access, while the full-resolution PNG is written to disk. Use it to see a model, check a conversion, or produce a thumbnail.",
"server": {
"id": "blender-mcp",
"title": "@three-ws/blender-mcp",
@@ -4654,6 +4654,10 @@
"transparent": {
"type": "boolean",
"description": "Render with a transparent background instead of the world. Default false."
+ },
+ "inline_image": {
+ "type": "boolean",
+ "description": "Return the image inline so you can see it, downscaled to fit the context. Default true."
}
},
"required": [
@@ -4716,7 +4720,7 @@
{
"name": "blender_scene_info",
"title": "Describe a 3D file with Blender",
- "description": "Open a 3D file with Blender and report what is inside it: object list with types, parents, dimensions and modifiers; evaluated triangle and vertex counts; materials; armature bone names; animation actions with their frame ranges; and world-space bounds. Accepts .blend plus every format this Blender can import (.glb, .gltf, .fbx, .obj, .stl, .ply, .dae, .abc, .usd*, .x3d). Read-only: the file is never modified.",
+ "description": "Open a 3D file with Blender and report what is inside it: object list with types, parents, dimensions and modifiers; evaluated triangle and vertex counts; materials; armature bone names; animation actions with their frame ranges; a texture inventory with each image's resolution and byte size plus the total, which is usually what decides whether an asset is deliverable; and world-space bounds. Accepts .blend plus every format this Blender can import (.glb, .gltf, .fbx, .obj, .stl, .ply, .dae, .abc, .usd*, .x3d). Counts describe the file AS LOADED, so a GLB reports more vertices than the .blend it came from (glTF splits vertices at UV and normal seams) while the triangle count is identical. Read-only: the file is never modified.",
"server": {
"id": "blender-mcp",
"title": "@three-ws/blender-mcp",
diff --git a/tests/fixtures/mcp-golden-tools.json b/tests/fixtures/mcp-golden-tools.json
index 2f4f24f18..335000418 100644
--- a/tests/fixtures/mcp-golden-tools.json
+++ b/tests/fixtures/mcp-golden-tools.json
@@ -2231,7 +2231,7 @@
"idempotentHint": true,
"openWorldHint": false
},
- "schemaHash": "410e05e10d92"
+ "schemaHash": "c949ad89b18d"
}
],
"packages/blender-mcp/src/tools/run-python.js": [