# OnlyWorlds

> OnlyWorlds is a free MCP server for books and literature. Read and write structured fictional worlds in the OnlyWorlds format. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API
- **Website:** https://www.onlyworlds.com
- **MCP Registry name:** com.onlyworlds/mcp
- **Categories:** books and literature
- **Listing updated:** 2026-11-15

## About

OnlyWorlds is an open standard for worldbuilding data. A world is made of elements in 22 categories, such as Character and Location, and elements point to each other by id, so a character can link to a birthplace, an institution, a family and rivals. Every field except name and category is optional, and you can add your own.

This remote server lets an assistant answer from a world rather than from memory, and with a write key it can write back. The same world can be opened in Atlas (the workspace app), an Obsidian plugin, TypeScript, Python and Unity packages, or the REST API.

The site offers a demo key, 0000000001, to try the server without an account. The standard itself is open source and changes go through a community Council process.

## Features

- **22 element types:** Typed categories such as Character and Location with optional fields.
- **Linked elements:** Elements reference each other by id across the world.
- **Read and write:** Assistants can read a world and write back with a key.
- **Demo key:** A public demo key lets you try the server without signing up.
- **Open standard:** The format is open and works across tools and SDKs.

## Good for

- Ask questions about a fictional world and get answers grounded in it
- Have an assistant draft new characters linked to existing places
- Keep one world usable across editor, notes and game engine
- Check lore consistency across linked elements

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://www.onlyworlds.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://www.onlyworlds.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://www.onlyworlds.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://www.onlyworlds.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://www.onlyworlds.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://www.onlyworlds.com/mcp"
    }
  }
}
```

## FAQ

### Do I need an account to try it?

No. The site lists a demo key, 0000000001, for trying the server.

### How many element types are there?

The standard has 22 categories.

### Is the server required?

No. The site says the server is free and optional; worlds can be kept as a folder you own.

### Is OnlyWorlds free?

Yes. OnlyWorlds is free to use.

### How do I add OnlyWorlds to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://www.onlyworlds.com/mcp

### What are the best alternatives to OnlyWorlds?

The closest alternatives to OnlyWorlds are 一孔录《论语》 Yikonglu Analects, List Of Books, Book Cover Generator, Shakespeare's Monologues and Hero of You.

## Alternatives

- [一孔录《论语》 Yikonglu Analects](https://ai-powered.com/mcp/yikonglu-analects): 一孔录《论语》 Yikonglu Analects is a free MCP server for books and literature.
- [List Of Books](https://ai-powered.com/mcp/list-of-books): List Of Books is a freemium MCP server for books and literature.
- [Book Cover Generator](https://ai-powered.com/mcp/book-cover-generator): Book Cover Generator is an open-source MCP server for design and media.
- [Shakespeare's Monologues](https://ai-powered.com/mcp/shakespeare-s-monologues): Shakespeare's Monologues is an open-source MCP server for books and literature.
- [Hero of You](https://ai-powered.com/mcp/hero-of-you): Hero of You is a free MCP server for books and literature.
- [INKFLOW Studio](https://ai-powered.com/mcp/inkflow-studio): INKFLOW Studio is a freemium MCP server for books and literature.
- [Biblical Atlas](https://ai-powered.com/mcp/biblical-atlas): Biblical Atlas is an open-source MCP server for religion.
- [RuShiWoWen Buddhist Scripture Tools](https://ai-powered.com/mcp/rushiwowen-buddhist-scripture-tools): RuShiWoWen Buddhist Scripture Tools is a free MCP server for religion.

---
Source: https://ai-powered.com/mcp/onlyworlds
