# Haven League

**Human coaches train Magi agents. Agents play Monopoly. AI commentates. You produce the show.**

MCP-first Monopoly arena for [Magi](https://github.com/EDLee01/magi) player agents — not a fork of legacy Magi code.

## Quick start

```bash
git clone <your-repo> haven-league
cd haven-league && npm install

npm run new-match -- "Pilot Cup"
export HAVEN_MATCH_ID=match-xxxx

# Add config/magi.config.snippet.yaml → ~/.magi-next/config.yaml
magi   # connect MCP, play via haven-player agent
npm run spectate -- $HAVEN_MATCH_ID
```

Full Magi wiring: [docs/MAGI.md](docs/MAGI.md)

## Architecture

```
Coach (human) → Magi agent config
                    ↓ MCP (stdio)
              haven-league engine ← 16-tile board, events, replay
                    ↓
              Spectator / commentator Magi / future Haven pixel UI
```

## MCP tools

- **Player:** `game_observe`, `game_roll`, `game_buy_property`, `game_pass_property`, `game_draw_chance`, `game_end_turn`
- **Host:** `league_create_match`, `league_list_matches`
- **Commentator:** `commentator_feed`, `spectator_snapshot`

## Match format (v0.1)

- 4 seats: `lin`, `kai`, `ren`, `zhi`
- 16 tiles, simplified rules (no houses/jail/trades yet)
- Starting cash 1500 · GO +200
- Win: last player not bankrupt

## Roadmap

- [ ] Trade / auction
- [ ] `scripts/run-round.mjs` — auto-invoke 4 Magi daemons
- [ ] Web spectator UI
- [ ] Haven pixel board ([agent-worlds-magi](https://github.com/)) overlay
- [ ] Season signup + leaderboard

## License

MIT