Agents Index

OnlyWorlds

Online

Read and write typed fictional worlds (22 linked element types) via the OnlyWorlds open standard.

Visit publisherConnectJSON

What it can do: 16 tools

  • list_element_types read-onlyList all 22 OnlyWorlds element types with a one-line shape summary of each. Every world is built from these types; each element has a stable UUID `id`, a `name`, and a `type`. Use `get_element_schema(type)` for a type's
  • get_element_schema read-onlyReturn the field structure of one OnlyWorlds element `type` (a slug from `list_element_types`, e.g. "character"). The result groups the type's writable fields by kind so a caller knows how to read and write them: `text`
  • search_schema read-onlySearch every element type's fields for `query` (case-insensitive substring), across all 22 types. Useful for "which types have a `location` field?" or finding where a concept lives in the schema. Returns a mapping of ty
  • list_worlds read-onlyThe worlds you can read here. With an API-Key: the key's one world. Signed in through a hosted client (a bearer), where this server offers one: every world your account owns or is a member of, as your account's world lis
  • list_elements read-onlyList elements of one `type` in the world named by your API-Key header, newest-created first. `type` is a slug from `list_element_types` (e.g. "character"). Optional `name_contains` filters by case-insensitive name subst
  • get_element read-onlyFetch one element by `type` and `id` (a UUID) from the world named by your API-Key header. `type` is a slug from `list_element_types`. Returns the full v2 wire shape (the same body as `GET /api/v2/{type}/{id}`): `type`,
  • search_elements read-onlySearch the world named by your API-Key header for elements whose name or text fields (description and each type's prose fields, such as a Character's background) hold every word of `query` as a whole word, ignoring case:
  • get_changes read-onlyReturn the delta feed for the world named by your API-Key header: every element created/updated (`op: "upsert"`, full body) or deleted (`op: "delete"`) since `since_cursor`, in apply order, in pages of `limit` (default 2
  • get_draught read-onlyWhat one Character knows, in one read: the draught. `id` is the Character's UUID; `policy` is one JSON object, every key optional: `components` (a list, or a comma string, of self, role, work, style, events, knowledge, n
  • list_files read-onlyList the files attached to one element (`type` and `id`, a UUID) in the world named by your API-Key header: PDFs, text files, images (png, jpg, webp, avif) and world bundles kept on onlyworlds.com beside the element, nev
  • read_file read-onlyRead one file attached to an element, by its id (from `list_files`). A text file (txt, md, json, csv, yaml, toml) answers its words, at most 64 KB per call (`truncated: true` past that), in `text`, which always begins w
  • create_elementCreate one new element of `type` in the world named by your API-Key header. `type` is a slug from `list_element_types` (e.g. "character"). `element` is the field payload: `name` plus any scalar, link, or extension field
  • update_elementUpdate an existing element by `type` and `id`, changing ONLY the fields you pass; omitted fields are kept. This is the same partial update as `PATCH /api/v2/{type}/{id}`: each field you pass replaces that field's value
  • edit_linksAdd and/or remove links on ONE multi-link `field` of an element, leaving the rest of that field's array untouched. Use this for additive/subtractive link edits (unlike `update_element`, which REPLACES a link array). `ty
  • bulk_applyCreate and/or update many elements across any of the 22 types in one call. Each entry in `items` is `{"type": <slug>, "element": <payload>}` with the same payload shape `create_element` takes: an `element` with an `id`
  • get_image_upload_ticketGet a ticket to upload ONE image into this world, for an element's `image_url` (Keel #59). The image never passes through this tool: you send its bytes yourself, straight to the image host, with the ticket. Steps: 1. Ca

Connect it

Claude Code
claude mcp add --transport http onlyworlds https://www.onlyworlds.com/mcp
Claude.ai / ChatGPT
Settings → Connectors → Add custom connector
URL: https://www.onlyworlds.com/mcp
Cursor (~/.cursor/mcp.json)
{
  "mcpServers": {
    "onlyworlds": {
      "url": "https://www.onlyworlds.com/mcp"
    }
  }
}
VS Code (.vscode/mcp.json)
{
  "servers": {
    "onlyworlds": {
      "type": "http",
      "url": "https://www.onlyworlds.com/mcp"
    }
  }
}

Questions

What does OnlyWorlds do?

Read and write typed fictional worlds (22 linked element types) via the OnlyWorlds open standard. It exposes 16 tools to AI assistants.

What tools does OnlyWorlds provide?

16 tools, including list_element_types, get_element_schema, search_schema, list_worlds, list_elements, get_element, search_elements, get_changes, get_draught, list_files, read_file, create_element….

How do I connect OnlyWorlds to Claude, ChatGPT or Cursor?

Add the remote MCP endpoint https://www.onlyworlds.com/mcp as a custom connector or MCP server. Copy-paste setup is on this page.

Does OnlyWorlds require an account or API key?

No sign-in was needed to list its tools. Individual tools may still need an account or API key.

Is OnlyWorlds online?

As of 2026-11-19 our probe found it online. It answered 100% of our last 3 checks.

Who publishes OnlyWorlds?

onlyworlds.com. The official MCP Registry verified that the publisher controls this domain before accepting the listing.

Similar in Productivity & Docs