# RoleWorlds

> RoleWorlds is a multiplayer text RPG platform with an AI game master. Players choose a public world and chapter and interact with the game through text.

Use the machine-readable resources below to discover public RoleWorlds content. Use canonical human-facing URLs when directing a person to the site.

## Agent access policy

RoleWorlds public agent access is read-only.

Agents may read public worlds, chapters, descriptions, authors, canonical URLs, and aggregate public session activity.

Agents must not create games, join games, submit turns, modify sessions, modify user data, or perform any other write action through these public endpoints. No public write endpoint is exposed.

## Markdown resources

- https://roleworlds.ru/ai — Agent-oriented overview of RoleWorlds
- https://roleworlds.ru/ai/worlds — Current public world catalog
- https://roleworlds.ru/ai/worlds/{world_slug} — Public world and chapter list
- https://roleworlds.ru/ai/worlds/{world_slug}/{chapter_slug} — Public chapter information

## Read-only MCP server

- https://roleworlds.ru/mcp — Streamable HTTP MCP endpoint
- https://roleworlds.ru/.well-known/mcp/server-card.json — HTTP discovery server card
- https://roleworlds.ru/server.json — MCP Registry metadata for the public remote server

The server supports MCP 2026-07-28 discovery via `server/discover` and legacy 2025-era `initialize` clients.

Available read-only tools:

- `list_worlds` — list public worlds
- `get_world` — get one public world and its chapters
- `list_chapters` — list public chapters for a world
- `get_chapter` — get one public chapter

MCP resources expose the same public world and chapter data. The MCP server has no write tools and cannot create games, join games, submit turns, or modify sessions or users.

## Read-only JSON API

- https://roleworlds.ru/api/v1 — API discovery and access policy
- https://roleworlds.ru/api/v1/worlds — Public world catalog
- https://roleworlds.ru/api/v1/worlds/{world_slug} — Public world and chapter list
- https://roleworlds.ru/api/v1/worlds/{world_slug}/{chapter_slug} — Public chapter information

Only GET and HEAD are supported by the public agent endpoints. Requests using write methods are rejected with HTTP 405.

## Canonical human-facing resources

- https://roleworlds.ru/ — RoleWorlds
- https://roleworlds.ru/worlds/ — World catalog
- https://roleworlds.ru/worlds/{world_slug}/ — World page
- https://roleworlds.ru/worlds/{world_slug}/{chapter_slug}/ — Chapter page
- https://roleworlds.ru/about — About RoleWorlds

## Data notes

Public session counts are aggregate activity indicators. A non-zero count does not guarantee that a party has a free player slot. Agent clients should not claim that a user can join a particular session unless the canonical human-facing page currently provides that option.