Verified conversions across 205 color spaces: CSS strings, gamut checks, .cube LUTs
Create a fresh isolated headless voxel sandbox (no account, free). Returns session.id — pass session_id on every later tool call. Sandboxes expire after a short idle time and are capped in size; nothing is published.
A call is made on an account: it counts against an allowance and the publisher sees it, which is why this one asks who you are first.
What it does
Free MCP by Voxel Shaper (voxelshaper.com). AI agents get a private sandbox to place and edit voxel blocks, color them, add physics joints, load or dump project JSON, generate CAD models and export a 3D-printable 3MF file. Sandboxes live in memory and expire after 10 minutes idle; nothing is published, no account or personal data needed. Rate-limited.
Quickstart
# 1 — sign in once: npx mcprush@latest login
# it asks for a key from mcprush.com/dashboard#access
# 2 — install
npx mcprush@latest add immobilieneichmann/voxel-shaper-free-mcp
# 3 — ask your agent for something these tools do
# new_session, get_session, end_session and 16 more
Windows PowerShell says 'running scripts is disabled on this system'? Run Set-ExecutionPolicy -Scope CurrentUser RemoteSigned once, or type npx.cmd instead of npx (codex.cmd, gemini.cmd, grok.cmd likewise). PowerShell 7 needs neither.
Voxel Shaper – Free MCP costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. Nothing here runs on your machine — this server runs on the publisher’s own infrastructure behind our gateway, and what you install is the connection to it.
Claude Code has its own MCP command, and the key rides on it as a header — the gateway refuses a call that carries none. Claude Code reads MCPRUSH_KEY each time it connects, so the key stays out of its config: export your key from Access in your shell profile (macOS, Linux), or run setx MCPRUSH_KEY <your key> and open a new terminal (Windows). Or let npx mcprush@latest add immobilieneichmann/voxel-shaper-free-mcp write the entry with the key for you; --scope user makes it available in every project.
claude mcp add --transport http --scope user voxel-shaper-free-mcp https://mcprush.com/gw/voxel-shaper-free-mcp/mcp --header 'Authorization: Bearer ${MCPRUSH_KEY}'Reconnect, or start a new session, and the tools appear in the model’s tool list.
One config entry pointing at the gateway. The server itself runs on the publisher’s own infrastructure, so nothing from this listing executes on your machine.
19 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
Create a fresh isolated headless voxel sandbox (no account, free). Returns session.id — pass session_id on every later tool call. Sandboxes expire after a short idle time and are capped in size; nothing is published.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| gridSize | integer | no | — |
Get info about a session (requires session_id).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| session_id | string | yes | Session id from new_session (required for all tools except new_session) |
Permanently delete a session and free RAM. Call when finished.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| session_id | string | yes | Session id from new_session (required for all tools except new_session) |
Place or replace a voxel at integer coordinates with an optional color.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| x | integer | yes | — |
| y | yes | — | |
| z | yes | — | |
| color | string | no | Hex color #RRGGBB |
| fine_resolution | number | no | Optional fine resolution (unused in v1) |
| session_id | string | yes | Session id from new_session (required for all tools except new_session) |
Bulk place/replace many voxels in one call. Prefer this over thousands of place_block calls. Array of {x,y,z,color}.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| voxels | array | yes | Array of {x,y,z,color?} |
| session_id | string | yes | Session id from new_session (required for all tools except new_session) |
Delete the voxel at integer coordinates (noop if empty).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| x | integer | yes | — |
| y | yes | — | |
| z | yes | — | |
| session_id | string | yes | Session id from new_session (required for all tools except new_session) |
Move a block from one position to another; optional new color.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| from_x | integer | yes | — |
| from_y | yes | — | |
| from_z | yes | — | |
| to_x | yes | — | |
| to_y | yes | — | |
| to_z | yes | — | |
| color | string | no | Hex color #RRGGBB |
| session_id | string | yes | Session id from new_session (required for all tools except new_session) |
Set the color of an existing block (#RRGGBB).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| x | integer | yes | — |
| y | yes | — | |
| z | yes | — | |
| color | string | yes | Hex color #RRGGBB |
| session_id | string | yes | Session id from new_session (required for all tools except new_session) |
List blocks in the session (paginated).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| offset | integer | no | — |
| limit | integer | no | — |
| session_id | string | yes | Session id from new_session (required for all tools except new_session) |
Return axis-aligned bounds of placed blocks.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| session_id | string | yes | Session id from new_session (required for all tools except new_session) |
Remove all blocks and physics joints from the session (session itself remains until end_session).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| session_id | string | yes | Session id from new_session (required for all tools except new_session) |
Load a VoxelShaper project_json (voxels plus optional physicsV1 joints) into the session.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| project_json | no | Project JSON object or string | |
| session_id | string | yes | Session id from new_session (required for all tools except new_session) |
Dump the session as VoxelShaper-compatible project_json, including physicsV1 when joints exist.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| session_id | string | yes | Session id from new_session (required for all tools except new_session) |
Create or update a Box3D joint between two disconnected voxel bodies. Coordinates are MCP Z-up. base_seed=null anchors to world. Hinge/slider/fixed, limits and motor are supported.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | no | Existing joint id to update; omit to create |
| name | string | no | — |
| type | string | yes | — |
| base_seed | no | Voxel seed for base body, or null for world | |
| moving_seed | array | yes | Voxel seed inside the body that should move |
| anchor | array | yes | World joint position [x,y,z] in MCP Z-up voxel units |
| axis | array | no | Joint axis in MCP Z-up coordinates; defaults to +Z |
| limits_enabled | boolean | no | — |
| limit_min | number | no | Hinge degrees or slider voxels |
| limit_max | number | no | Hinge degrees or slider voxels |
| motor_enabled | boolean | no | — |
| motor_speed | number | no | Hinge degrees/s or slider voxels/s |
| motor_strength | number | no | — |
| session_id | string | yes | Session id from new_session (required for all tools except new_session) |
List Box3D physics joints stored in the session.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| session_id | string | yes | Session id from new_session (required for all tools except new_session) |
Delete one physics joint by id.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | — |
| session_id | string | yes | Session id from new_session (required for all tools except new_session) |
Remove all physics joints while keeping voxels.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| session_id | string | yes | Session id from new_session (required for all tools except new_session) |
Build a colored 3MF from the current session voxels and return a short-lived GET download URL (RAM token, ~5 min, single-use). Physics metadata is not embedded in 3MF. No disk retention.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| filename | string | no | Suggested download filename (.3mf) |
| include_base64 | boolean | no | Opt-in: include base64 in the JSON response (default false — use url) |
| session_id | string | yes | Session id from new_session (required for all tools except new_session) |
Turn a short request into occupied voxels (editor Y is height) and return a short-lived CAD 3MF download (voxel-model-cad.3mf). Nothing is published or stored. A vessel is a closed printable shell (solid floor, open mouth). Name a Bambu printer (a1-mini, a1, p1s, x1c, h2d) and the model is fit inside that bed with 10 mm clearance. Pass size_mm or width_mm/depth_mm/height_mm to use those millimetre
| Parameter | Type | Required | Notes |
|---|---|---|---|
| request | string | yes | What to make, for example "a vase" |
| printer | string | no | Bambu Lab printer. a1-mini 180³, a1/p1s/x1c 256³, h2d 325×320×325 (right nozzle). Default a1-mini only if size is also omitted. |
| size_mm | number | no | Longest side in mm. Used as given when it fits the printer. Do not pass together with width_mm/depth_mm/height_mm. |
| width_mm | number | no | Target width (Bambu X) in mm. Wins over the printer default fit. |
| depth_mm | number | no | Target depth (Bambu Y) in mm. Wins over the printer default fit. |
| height_mm | number | no | Target height (Bambu Z, editor Y) in mm. Wins over the printer default fit. |
| color | string | no | Hex color #RRGGBB |
| title | string | no | — |
- Every tool, no call limit, and mcprush charges nothing
- A buyer key from your dashboard — the gateway refuses a call without one
- Answers through our gateway, so every call is in your log
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install Voxel Shaper – Free MCP or to call it, and its free tier carries no monthly call limit.
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
This listing is a hosted endpoint: the publisher runs it and we connect to it. The scanner reads packages and source, and neither exists to read here, so there is no grade — not a withheld one, an unmeasured one. What can be checked instead is on Installation: what it asks to reach and what it writes.
Release history
The gateway serves every install the publisher’s current release, so a release cannot be pinned or rolled back to here yet. The history below is for reading; the current release on file is 0.1.0.
- The version this listing went live with, after review.
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Any signed-in account that does not publish Voxel Shaper – Free MCP can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.