mcp server

cubelife

Give your AI agent a persistent pixel-art character. Node SDK, Python SDK, CLI, and MCP server.

Ivy-Innovation/cubelifecommunitylistedunreviewed

Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

Node.js 20 or newer

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "cubelife": {
      "command": "npx",
      "args": [
        "-y",
        "cubelife"
      ],
      "env": {
        "CUBELIFE_API_KEY": "<your CUBELIFE_API_KEY>",
        "CUBELIFE_AGENT_ID": "<your CUBELIFE_AGENT_ID>"
      }
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 17, 2026

Characters live in a pixel-art room, perform activities based on agent state, show emotions, and have creature companions. View them at life.cubeworld.co.za, on the desktop companion, or embedded in your own app via <iframe>.

Packages

This repo contains three packages:

Package	Install	Description
`@cubelife/sdk`	`npm install @cubelife/sdk`	Node.js SDK for state reporting
`cubelife`	`npm install -g cubelife`	CLI + MCP server for AI coding tools
`cubelife`	`pip install cubelife`	Python SDK for state reporting

Quick start

MCP server (for Claude Code, Cursor, Copilot, Windsurf, Cline, Codex)

npx cubelife tutorial           # create account + agent
npx cubelife setup claude-code  # auto-configure MCP

Your agent gets four tools: cubelife_report, cubelife_complete, cubelife_error, cubelife_status.

Node SDK

npm install @cubelife/sdk

import { CubeLifeClient } from '@cubelife/sdk';

const client = new CubeLifeClient({ apiKey: process.env.CUBELIFE_API_KEY });
await client.report('coding', { detail: 'Building the login page', progress: 0.5 });
await client.report('complete', { detail: 'Login page shipped' });

Python SDK

pip install cubelife

from cubelife import CubeLifeClient

client = CubeLifeClient("your-agent-key")
client.report("coding", detail="Building the login page", progress=0.5)
client.report("complete", detail="Login page shipped")

Creature companions

Every agent gets a creature companion (fox, owl, cat, dragon, wolf, phoenix, or slime) that reacts alongside the character.

MCP server

The CLI includes an MCP server for AI coding tools. Auto-configure for your tool:

npx cubelife setup claude-code    # Claude Code
npx cubelife setup cursor         # Cursor
npx cubelife setup windsurf       # Windsurf
npx cubelife setup copilot        # GitHub Copilot
npx cubelife setup cline          # Cline
npx cubelife setup codex          # Codex

Or manually: claude mcp add cubelife -- npx cubelife mcp

Licence

MIT (source code). Pixel art sprite assets are proprietary (see SPRITE-LICENSE).