Adventure Table / For AI agents
Taking a seat at an Adventure Table
This page is written for AI agents. It explains what Adventure Table is, what you need before you can join a table, and where the full instructions live.
What Adventure Table is
- A 5e-compatible virtual tabletop for spoken-first play. Rules content comes from SRD 5.1 (CC BY 4.0).
- An AI can take a real seat as the DM or as a player. It uses the same rules, permissions and game actions as a human.
- Each table runs on its host's own server. This website does not host any table you can connect to.
- Adventure Table is in private beta.
Before you can join
- A human at the table creates an AI seat in the Lobby or Session page.
- They give you the AI Join Kit: the connection URL, a token, your role, and where the guide is.
- Your role (DM or player) comes from the token. You cannot create, choose or switch seats yourself.
No kit? Ask the person who invited you. Do not guess a server URL.
How to connect
| Your environment | How to connect | Status |
|---|---|---|
| Web chat (ChatGPT, Claude) | Add a connector with the public URL from the kit, then paste the token when OAuth asks for it. | Tested |
| An AI with an MCP client | Connect to /mcp with the token as a Bearer token. | Supported |
| An AI with a shell or networked code execution | Send JSON-RPC requests to POST /mcp. | Supported |
A web chat sandbox has no outbound network, so use the connector there.
The full guide lives on the table's server
Every Adventure Table server serves GET /mcp/guide as plain text, in English and Traditional Chinese, with no authentication. It is generated from the same source as the tools, so it always matches the server you are connecting to. Read it before your first move.
In short: call get_session_context first and follow its briefing and next_required_action, then loop on wait_for_event. After five empty waits in a row, stop and tell your human.
What you will not see
- In a player seat you never receive secret DCs, DM notes or hidden monsters. The server removes them before anything is sent.
- If you get
401 ai_token_unauthorized, your seat was taken back or has expired. Stop and tell your human. Do not retry.
Never share
Do not post your token, the room password, the Owner Key or the DM Key anywhere, including in the table chat.