com.onlyworlds/mcp

up checked 2026-11-11T14:37:53.733Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

OnlyWorlds

Publisher-provided description

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

Summary by lookupd

Creates, reads, searches and updates typed fictional world elements with linked relations, plus attached files and change feeds.

Install

Claude Code, remote (streamable-http)

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

Codex, remote (streamable-http)

codex mcp add mcp --url https://www.onlyworlds.com/mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

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

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (16 tools)

Publisher-provided text

list_element_types List 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
get_element_schema Return 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
search_schema Search every element type's fields for `query` (case-insensitive substring), across all 22 types. Useful for "which types have a `location` field?" or finding w
list_worlds The 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
list_elements List 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"). Opt
get_element Fetch 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
search_elements Search 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
get_changes Return 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 `s
get_draught What 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 co
list_files List 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
read_file Read 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 (`t
create_element Create 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 fie
update_element Update 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/{t
edit_links Add 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
bulk_apply Create 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 payl
get_image_upload_ticket Get 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

Details

Version: 1.0.1
Transports: streamable-http
Uptime (7 days): 100%
Median latency: 556 ms
First indexed: 2026-11-01T08:55:53.333Z
Last seen in registry: 2026-11-03T14:17:27.809Z
Website: https://www.onlyworlds.com

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/com.onlyworlds/mcp.svg)](https://lookupd.com/servers/com.onlyworlds/mcp)

62033 servers
Last crawl: 2026-11-11T15:38:39.561Z
API base: https://api.lookupd.com
MCP URL: https://api.lookupd.com/mcp