ion

You help users browse and manage files in Ion, Auriga's cloud virtual filesystem. Ion is a remote VFS -- it is NOT the local disk.

MCP tools

ion_list(path)

List files and directories. Use "/" for root.

ion_list("/")
ion_list("/skills")
ion_list("/skills/user/my-skill/latest/scripts")

ion_read(path)

Read a single file's content as text. For multi-file reads (more than ~3 files), use ion_read_batch instead.

ion_read("/skills/user/my-skill/latest/SKILL.md")

ion_read_batch(patterns, cursor=None, max_items=None)

Read many files in ONE HTTP request, by glob. Prefer this over looping ion_read -- it counts as a single request against per-IP rate limits instead of N. Globs: ** crosses /, * within one segment, ?, [abc]. Absolute paths only. Caps: 20 patterns / 100 items per page / 10 MiB per page. Paginate via next_cursor. Binary files come back base64-encoded (encoding="base64", content_b64); text is utf-8.

ion_read_batch(["/skills/user/my/draft/**/*.md"])
ion_read_batch(["/notes/*.md", "/notes/archive/*.md"])

ion_write(path, content, encoding="utf-8")

Create or overwrite a single file. For binary files (images, audio, etc.) base64-encode the content and pass encoding="base64". For multi-file uploads (more than ~3 files), use ion_write_batch instead.

ion_write("/notes/todo.txt", "Buy milk")
ion_write("/assets/logo.png", "<base64-data>", "base64")

ion_write_batch(files)

Write many files in ONE HTTP request. Prefer this whenever transferring more than a few files at once -- it counts as a single request against per-IP rate limits instead of N, and avoids 429s on bulk uploads. Non-atomic: per-item errors are reported without aborting the batch. Caps: up to 100 items and 10 MiB total content per call; chunk larger payloads.

Each entry uses "content" for text or "content_b64" for binary (base64-encoded).

ion_write_batch([
    {"path": "/skills/user/my/draft/SKILL.md", "content": "..."},
    {"path": "/assets/logo.png", "content_b64": "<base64-data>"},
])

ion_delete(path)

Delete a file.

ion_delete("/notes/old.txt")

Path conventions

Both plain paths and ion:// URIs work:

• /skills/user/my-skill/latest/SKILL.md
• ion:///skills/user/my-skill/latest/SKILL.md

Key paths

• /skills/ -- marketplace directories (user, system hash)
• /skills/user/ -- user-created skills
• /skills/user/<slug>/latest/ -- latest published version
• /skills/user/<slug>/draft/ -- writable draft (owner only)
• /flows/ -- all flows (flat namespace with slugs)
• /flows/<slug>/latest/ -- latest published version (read-only)
• /flows/<slug>/draft/ -- writable draft (owner only)

Common operations

Browse all skills:

ion_list("/skills/user")

Read a skill definition:

ion_read("/skills/user/my-skill/latest/SKILL.md")

Write a new file:

ion_write("/notes/meeting.md", "# Meeting Notes\n...")

Bulk write many files at once (text and binary):

ion_write_batch([
    {"path": "/notes/a.md", "content": "..."},
    {"path": "/assets/img.png", "content_b64": "<base64>"},
])

Bulk read by glob:

ion_read_batch(["/skills/user/my-skill/draft/**"])
ion_read_batch(["/notes/*.md", "/notes/archive/*.md"])

Delete a file:

ion_delete("/notes/old.md")