MyiWorlds MCP

Give your AI tools access to the work you chose to save.

Connect Claude, ChatGPT, Codex, or another compatible MCP client. Search and read your content, then grant write or delete access only when you need it.

Connector URL

https://www.myiworlds.com/api/mcp

Authenticate

Work within the scopes

Every request acts as one profile, and each item's existing permissions still apply.

Connect

OAuth

Sign in normally

Use OAuth in Claude.ai, ChatGPT, or Claude Code. Add https://www.myiworlds.com/api/mcp, then approve the MyiWorlds sign-in.

Static token

Pin one profile

Create a token in API token settings, then send it as Authorization: Bearer miw_....

MCP access requires a paid MyiWorlds plan. The endpoint is stateless and accepts POST requests only.

Scopes

search

Find items by title, tags, type, dates, and related content.

read

Read item contents, browse pages, and open item links.

write

Create, update, organize, tag, share, and generate content.

delete

Permanently delete owned items. Static-token opt-in only.

How content works

Every saved item has a numeric ID, a title, a description, an access setting, and type-specific content. Items are private by default. Even on public or shared items, access is checked against the acting profile.

New items are not filed automatically. After createCircle, use addCircleToList to place the item on a home page or inside a Page.

Projects use a separate many-to-many membership model. Create one with type: "Project", then use manageProject to reference existing items. Membership never moves or copies an item, never changes its access, and never comes from addCircleToList.

Tool inputs are flat, but many fields only apply to one content type. Send only the fields documented for the type you are changing. Fields that do not apply to that type are ignored.

Tool reference

The client receives only the tools allowed by its scopes. Tool descriptions and input schemas are also available from tools/list.

searchCircles supports title and description text, tags, public or private access, exact owner, creator, editor, and viewer usernames, created and updated date ranges, liked or rated status, todo status, priority, assignee IDs, due dates, references, templates, locations, and opaque cursor pagination. Pass a returned cursor back unchanged with the same filters and sort.

createCircle can create a saved Search Circle with searchFilters: title, description, tags, content types, public visibility, creator/owner/editor/viewer usernames, sort, limit, and result presentation. The same field configures source pickers on File or circle-mode Connect variables. Combine a creator with a dedicated collection tag to keep a curated library focused. Unknown usernames or types return an error. Filters limit the picker; people still choose which items to connect to their prompt.

updateCircle patches searchFilters on Search and reusable PromptVariable Circles, or inside inline promptVariableChanges. Omitted filter fields stay unchanged; null clears optional filters. Reusable-variable imports copy the search independently, and readCircle reports it for verification.

updateCircle can change emoji, Location details, saved prompt text, variable values, and variable definitions, and todo assignees. Saved-prompt definition edits use explicit promptVariableChanges add, update, and remove operations. Variables not named by an operation are preserved; the final prompt placeholders, names, types, colors, defaults, visibility rules, duplicates, and connected-item access are validated before writing. Creation entries and add operations may use promptVariableCircleId to import a reusable PromptVariable Circle while retaining its source reference; explicit fields override the imported definition and selected default. Its saved prompt-insertion text is added only when the prompt does not already contain the variable placeholder. Add operations also accept the same inline definition fields as creation, including connectMode and defaultCircleId; update operations target the current exact name and change only supplied fields; remove operations delete only the named definition. Importing a PromptVariable Circle copies its definition at that moment — later edits to the source do not propagate to prompts that imported it (re-import or resync explicitly), and deleting the source leaves imported variables working with their source reference cleared. Variable definitions may also carry contextKeyId, mapping the variable to a reusable context field so a Project's Details can supply its value: bind reusable facts once with manageContextScope (written text, or linked Circles whose live content is read at every expansion), then pass that Project's id as scopeCircleId to expandPrompt, even when your client supports native MCP prompts. Native prompt selection expands supplied values and defaults; Project Details and run tracking use this tool. Supplied values beat the scope, the scope beats its explicit parent chain, and the chain beats prompt defaults; scopes are only ever used when passed explicitly. Written values on a public Project are public; linked Circles and inherited Details retain their source access, and inaccessible sources are omitted. Scoped expansions record a run when the connection has write scope; read-only connections validate and expand without writing. Runs contain references and version metadata only, never expanded text. The completePromptRun can settle with outputs and an outcome. manageContextKeys creates Text, Select, Switch, Slider, Connect, and File fields with their existing option, bounds, allowlist, and file-acceptance settings; labels and help text remain editable while the generated custom.<uuid> identity is permanent. Use manageProject for explicit Project membership; the same Circle can belong to several Projects without being copied. Use managePageItems for positioned Page contents, scan-friendly header/card presentation, and responsive row alignment. Narrower items can retain normal automatic packing or occupy their own row aligned left, center, or right at every size or selected xs–xl breakpoints. A Page read reports each exact row ID and its saved position. The same tool also manages responsive 1–2000px section spacers. Spacers work best between distinct groups or before a major visual transition; their optional divider spans the full Page-item width. A Page read reports spacer row IDs so agents can resize, reorder, or remove them exactly. Full child-Page content is a bounded exception when it exposes a short nested list on an otherwise light Page; as items, sub-items, nesting depth, or surrounding content grow, prefer a header or card. Use linkCircles for typed relationships, and setCircleLocations for Location associations. Templates may set creatableTypes to create blank items by type without a source item.

Up to 50 recent accessible saved prompts appear through MCP prompts/list. Calling prompts/get fills Text, Select, Switch, Slider, and Connect variables. Content from connected items is read at the moment the prompt is used, and connected items the profile cannot access are left out.

The “Open in …” buttons on a saved prompt (Codex, ChatGPT, Claude, and Claude Code) create a private, short-lived launch on the server and open the destination with a small instruction as the first message — the link carries only an opaque launch ID, never the prompt, its values, or file URLs. Codex and the Claude apps prefill the instruction and wait for you to press Send; ChatGPT submits it when the tab opens. The agent then calls resolvePromptLaunch over your authenticated connection to retrieve the complete finalized prompt (unsaved variable values included) and readPromptLaunchAsset for each referenced image, PDF, or file. Launches work only for the account that created them, expire after 24 hours, and are snapshots — editing the prompt afterwards does not change an existing launch.

OAuth connections use the saved agent-profile preference, falling back to the account's oldest active profile when none is set. setMcpAgentProfile changes that preference for the next connection. sendChatMessage sends plain text only to an existing people Chat where that profile is already a member. AI Chat posting is not exposed.

readProjectread

Read the Project library, paginated members, status/pins, readiness, revision metadata, personal runs, saved Details, membership lookup, and conversion/publication previews.

createProjectwrite

Create a complete original Project draft with Details, lifecycle, pinning, inheritance and nested content in one database transaction.

getMcpIdentityread

Confirm the profile and scopes used by the connection.

browseDashboardread

Browse the ordered home page and nested Pages.

searchCirclessearch

Search accessible items with bounded results and todo filters.

readCircleread

Read one accessible item as bounded text.

openCircleread

Return the canonical link for one accessible item.

expandPromptread

Expand a saved prompt; an explicit Project scopeCircleId fills mapped variables from its Details and records a run when write access is available.

listContextKeysread

List or search usable context-field definitions, flag likely duplicates, and see which prompts use a field.

readContextScoperead

Read a Project's Details plus inherited values and source provenance; legacy Page scopes remain supported.

resolvePromptLaunchread

Retrieve the full prompt and asset manifest behind an “Open in Codex/ChatGPT/Claude/Claude Code” launch ID. Owner-only, expires after 24 hours.

readPromptLaunchAssetread

Return one launch asset’s bytes as MCP content with its filename and media type; oversized or external assets return a link and a note.

listNotificationsread

List recent notifications for the acting profile by read status.

prepareImageUploadwrite

Create a short-lived upload policy for an image file.

prepareVideoUploadwrite

Create a short-lived upload policy for an MP4 video file.

createCirclewrite

Create supported content, private by default.

copyCirclewrite

Make a private, lineage-linked copy of an accessible non-Project item.

useProjectwrite

Preview or create a real private Project with hybrid copied and connected content, fresh Details, and rollback diagnostics.

generateCircleCoverwrite

Generate and attach a cover to an editable item.

generateImagewrite

Generate a standalone private image item.

createTemplatewrite

Create a reusable template and its fields.

createFromTemplatewrite

Create an item from a saved template.

updateCirclewrite

Update common fields, type-specific content, and patch saved-prompt variable definitions.

addCircleToListwrite

File an item on a home page or inside a Page.

managePageItemswrite

Add, remove, reorder, present, position, resize, or set copy policy for Page items and spacers.

manageProjectwrite

Manage explicit Project members and copy policies, lifecycle and personal pinning; restore reviewed revisions or convert a Page after reviewing its reference impact.

linkCircleswrite

Add or remove a typed relationship between items.

setCircleLocationswrite

Add or remove Location items associated with an item.

sendChatMessagewrite

Send plain text to a people Chat where the profile is a member.

setMcpAgentProfilewrite

Choose the profile used by future OAuth connections.

tagCirclewrite

Add or remove tags on an editable item.

markNotificationsReadwrite

Mark owned notification IDs as read and report unknown IDs.

manageAccesswrite

Change public, editor, and viewer access for an owned item.

manageContextKeyswrite

Create, relabel, share schema-only definitions, unshare, archive, restore, or delete custom context fields.

manageContextScopewrite

Initialize Project Details, set explicit Project inheritance, and bind or unbind field values; legacy Pages remain supported.

completePromptRunwrite

Associate output items with a scoped prompt run and record its outcome.

deleteCircledelete

Permanently delete an owned item after an exact-title check.

Recipes

Save and file a note

createCircle, then addCircleToList

Create a separate derivative

copyCircle so copiedFromId is preserved, then update the copy

Use a canonical Project

useProject previewOnly, then useProject to create the private working Project

Find the right destination

browseDashboard, then choose a Page with canAddItems

Upload a local image

prepareImageUpload, upload the bytes, then createCircle

Upload a local video

prepareVideoUpload, upload the MP4 bytes, then createCircle

Delete safely

readCircle, confirm intent, then deleteCircle with the exact title

Limits and errors

Request bodies are limited to 1 MB.
Authenticated requests are limited to 120 per rolling minute per token or OAuth account. Initialization and tool listing are exempt. A 429 response includes a retry delay.
Most tool failures return { error: "..." } as a normal tool result.
MCP has no MyiWorlds approval card. The client should confirm destructive or hard-to-reverse work first.
Each generated image uses one of your limited daily premium generations.

Ready to connect?

Copy the endpoint, then choose OAuth or a scoped static token.