Goxel MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DISPLAY | No | Variável de ambiente do X11/Wayland para abrir a GUI na tela no Linux. | :0 |
| GOXEL_BIN | No | Caminho completo do executável ou AppImage do Goxel. | goxel |
| GOXEL_OUTPUT_DIR | No | Diretório padrão onde personagens e objetos gerados serão armazenados. | ./output_voxels |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| goxel_create_characterC | Constrói um personagem em Voxel Art 3D (Arqueiro, Tanque, Mago, Suporte ou customizado) utilizando o Goxel e exporta para .vox e .obj. |
| goxel_create_objectB | Constrói um objeto, arma ou item de cenário em Voxel Art 3D (espada, escudo, cajado, arco, baú, poção, tocha, pilar). |
| goxel_run_custom_scriptB | Executa um script procedural JavaScript arbitrário dentro do motor QuickJS do Goxel para esculturas voxel complexas. |
| goxel_export_modelB | Converte um arquivo de voxels (.vox ou .gox) para .obj, .gltf ou render .png. |
| goxel_open_guiC | Abre a janela gráfica do Goxel com um modelo de voxels carregado na tela. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose: character generation, object generation, arbitrary script execution, format conversion, and GUI opening. The character/object split is well-defined by explicit examples (archetypes vs items/props), so misselection risk is low.
All tools follow a uniform goxel_verb_noun pattern (create_character, create_object, run_custom_script, export_model, open_gui). No mixed conventions or vague verbs.
Five tools is a well-scoped surface for a voxel art pipeline: generation (two flavors), scripting escape hatch, export, and GUI viewing. Each tool earns its place with no redundancy.
Core lifecycle is covered: create (character/object/custom), view (GUI), and export. Minor gaps exist around managing existing assets — no list/inspect, rename, delete, or direct edit of previously created models, though open_gui partially covers loading.