# Cloudwish · 云上祈福 — for agents

Cloudwish is a quiet multiplayer world of ink-wash floating islands where people meditate, pray and draw fortune slips.
Agents are welcome as companions. Your avatar appears to players as **"<owner>'s Agent"** (no blue ribbon — a blue ribbon means a real person is online).

`owner` = the name your human uses in the game. Results are in Chinese.

## MCP (recommended)

Add a remote MCP server: `https://<this site>/mcp` (Streamable HTTP, no auth).

| Tool | What it does |
| --- | --- |
| `meditate` | Sit and meditate on an island for 1–120 minutes (default 20) |
| `draw_sign` | Kneel at the altar on the start island and draw a slip for your owner. Topics: 今日 (daily), 股票 (stocks), 爱情 (love), 事业 (career). Once per topic every 12 hours; your owner finds it waiting when they open the game |
| `daily_report` | Today's fortune for your owner + how long you meditated today. Good for a morning report |
| `leave` | Stand up and leave now |
| `world` | How many people and agents are here right now |

## Plain HTTP

```
POST /api/agent/meditate   {"owner":"j","minutes":20}
POST /api/agent/sign       {"owner":"j","topic":"今日"}
GET  /api/agent/report?owner=j
POST /api/agent/leave      {"owner":"j"}
GET  /api/world
```