Koskamo

VoxelDraft MCP

A remote MCP server for AI assistants to create, edit, render, save, and export voxel models. It supports compact geometry commands, real-time WebGL previews, and exports to OBJ, GLB, VOX, and Minecraft Schematic formats without requiring per-voxel JSON verbosity.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

VoxelDraft MCP logo, by VoxelDraftCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-07Published by VoxelDraft
MCP endpoint (Streamable HTTP)
https://voxeldraft.com/api/mcp
Vendor documentation

What its tools do

8 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Read-only (1)

Can change data (7)

8 of 8 have a description · 8 of 8 declare behavior hints · 1 of 7 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Warning Advertises resources/templates/list but does not implement it
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Create voxel models using high-level geometry commands
  • Edit and inspect existing voxel structures
  • Render voxel art as cached PNG images or interactive 3D scenes
  • Export optimized OBJ/MTL assets with hidden-face culling

Source and maintenance

Community listingRegistry 0.5.1
mcp-registry: io.github.huruki-geo/voxeldraft@0.5.1

Protocol and capabilities

Server
VoxelDraft MCP 0.5.1
MCP protocol negotiated in check
2025-11-25
Tools
8 advertised
Resources
1 advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": false
  },
  "resources": {
    "listChanged": false
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Free voxel modeling tools backed by VoxelDraft. Use VoxelDraft's compact instruction stream instead of emitting one JSON object per voxel. Coordinates are integers 0..63. Colors are either #RRGGBB or a zero-based palette index. Commands: ["box",x1,y1,z1,x2,y2,z2,color,hollow?] ["ellipsoid",cx,cy,cz,rx,ry,rz,color,hollow?] ["cylinder","x"|"y"|"z",x,y,z,radius,height,color,hollow?] ["line",x1,y1,z1,x2,y2,z2,color] ["roof","x"|"z",x1,y1,z1,x2,y2,z2,color] (gable roof, axis is ridge direction) ["runs","x"|"y"|"z",color,[[x,y,z,length],...]] (preferred exact/freeform representation) ["points",color,[[x,y,z],...]] (sparse details only) ["erase",x1,y1,z1,x2,y2,z2] ["recolor",fromColor,toColor] ["copy",x1,y1,z1,x2,y2,z2,dx,dy,dz] ["repeat",x1,y1,z1,x2,y2,z2,dx,dy,dz,count] ["mirror","x"|"y"|"z",plane,x1,y1,z1,x2,y2,z2] (plane is a grid boundary 0..64) Prefer box/roof/ellipsoid/cylinder for bulk geometry, runs for irregular silhouettes, repeat/mirror for repeated or symmetric parts, and points only for small details. This usually uses far fewer model tokens than raw voxel JSON. Use the returned modelRef for edit/inspect/render/export/save calls; do not reconstruct the underlying model handle. Anonymous and Free users can create, edit, inspect, export, and receive interactive render URLs without an account. ChatGPT can render render_voxel_model results in an interactive Three.js widget. Cached server-rendered PNG images require a linked VoxelDraft Plus account and are subject to image credits and rate limits. Private cloud save/load/list tools use OAuth when requested.

Tools

8 advertised

create_voxel_model — Create voxel model
Advertised by the server during the last successful anonymous check.

Create an editable VoxelDraft model from compact commands. Returns a short modelRef for later plugin calls and does not save to Cloud Projects. Use VoxelDraft's compact instruction stream instead of emitting one JSON object per voxel. Coordinates are integers 0..63. Colors are either #RRGGBB or a zero-based palette index. Commands: ["box",x1,y1,z1,x2,y2,z2,color,hollow?] ["ellipsoid",cx,cy,cz,rx,ry,rz,color,hollow?] ["cylinder","x"|"y"|"z",x,y,z,radius,height,color,hollow?] ["line",x1,y1,z1,x2,y2,z2,color] ["roof","x"|"z",x1,y1,z1,x2,y2,z2,color] (gable roof, axis is ridge direction) ["runs","x"|"y"|"z",color,[[x,y,z,length],...]] (preferred exact/freeform representation) ["points",color,[[x,y,z],...]] (sparse details only) ["erase",x1,y1,z1,x2,y2,z2] ["recolor",fromColor,toColor] ["copy",x1,y1,z1,x2,y2,z2,dx,dy,dz] ["repeat",x1,y1,z1,x2,y2,z2,dx,dy,dz,count] ["mirror","x"|"y"|"z",plane,x1,y1,z1,x2,y2,z2] (plane is a grid boundary 0..64) Prefer box/roof/ellipsoid/cylinder for bulk geometry, runs for irregular silhouettes, repeat/mirror for repeated or symmetric parts, and points only for small details. This usually uses far fewer model tokens than raw voxel JSON.

create_voxel_model input schema
{
  "type": "object",
  "required": [
    "commands"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 80
    },
    "palette": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^#[0-9a-fA-F]{6}$"
      },
      "maxItems": 64
    },
    "commands": {
      "type": "array",
      "items": {
        "type": "array",
        "items": {},
        "minItems": 1
      },
      "maxItems": 512
    }
  },
  "additionalProperties": false
}
create_voxel_model annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": false
}
edit_voxel_model — Edit voxel model
Advertised by the server during the last successful anonymous check.

Edit the temporary model identified by modelRef and return a new modelRef. This does not modify a saved cloud project. Use VoxelDraft's compact instruction stream instead of emitting one JSON object per voxel. Coordinates are integers 0..63. Colors are either #RRGGBB or a zero-based palette index. Commands: ["box",x1,y1,z1,x2,y2,z2,color,hollow?] ["ellipsoid",cx,cy,cz,rx,ry,rz,color,hollow?] ["cylinder","x"|"y"|"z",x,y,z,radius,height,color,hollow?] ["line",x1,y1,z1,x2,y2,z2,color] ["roof","x"|"z",x1,y1,z1,x2,y2,z2,color] (gable roof, axis is ridge direction) ["runs","x"|"y"|"z",color,[[x,y,z,length],...]] (preferred exact/freeform representation) ["points",color,[[x,y,z],...]] (sparse details only) ["erase",x1,y1,z1,x2,y2,z2] ["recolor",fromColor,toColor] ["copy",x1,y1,z1,x2,y2,z2,dx,dy,dz] ["repeat",x1,y1,z1,x2,y2,z2,dx,dy,dz,count] ["mirror","x"|"y"|"z",plane,x1,y1,z1,x2,y2,z2] (plane is a grid boundary 0..64) Prefer box/roof/ellipsoid/cylinder for bulk geometry, runs for irregular silhouettes, repeat/mirror for repeated or symmetric parts, and points only for small details. This usually uses far fewer model tokens than raw voxel JSON.

edit_voxel_model input schema
{
  "type": "object",
  "required": [
    "modelRef",
    "commands"
  ],
  "properties": {
    "palette": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^#[0-9a-fA-F]{6}$"
      },
      "maxItems": 64
    },
    "commands": {
      "type": "array",
      "items": {
        "type": "array",
        "items": {},
        "minItems": 1
      },
      "maxItems": 512
    },
    "modelRef": {
      "type": "string",
      "maxLength": 64,
      "description": "Short temporary VoxelDraft model reference returned by model tools"
    }
  },
  "additionalProperties": false
}
edit_voxel_model annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": false
}
inspect_voxel_model — Inspect voxel model
Advertised by the server during the last successful anonymous check.

Inspect a temporary VoxelDraft modelRef. Returns voxel count, command count, bounds, and colors.

inspect_voxel_model input schema
{
  "type": "object",
  "required": [
    "modelRef"
  ],
  "properties": {
    "modelRef": {
      "type": "string",
      "maxLength": 64,
      "description": "Short temporary VoxelDraft model reference returned by model tools"
    }
  },
  "additionalProperties": false
}
inspect_voxel_model annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": false
}
render_voxel_model — Render voxel model
Advertised by the server during the last successful anonymous check.

Preview a VoxelDraft modelRef. ChatGPT can render an interactive Three.js/WebGL widget; everyone also receives an interactive WebGL URL. Signed-in VoxelDraft Plus users may additionally receive a cached PNG when includeImage is true.

render_voxel_model input schema
{
  "type": "object",
  "required": [
    "modelRef"
  ],
  "properties": {
    "view": {
      "enum": [
        "iso",
        "front",
        "back",
        "left",
        "right",
        "top",
        "bottom"
      ],
      "type": "string",
      "default": "iso"
    },
    "language": {
      "enum": [
        "en",
        "ja",
        "zh",
        "es"
      ],
      "type": "string",
      "default": "en"
    },
    "modelRef": {
      "type": "string",
      "maxLength": 64,
      "description": "Short temporary VoxelDraft model reference returned by model tools"
    },
    "imageSize": {
      "enum": [
        256,
        512,
        1024
      ],
      "type": "integer",
      "default": 512
    },
    "background": {
      "enum": [
        "solid",
        "transparent"
      ],
      "type": "string",
      "default": "solid"
    },
    "includeImage": {
      "type": "boolean",
      "default": true
    }
  },
  "additionalProperties": false
}
render_voxel_model output schema
{
  "type": "object",
  "required": [
    "model",
    "modelRef",
    "name",
    "stats",
    "renderer",
    "rendererVersion",
    "view",
    "imageSize",
    "background",
    "editUrl",
    "renderUrl"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "view": {
      "enum": [
        "iso",
        "front",
        "back",
        "left",
        "right",
        "top",
        "bottom"
      ],
      "type": "string"
    },
    "image": {
      "type": "object"
    },
    "model": {
      "type": "string"
    },
    "quota": {
      "type": "object"
    },
    "stats": {
      "type": "object",
      "required": [
        "voxelCount",
        "commandCount",
        "colors",
        "bounds"
      ],
      "properties": {
        "bounds": {
          "anyOf": [
            {
              "type": "object",
              "required": [
                "min",
                "max",
                "size"
              ],
              "properties": {
                "max": {
                  "type": "array",
                  "items": {
                    "type": "integer"
                  },
                  "maxItems": 3,
                  "minItems": 3
                },
                "min": {
                  "type": "array",
                  "items": {
                    "type": "integer"
                  },
                  "maxItems": 3,
                  "minItems": 3
                },
                "size": {
                  "type": "array",
                  "items": {
                    "type": "integer"
                  },
                  "maxItems": 3,
                  "minItems": 3
                }
              },
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "colors": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "voxelCount": {
          "type": "integer",
          "minimum": 0
        },
        "commandCount": {
          "type": "integer",
          "minimum": 0
        }
      },
      "additionalProperties": false
    },
    "reason": {
      "type": "string"
    },
    "editUrl": {
      "type": "string"
    },
    "modelRef": {
      "type": "string",
      "maxLength": 64,
      "description": "Short temporary VoxelDraft model reference returned by model tools"
    },
    "renderer": {
      "type": "string"
    },
    "imageSize": {
      "enum": [
        256,
        512,
        1024
      ],
      "type": "integer"
    },
    "renderUrl": {
      "type": "string"
    },
    "background": {
      "enum": [
        "solid",
        "transparent"
      ],
      "type": "string"
    },
    "imageError": {
      "type": "string"
    },
    "downloadUrl": {
      "type": "string"
    },
    "imageAvailable": {
      "type": "boolean"
    },
    "rendererVersion": {
      "type": "string"
    }
  },
  "additionalProperties": false
}
render_voxel_model annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": false
}
export_voxel_model — Export voxel model
Advertised by the server during the last successful anonymous check.

Create direct download URLs for OBJ+MTL or compact VoxelDraft JSON from a modelRef.

export_voxel_model input schema
{
  "type": "object",
  "required": [
    "modelRef"
  ],
  "properties": {
    "format": {
      "enum": [
        "obj",
        "json"
      ],
      "type": "string",
      "default": "obj"
    },
    "modelRef": {
      "type": "string",
      "maxLength": 64,
      "description": "Short temporary VoxelDraft model reference returned by model tools"
    }
  },
  "additionalProperties": false
}
export_voxel_model annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": false
}
save_voxel_model — Save voxel model to my VoxelDraft account
Advertised by the server during the last successful anonymous check.
Advertised destructive

Save the temporary model identified by modelRef to private VoxelDraft Cloud Projects. Requires project-write OAuth scope. Pass projectId to update an existing owned cloud project.

save_voxel_model input schema
{
  "type": "object",
  "required": [
    "modelRef"
  ],
  "properties": {
    "modelRef": {
      "type": "string",
      "maxLength": 64,
      "description": "Short temporary VoxelDraft model reference returned by model tools"
    },
    "projectId": {
      "type": "string",
      "maxLength": 120
    }
  },
  "additionalProperties": false
}
save_voxel_model annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": true
}
list_voxel_projects — List my VoxelDraft projects
Advertised by the server during the last successful anonymous check.
Advertised read-only

List private VoxelDraft Cloud Projects. Requires project-read OAuth scope.

list_voxel_projects input schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
list_voxel_projects annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}
load_voxel_project — Load a VoxelDraft project
Advertised by the server during the last successful anonymous check.

Load one private Cloud Project and return a short modelRef for later plugin calls. Requires project-read OAuth scope.

load_voxel_project input schema
{
  "type": "object",
  "required": [
    "projectId"
  ],
  "properties": {
    "language": {
      "enum": [
        "en",
        "ja",
        "zh",
        "es"
      ],
      "type": "string",
      "default": "en"
    },
    "projectId": {
      "type": "string",
      "maxLength": 120
    }
  },
  "additionalProperties": false
}
load_voxel_project annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

1 advertised

VoxelDraft 3D Preview

Advertised by the server during the last successful anonymous check.

Interactive Three.js preview for a VoxelDraft model.

VoxelDraft 3D Preview URI
ui://widget/voxeldraft-preview-v8.html

MIME type: text/html;profile=mcp-app

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
696 ms
95th percentile latency
696 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 696 ms · metadata changed · 8 tool(s), 1 resource(s); warnings: Advertises resources/templates/list but does not implement it

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http voxeldraft-mcp https://voxeldraft.com/api/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add voxeldraft-mcp --url https://voxeldraft.com/api/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable voxeldraft-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "voxeldraft-mcp": {
      "url": "https://voxeldraft.com/api/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "voxeldraft-mcp": {
      "type": "streamableHttp",
      "url": "https://voxeldraft.com/api/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start voxeldraft-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "voxeldraft-mcp": {
      "type": "http",
      "url": "https://voxeldraft.com/api/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http voxeldraft-mcp https://voxeldraft.com/api/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://voxeldraft.com/api/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "voxeldraft-mcp": {
      "serverUrl": "https://voxeldraft.com/api/mcp"
    }
  }
}

Let your agent find its tools

Find servers like VoxelDraft MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 589