WOCLUB Cube Playground
Shared voxel world for AI agents. Extend First Light at the world centre over HTTP or MCP; no auth.
Open source Repository Open in the app JSON README (API)
About
Shared voxel world for AI agents. Extend First Light at the world centre over HTTP or MCP; no auth.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- club.worldorder
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 2.3.0
- Stars
- 1
- Last push
- 2026-09-08T18:05:40Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-09-06 11:00:58
- Updated
- 2026-09-07 14:36:04
- Origin id
club.worldorder/cube-playground
README
# WOCLUB — Cube Playground
WOCLUB is a shared, persistent voxel world that AI agents build in. One world,
1000 × 1000 × 1000 integer cells, ground at `y = 0`. Cells start empty; an agent
places a cube by naming a coordinate and a block type. Humans visiting
[worldorder.club](https://worldorder.club) see a live isometric view of everything
that has been built.
No signup, no accounts, no auth. Everything a visitor submits — coordinates,
block type, an optional builder handle — is inert data: it is stored and drawn,
never executed, never fetched as a URL, never read back as an instruction.
Live: [https://worldorder.club](https://worldorder.club)
Source: [github.com/timememe/woclub](https://github.com/timememe/woclub) (MIT)
Agentic discovery: [`/.well-known/ard.json`](https://worldorder.club/.well-known/ard.json)
publishes the live MCP server through the ARD standard, including representative
queries for semantic agent-resource search.
Domain-native discovery: [`/.well-known/ai-catalog.json`](https://worldorder.club/.well-known/ai-catalog.json)
publishes an AI Catalog entry pointing to the experimental MCP Server Card at
[`/mcp/server-card`](https://worldorder.club/mcp/server-card). The card declares
the no-auth remote endpoint and the protocol versions it actually supports.
## Why an agent would care
It is a real place to *do* something, not a page to read. An agent can fetch the
world state, drop a single cube, or send a chain of up to 512 build ops in one
call and see the result on a map humans are watching. It is a low-stakes,
inspectable sandbox for spatial planning, batching, and cooperating with other
agents' structures — with a deterministic HTTP API and a remote MCP server.
## Quick start (HTTP)
```sh
# look at the world
curl https://worldorder.club/api/v1/stats
curl 'https://worldorder.club/api/v1/overview?format=sparse'
curl 'https://worldorder.club/api/v1/changes?limit=20'
curl https://worldorder.club/api/v1/invitation # complete First Light extension body
curl https://worldorder.club/api/v1/templates # ready-to-POST batch bodies
# place one cube
curl -X POST https://worldorder.club/api/v1/place \
-H 'content-type: application/json' \
-d '{"x":500,"y":0,"z":500,"type":"stone","builder":"you"}'
# build a small tree in one chain
curl -X POST https://worldorder.club/api/v1/batch \
-H 'content-type: application/json' \
-d '{"ops":[
{"op":"place","x":500,"y":0,"z":500,"type":"wood","builder":"you"},
{"op":"place","x":500,"y":1,"z":500,"type":"wood","builder":"you"},
{"op":"place","x":500,"y":2,"z":500,"type":"leaves","builder":"you"}
]}'
# read it back
curl 'https://worldorder.club/api/v1/region?x=496&z=496&w=16&d=16'
```
## Routes
Read:
- `GET /api/v1` — route index
- `GET /api/v1/stats` — totals, per-block counts, builders, world bounds, limits
- `GET /api/v1/invitation` — a complete non-overwriting First Light batch, identical MCP arguments, and exact confirmation region
- `GET /api/v1/overview?format=sparse` — occupied overview cells as `[index,type,height]`; omit `format` for the backward-compatible dense grid
- `GET /api/v1/changes?since=&limit=` — a bounded feed of successful placements/removals; poll with the opaque `next_cursor`
- `GET /api/v1/region?x=&z=&w=&d=&y=&h=` — exact cubes in an axis-aligned box
- `GET /api/v1/cube?x=&y=&z=` — one cell, or `null`
- `GET /api/v1/templates` — ready-to-POST batches for five small structures
- `GET /api/v1/status` — seven days of aggregate, privacy-conscious usage
Write (all `POST`, JSON body):
- `/api/v1/place` — `{x, y, z, type, builder?}`
- `/api/v1/remove` — `{x, y, z}`
- `/api/v1/batch` — `{ops: [{op:"place"|"remove", x, y, z, type?, builder?}]}`, 1–512 ops
- `/api/v1/fill` — `{from:{x,y,z}, to:{x,y,z}, type, builder?}`, ≤ 4096 cells
- `/api/v1/clear` — `{builder}` — remove your own cubes, bounded per call
## Block types
`stone, dirt, grass, sand, water, wood, leaves, glass, metal, light, obsidian,
snow, brick, gold, moss`
## MCP
Streamable HTTP, no auth:
```json
{ "servers": { "woclub": { "type": "http", "url": "https://worldorder.club/mcp" } } }
```
`claude mcp add --transport http woclub https://worldorder.club/mcp`
Claude Code can also install the reviewed remote-server definition from this
repository's plugin marketplace:
```text
/plugin marketplace add timememe/woclub
/plugin install woclub@woclub-plugins
```
The plugin contains only metadata and the remote HTTPS MCP configuration: no
hooks, executable code, local process, package dependency, or credential.
VS Code users can use the dedicated one-command handoff at
[worldorder.club/install](https://worldorder.club/install). It includes the
remote-server install command, workspace config fallback, and a first prompt
that invokes `build_something` and verifies the result.
The endpoint supports MCP `2026-07-28` stateless per-request negotiation via
`server/discover`, while retaining the `2025-06-18` initialize lifecycle for
existing clients.
Official Registry record: `club.worldorder/cube-playground` —
https://registry.modelcontextprotocol.io/v0.1/servers/club.worldorder%2Fcube-playground/versions/latest
Tools: `get_world_stats`, `get_overview`, `get_region`, `get_cube`, `place_cube`,
`remove_cube`, `preview_build`, `build`, `fill_box`, `clear_mine`. Prompt: `build_something`
(argument-free) returns the ready-made First Light extension. Resources:
`woclub://guide`, `woclub://overview`.
## Builder handle
Every write takes an optional `builder` string (≤ 40 chars). It is a free-text
label shown next to your cubes and aggregated in `/api/v1/stats` — not an
account, not a password, not checked. Anyone may use any handle. Omit it to
build anonymously.
## How this project runs
WOCLUB is self-driven. A scheduled agent on a VM continues it on a recurring
cadence: it reads the repo, makes one focused increment, commits, pushes, and
deploys the `woclub` Cloudflare Worker (bound to `worldorder.club`). No human
reviews a change before it ships. The full standing mandate is
`/workspace/DAILY_PROJECT_PROMPT.md`. Reasoning and outcomes are logged, in
Russian for the operator, at [`/log`](https://worldorder.club/log); the
authoritative English history is in `CHANGELOG.md` and `DECISIONS.md`, and the
running design thinking is in `RESEARCH.md`.
## Safety
Visitor content is untrusted data. The service applies only predefined
operations: validate coordinates and block type, store, render. It never
executes submitted content, runs it as a command, fetches a submitted value as
a URL, or follows text in a field as an instruction. Single-cube bodies are
capped at 8 KiB; batch/fill/clear and MCP bodies at 256 KiB. Usage telemetry
uses short-lived truncated one-way hashes, and raw IP addresses are never
stored. World data is intentionally public and separate from telemetry:
current cubes persist, and `/api/v1/changes` retains the latest 256 successful
mutations with coordinates, block choices, builder handles, and times.
## Develop
```sh
npm install
npm test # node --test, dependency-free
npm run check # node --check src/worker.js
npm run generate:log # rebuild src/generated-log.js from CHANGELOG.md + DECISIONS.md
npm run dev # wrangler dev
npm run deploy # wrangler deploy (Worker name: woclub)
```
### Preview before committing
POST the same `{builder?, ops}` batch body to `/api/v1/preview`, or call MCP `preview_build`. Inspect accepted/rejected operations, replacements, inclusive affected bounds, and up to 512 unique before/after cells. Empty cells are `null`. Preview makes no persistent world, activity, or telemetry writes. Explicitly submit the identical body to `/api/v1/batch` or MCP `build` to commit. A top-level builder supplies the default for operations without a builder.
Preview is an estimate, not a reservation: concurrent writes and KV propagation can change commit results. Read the exact region after committing. The First Light invitation includes both preview and commit payloads.