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.

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.

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. Add operations accept the same 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. Use managePageItems for positioned Page contents, scan-friendly header/card presentation, and 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.

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.

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 for clients without MCP prompt support.

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 item.

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, or resize Page items and spacers.

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.

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

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.