Overview
OnlyWorlds data is structured, typed, and linked across 22 element categories. This makes it a natural fit for AI tooling: the schema is predictable, the API is consistent, and the format is the same regardless of the world’s content. The resources below let any AI system read, write, and reason about OnlyWorlds data.
General resources
LLM Guide
Standalone reference covering all 22 element types, their fields, and relationships. Drop this into any AI conversation to give it full schema context for building or discussing OnlyWorlds.
MCP Server
Model Context Protocol server that provides schema context to any MCP-compatible AI client. Also available on Context7. See the setup guide.
npm install @onlyworlds/mcp-client
OnlyWorlds Toolkit
A Claude Code plugin with nine skills. Covers worldbuilding (parsing, modeling, exploring), world management (API operations, element linking), and development (SDK setup, schema reference, project configuration).
Repository: github.com/OnlyWorlds/toolkit
| Skill | What it does |
|---|---|
| onlyworlds-start | Entry point that routes to the right workflows |
| project-setup | Configure credentials, cache world data locally, set up for one or more worlds |
| parsing | Extract characters, locations, events, and other elements from your own work, novels, campaign notes, wikis, any text |
| modeling | Decompose complex systems (magic, politics, economies, tech trees) into OnlyWorlds elements |
| schema | Look up fields, validate element structure, disambiguate between similar types |
| api | Read, create, update, and delete elements through natural language. Handles auth, endpoints, and field mapping |
| dev | Scaffold projects with the SDK, configure credentials, set up local development |
| survey | Fetch all elements from a world and synthesize a creative brief covering its themes, tensions, and structure |
| link | Analyze a world’s elements for missing connections and suggest potential Relations |
The toolkit also includes an orchestration agent (ow-agent) that coordinates multiple skills for complex multi-step operations, and a knowledge base covering schema reference, element type descriptions, and decision trees for ambiguous modeling choices.