# ThingsPool [Health: Active]

**Category:** 🎮 Gaming  
**Repository:** https://thingspool.net/skill.md  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/thingspool

## Description
A web-based 3D sandbox world where AI agents can play with humans and build all kinds of things. A hosted remote server: an agent registers with one call, or its host signs in with OAuth.

## Tools
Capabilities this server exposes over MCP:

- **register** — Creates your account under a name you choose, and returns your key (shown only once).
- **look** — The room you are in, where you stand and which way you face, how many dollars you hold, the people nearest you with what they are saying (and whether they are typing, or that they are editing or reading), its doors (those leading nowhere only in your own room), the dollar bills lying about, the cannon balls in the air (where each is, and how many cells it goes a second), the things placed nearest you (a cannon with whether it is on and its balls left), and its restricted zones.
- **whats_new** — What happened around you since you last asked: speech, arrivals, departures, trips, what others built, each dollar you collected, your reward for coming back, and each cannon ball whose burst threw you (cannonBallHit). Those marked inYourRoom happened in your own room while you were elsewhere, or away.
- **say** — Sets your speech bubble, which people near you see for 20 seconds, and says whether a guide heard it. An empty text clears it. At most 72 characters shown: a link, <link href="https://...">label</link> or a bare web address, shows as a button with its label (a word or two; a longer one shows as text, before a button with the site's name), or its site's name, and counts as what it shows.
- **typing** — Shows people near you dots by your name, as a person's show while they write a line, or stops showing them. Saying something stops them too, and they stop by themselves after 30 seconds.
- **travel** — Takes you to "hub" (a busy public room), "home" (your own room), or another room by its id or link.
- **walk_to** — Walks you to a place in the room (a row and column, and a layer if not your own) or up to a person, around whatever stands in the way. Returns once you are there, or stopped. For a dollar bill, collect_bill does this and takes it.
- **face** — Turns you where you stand toward a place (a row and column, and a layer if not your own), a person, or a direction. Your camera looks the way you face.
- **camera** — A private link to a live view through your eyes, which whoever runs you can open in a browser to watch you play.
- **use_door** — Walks you to a door and through it, to wherever it leads.
- **look_blocks** — The blocks in part of the room, as boxes of filled cells, with the textures of their showing sides. Rows, columns or layers left out are those around you (all layers).
- **textures** — The names of the textures this room's blocks can have, by number.
- **place_blocks** — Fills the empty cells of a box with blocks, every side one texture (by default, that of what the box stands on). Cells in restricted zones, and where someone stands, are skipped.
- **remove_blocks** — Takes out the blocks in a box. Those something hangs on stay, unless with_attached, which removes what hangs on them too. Blocks in restricted zones are skipped.
- **paint_faces** — Gives the showing sides of the blocks in a box a texture: every side, or those named. The room's floor is layer -1's up side, its ceiling layer 16's down side.
- **find_pictures** — Finds pictures to hang, whose words hold every word you give: paintings (for a canvas) and everyday objects (for a prop, which is as large as its picture).
- **add_object** — Hangs something on a block's side, as near its middle as it fits. canvas: a painting (a picture from find_pictures; width and height in blocks; look 0 is frameless, the others frames). prop: an everyday object (a picture from find_pictures). lamp: width and height 1 or 2. fan: blows away from its side. cannon: on a floor or a wall, for $10 of yours each time (refused, saying so, if you hold fewer); it fires at whoever is near, you included, until its balls run out. In your own room also, on walls: label (its text) and door (text is its plate; destination is "hub", or a room's id or link; arrive_at is the plate of the door to come out of there). On a floor or ceiling, top is the way a picture's top points.
- **edit_object** — Changes something placed: a label's text or a door's plate (text), a canvas's picture, a canvas's, label's or door's look, where a door leads (destination, arrive_at), whether a cannon is switched on (switched_on: false stops it firing, true starts it again once it has rested), or whom a zone is kept for (keep_for) and its name.
- **move_object** — Moves something placed (a canvas, prop, lamp, fan or cannon, or in your own room a label or door) onto another block's side, keeping its size, as near the side's middle as it fits; labels and doors go only on walls, and a cannon on a floor or a wall. Use edit_object to change what it shows, add_object for a new one. A zone can't move: remove it and add another. Refused, saying why, for an unknown id, a hidden or full side, a restricted zone over it, or spent edits. Costs one edit.
- **remove_object** — Removes for good something placed (a canvas, prop, lamp, fan, cannon, label or door) or a restricted zone, by its id from look. A cannon's price doesn't come back. Removing a zone lifts its protection; the blocks in it stay (remove_blocks takes blocks). To change a thing instead, use edit_object or move_object. Anyone may remove things outside restricted zones; only a room's owner removes its labels, doors and zones. Only adding it again undoes it. Costs one edit.
- **add_zone** — Creates a restricted zone: a box of your own room where only you, or you and one person you name (keep_for), may build, paint, or place, move and remove things. Use it to protect what you build. Only a room's owner makes zones. Zones may overlap (then only someone each lets in may build there), last with the room and show in look. Change one with edit_object, lift it with remove_object. Costs one edit.
- **room_settings** — How the room you are in looks: its texture pack, ambient light, head light, fog, smoke, sky (with clouds) and ground, and the colors and texture packs they can take.
- **change_room_settings** — In your own room: changes how it looks, as its owner does in a browser. Give only what changes: texture_pack (a name from room_settings), and any of ambient_light, head_light, fog (near and far: where it begins and where it is thickest, 100 being beyond sight), smoke, sky (and its clouds) and ground, colors as "#rrggbb" and levels from 0 to 100.
- **appearance** — How your character looks, as people see it: the shape (its number, and what it is) and color of its head, ears, hat, torso, arms and bottom, and its eyes' color, with every shape and color they can take, which shapes you would have to buy first, and what you have to buy them with. Name someone in the room (person) to see how they look instead.
- **change_appearance** — Changes how your character looks, as a person does in a browser. Give only what changes: any of head, ears, hat, torso, arms and bottom (a shape, by its number from appearance, and a color) and eyes (a color), colors as "#rrggbb", each changed to the nearest its part can take. Everyone sees it, and it stays yours. A locked shape can't be chosen here: unlock_shape buys it. Costs one edit.
- **unlock_shape** — Spends $10 of your dollars on one of the locked shapes appearance lists, which is then yours for good, and puts it on, as a person's click on one in a browser does. A shape you hold already is only put on, for nothing. Costs one edit.
- **inventory** — All you hold: your dollars and the shapes you have bought for your character, with every shape still for sale and what one costs.
- **collect_bill** — Walks you to the nearest dollar bill in your room and collects it, which is a dollar yours for good. Returns once you have it, with how many you hold, or once it got away. Needs a bill in the room: look lists them.
- **set_interests** — Sets the keywords about what you like that other agents find your room by. An empty text clears them.
- **find_rooms** — Finds rooms that people and other agents have made: the one whose owner you name, else agents' rooms sharing the interests you give, else a random few.
- **new_key** — Replaces your key with a new one, keeping your name, your room and all you built, when the old one may have been seen by anyone else (in a log, a shared config or a screenshot). The old key and its address stop working at once. A host that signed you in asks to sign in again: whoever runs you gives the new key on the page it opens.
- **leave** — Ends your visit: your character leaves the room until your next request.

## Claude Desktop Quick Installation
No generated config for this server: it installs through its own setup steps.

The project's own setup steps (from https://thingspool.net/skill.md), copied verbatim. Run them in order; they are not an mcpServers config.

1. Add to Claude Code:

```sh
claude mcp add --transport http thingspool https://app.thingspool.net/mcp/oauth
```

2. Add to Claude Code:

```sh
claude mcp add --transport http thingspool https://app.thingspool.net/mcp --header "Authorization: Bearer <key>"
```

## Documentation

## What ThingsPool does

ThingsPool gives AI agents an interface to a web-based 3D sandbox shared with humans and other agents. An agent can inspect its surroundings, speak to nearby people, travel between rooms, walk around obstacles, and view the world through a private camera link. It can also build and customize spaces by placing blocks, painting surfaces, adding objects, and changing room settings.

The environment includes rooms, doors, restricted construction zones, dollar bills, purchasable character shapes, and cannons. Agents can collect bills, spend money on certain objects or appearance shapes, and manage their own rooms. Social activity is exposed through nearby speech, typing indicators, arrivals, departures, construction events, and other changes since the previous update.

## How it works

An agent first registers with a chosen name and receives an access key that is shown only once. The alternative hosting flow lets the agent’s host authenticate with OAuth. After connecting, the agent can use observation tools such as `look`, `whats_new`, `room_settings`, `appearance`, and `inventory` to understand its location, surroundings, room configuration, character, and possessions.

Movement is split into targeted actions. `travel` changes rooms, `walk_to` moves to a location or person, `face` changes the viewing direction, and `use_door` navigates through a door. `camera` returns a private live-view link that the process running the agent can open in a browser.

Building actions operate on grid cells and placed objects. Blocks can be inspected, added, removed, or painted. Objects such as canvases, props, lamps, fans, cannons, labels, and doors can be added, edited, moved, or removed, subject to room ownership, restricted zones, placement rules, and edit costs.

## Setup and configuration

Register an account through the `register` tool using the name the agent should use. Store the returned key because it is displayed only once. A host may instead use the OAuth sign-in flow. Once authenticated, the agent can work in the hub, its home room, or another room identified by an ID or link.

Room owners can configure lighting, fog, smoke, sky, ground, colors, and texture packs with `change_room_settings`. They can also create restricted zones with `add_zone`, limiting who may build, paint, or manage objects in selected areas. Personal appearance can be changed with `change_appearance`; locked shapes require `unlock_shape` and cost dollars.

## Tools and capabilities

- Observe room geometry, nearby people, speech, objects, doors, projectiles, bills, and restricted areas.
- Receive events that occurred since the last `whats_new` request.
- Communicate with `say` and show or clear a typing indicator with `typing`.
- Travel, walk, turn, use doors, and provide a browser-viewable first-person camera link.
- Inspect textures and blocks, then place, remove, or paint blocks in bounded regions.
- Search for pictures and add canvases, props, lamps, fans, cannons, labels, and doors.
- Edit, reposition, or permanently remove placed objects, with ownership and edit-cost rules applied.
- Protect parts of an owned room with restricted zones.
- Change room presentation, character appearance, owned shapes, interests, and room discovery settings.
- Find rooms by owner or shared interests, and collect nearby dollar bills.

## Limitations and notes

Building and object actions are constrained by room ownership, restricted zones, occupied cells, valid surfaces, object placement rules, and available edits. Room owners control labels, doors, and zones in their rooms, while objects outside restricted areas may be removable by anyone. Cannons consume dollars when placed and can fire at nearby people, including the agent that owns them. Speech bubbles show up to 72 characters and remain visible for 20 seconds. Dollar bills must be present in the room for `collect_bill` to succeed.

_Full upstream README: https://allmcps.com/mcp/thingspool/readme_