Pixibox AI MCP Server

A Model Context Protocol (MCP) server for Pixibox.ai — the 3D AI comparison platform. Generate 3D models from images or text using multiple AI providers, compare results in the arena, collaborate with teams, and manage your assets — all from MCP clients like Claude Desktop, Cursor, or VS Code.

Features

• Image-to-3D — Generate 3D models from reference images
• Text-to-3D — Create 3D models from text prompts
• Multi-model comparison — Use Trellis, Hunyuan3D, Rodin, TripoSG, and more
• Batch generation — Submit multiple jobs at once
• Texture generation — AI textures, style transfer, PBR presets
• Model optimization — Mesh decimation, LOD generation
• Rigging & Animation — Auto-rig characters and apply animations
• Arena & Leaderboard — Compare AI models via ELO-rated battles
• Gallery — Browse and publish public 3D assets
• Teams & Collaboration — Share assets, add comments, 3D annotations, review workflows
• Versioning — Track iterations of your generations
• Polling — Built-in polling for async generation and batch tasks

Installation

Option 1: Run with npx (Recommended)

{
  "mcpServers": {
    "pixibox-ai": {
      "command": "npx",
      "args": ["-y", "pixi-mcp-server"],
      "env": {
        "PIXIBOX_API_KEY": "your_api_key_here"
      }
    }
  }
}

Option 2: Clone and Build Locally

git clone https://github.com/aerovfx/pixi-mcp-server.git
cd pixi-mcp-server
npm install
npm run build

Then configure your MCP client:

{
  "mcpServers": {
    "pixibox-ai": {
      "command": "node",
      "args": ["/absolute/path/to/pixi-mcp-server/dist/index.js"],
      "env": {
        "PIXIBOX_API_KEY": "your_api_key_here"
      }
    }
  }
}

Configuration

Get your API key from Pixibox.ai Settings → API Keys.

Environment Variables

Variable	Required	Default	Description
PIXIBOX_API_KEY	Yes	—	Your Pixibox API key
PIXIBOX_API_BASE	No	https://pixibox.ai/api	Override API base URL
PIXIBOX_POLL_TIMEOUT_MS	No	300000	Max polling wait (5 min)
PIXIBOX_POLL_INTERVAL_MS	No	3000	Polling interval (3 sec)

Available Tools

Generation (Core)

Tool	Description
create_generation	Submit image-to-3D or text-to-3D job
get_generation	Poll generation status
wait_for_generation	Wait for completion (auto-poll)
list_generations	List generation history
get_generation_output	Get 3D model download URL
export_generation	Convert to STL, OBJ, FBX, GLTF, etc.
delete_generation	Delete a generation
toggle_favorite	Favorite/unfavorite

Batch

Tool	Description
create_batch	Submit multiple generations
get_batch	Check batch status
wait_for_batch	Wait for all items to complete
list_batches	List batches
cancel_batch	Cancel a running batch
retry_batch	Retry failed items

Textures

Tool	Description
generate_texture	AI texture from text prompt
get_texture_presets	PBR material presets
style_transfer_texture	Texture from reference image

Model Optimization

Tool	Description
optimize_model	Mesh decimation & LOD

Rigging & Animation

Tool	Description
rig_model	Auto-rig (humanoid, quadruped)
apply_pose	Apply pose preset
animate_model	Generate animation
get_pose_presets	List pose presets
get_animation_templates	List animation templates

Arena & Leaderboard

Tool	Description
get_leaderboard	AI model ELO rankings
get_tool_detail	Full tool profile
get_random_battle	Get a battle to judge
vote_battle	Vote on a battle

Gallery

Tool	Description
browse_gallery	Search public assets
get_gallery_asset	Asset details
publish_to_gallery	Publish your generation
get_gallery_tags	Popular tags

Scenes

Tool	Description
list_scenes	Your saved scenes
create_scene	Save new scene
get_scene	Load a scene
delete_scene	Delete a scene

Teams & Collaboration

Tool	Description
list_teams	Your teams
create_team	Create a team
share_to_team	Share a generation
list_team_assets	Team's shared assets
list_comments	Comments on a generation
add_comment	Add a comment (with threading)
list_annotations	3D annotations
add_annotation	Pin annotation on model
request_review	Submit for review
update_review	Approve/reject review

Versioning

Tool	Description
list_versions	Generation versions
create_version	Create new version

Account & Utility

Tool	Description
get_me	Account info
get_subscription	Tier & limits
get_usage	Remaining credits
get_bitbot_balance	Token balance
get_notifications	Your notifications
list_ai_models	Available AI models
get_export_formats	Supported export formats

Image Generation

Tool	Description
generate_hunyuan_image	Tencent Hunyuan text-to-image

Example Usage

Generate a 3D model from text

Use create_generation with model "trellis" and prompt "a cute robot character"
Then use wait_for_generation with the returned generation_id

Compare two AI models

Use create_batch with items:
  - model: "trellis", prompt: "medieval castle"
  - model: "hunyuan3d-2", prompt: "medieval castle"
Then use wait_for_batch to get both results

Browse the leaderboard

Use get_leaderboard with category "image_to_3d" to see which AI model is best

Development

echo "PIXIBOX_API_KEY=your_key_here" > .env
npm run dev

License

MIT