Skip to content
MCP server

OnlyWorlds

Read and write structured fictional worlds in the OnlyWorlds format

Pricing
Free
Platforms
Web, API
Runs
Remotely
Version
1.0.1
Listing updated
2 days ago

About OnlyWorlds

OnlyWorlds is a free MCP server for books and literature. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://www.onlyworlds.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://www.onlyworlds.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

What it does

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

Pricing

Free

Free API; account optional

Prices change. Check onlyworlds.com before you buy.

OnlyWorlds 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 to OnlyWorlds

  1. List Of Books

    MCP server

    Book series reading orders, author series and book-to-series lookups via MCP and REST

    • 5 tools
    • Remote
    • Freemium
    • Books and literature
  2. Book covers from a title and author: 39 styles, SVG, PNG and print-ready PDF export

    • 4 tools
    • Remote
    • Open source
    • Design and media
  3. Search Shakespeare monologues by character, play or style, with plain-English paraphrases

    • 10 tools
    • Remote
    • Open source
    • Books and literature
  4. Hero of You

    MCP server

    Find a personalized illustrated children's book by age, interests and occasion

    • 2 tools
    • Remote
    • Free
    • Books and literature
  5. INKFLOW Studio

    MCP server

    Generate whole books, series and company manuals with AI, checked for continuity

    • 10 tools
    • Remote
    • Freemium
    • Books and literature