Fast.io

Fastio AI chat (read): chats and their details, messages, a message's answer with citations, AI credit transactions. Workspace or share context. Writes are on ai_manage. action='describe' gives the full action/param reference.

Fastio AI chat (write): ask a question about workspace or share files and get a cited answer, a workspace status summary, create/update/publish/cancel chats, send messages, generate an AI share. Destructive: chat-delete. ask, status, chat-create and message-send consume AI credits. Reads are on ai. action='describe' gives the full action/param reference.

Brand assets (logos, banners, profile photos) on an org, workspace, share, or user: asset types, list, read an asset's bytes. Writes are on asset_manage.

Brand assets (logos, banners, profile photos) on an org, workspace, share, or user: upload, delete. Destructive: delete. Reads are on asset.

Fastio session and credential state (read): sign-in check, session and scope details, email availability, 2FA status, API keys, OAuth sessions. Sign-in, sign-up, 2FA changes, PKCE login and credential changes are on auth_manage.

Fastio sign-in and credentials (write): PKCE browser sign-in, signup, signout, set an API key, email verification, password reset, 2FA enrolment, API key create/update/delete, OAuth session update/revoke. Password signin and 2fa-verify are refused. Destructive: api-key-delete, oauth-revoke, oauth-revoke-all. Reads are on auth.

Fastio comments on files (read): list a file's comments, all comments in a workspace or share (filter by status, assigned to you, suggestions), comment details, a comment's attachments, suggested edits on a note. Writes are on comment_manage. action='describe' gives the full action/param reference.

Fastio comments on files (write): add (with an optional anchor or attachments), edit, delete, bulk-delete, emoji reactions, attach/detach objects, resolve/reopen/assign threads, suggested edits. Destructive: delete, bulk-delete and some suggestion actions (see describe). Reads are on comment. action='describe' gives the full action/param reference.

Download URLs for files (file-url) and folder ZIPs (zip-url), and details of existing QuickShare links (quickshare-details, deprecated; new links are created on fileshare_manage). Consumes bandwidth credits. action='describe' gives the full action/param reference.

Fastio event log and activity (read): search audit events, event details, list and long-poll workspace/share activity, the per-member workspace Dashboard feed (dashboard-list), and the org-wide storage change feed (changes: one cursor for every workspace and share in an org). Writes and the billed AI summary are on event_manage. action='describe' gives the full action/param reference.

Fastio events (write): AI-summarize audit events (summarize: an LLM call billed to the org's AI credits), acknowledge an event (marks it read for the caller; idempotent), and dismiss/snooze or undismiss a Dashboard card in the caller's own feed (a view change; the underlying item is unchanged). Reads are on event. action='describe' gives the full action/param reference.

Fastio File Shares (read): list and details, grants, version history, and direct download/preview/version URLs for durable single-file share links. Writes are on fileshare_manage. action='describe' gives the full action/param reference. Recipient 404 is uniform (not-found, revoked and expired look alike). The URL actions return a direct API URL; gated shares need Authorization and/or x-ve-password headers on the GET.

Fastio File Shares (write): create a durable share link bound to one workspace file (immutable binding), update, delete, and add/revoke per-user grants (grant-by-email creates a pending invite for an unregistered address). Destructive: delete (removes the share, not the file), grant-revoke. Reads are on fileshare. action='describe' gives the full action/param reference.

Unified search across a workspace or share — ONE query, results GROUPED BY TYPE into buckets (files, metadata [workspace only], comments), each independently paginated and health-reported. action='describe' gives the full action/param reference. storage action=search is the files-only search, with a smaller default page, files_scope/metadata_filters and the depth surface; find adds metadata-only hits and comments in the same call; metadata action=search covers lexical metadata fields alone.

Built-in product help — a natural-language "how do I…" question about Fastio returns a grounded, product-aware answer (or a short clarifying question) in one call. EXPLAIN-ONLY / ADVISORY: it returns GUIDANCE TEXT and performs NO platform action (it will not create shares, move files, or change anything); the actions themselves are on the other tools. Answers are grounded in Fastio's own how-to knowledge AND phrased in terms of these MCP tools — they name the concrete <tool> action="…" calls, in place of guessed endpoints or exploratory calls. Q&A over the user's uploaded files (RAG) is the ai_manage tool; how-to answers questions about Fastio ITSELF. Costs no credits; needs only an authenticated user (no org needed). action='describe' gives the full action/param reference.

Agent Intents (read): workspace-scoped declarations of what agents are working on. browse lists every live intent (topics only); expand returns full records. Writes are on intent_manage.

Agent Intents (write): allocate a slot (content-free; get-or-create — it can return an existing slot), fill it with a topic/message (fill is also the heartbeat), release it. Destructive: release. Reads are on intent.

Fastio workspace and share invitations (read): list invitations, filter by state. Writes are on invitation_manage.

Fastio workspace and share invitations (write): update an invitation, revoke one. Destructive: delete. Reads are on invitation.

Fastio workspace and share members (read): list (active and pending), details. Writes are on member_manage.

Fastio workspace and share members (write): add, remove, update, transfer ownership, join, leave, answer an invitation. Destructive: remove, transfer-ownership, leave. Reads are on member.

Fastio workspace metadata (read): the field VOCABULARY (fields-list), lexical value search (search), metadata+content matching (compound-search), extraction eligibility (eligible), merge proposals (fields-merge-candidates), saved filters (filters-list, filter-details, filter-nodes). Templates and saved views were removed; extraction is on storage_manage. Writes are on metadata_manage. action='describe' gives the full reference.

Fastio workspace metadata (write): fold one field name into another, workspace-wide; create, replace or delete saved filters. Destructive: fields-merge (irreversible; unconfirmed it is a preview), filter-delete. Reads are on metadata. action='describe' gives the full reference.

Fastio organizations (read): list, details, limits, workspaces, shares, billing, members, invitations, discovery, assets. Writes are on org_manage.

Fastio organizations (write): create, update, workspaces, billing, members, invitations, assets. Destructive: close (org and all data), billing-cancel, remove-member, leave, transfer-ownership, invitation-delete, asset-delete. Reads are on org.

Fastio shares (read): list and details, public details, members, available shares, name availability, password auth for a protected share. Writes are on share_manage. action='describe' gives the full action/param reference.

Fastio shares (write): create, update, archive/unarchive, delete, autotitle (AI-generates and applies a title/description; consumes credits). quickshare-create is deprecated (error 10756); single-file links are fileshare_manage action create. Destructive: delete (permanent). Reads are on share. action='describe' gives the full action/param reference. Enabling Deep Indexing costs credits (10 per page).

Fastio e-signature reads: sign envelopes and sign templates in a workspace, plus document and audit-certificate download URLs. Writes are on sign_manage.

Fastio e-signature writes: draft envelopes, send (reserves signing credits), void, retry, the caller's signing link, and sign templates. Destructive: sign-send, sign-void, sign-template-delete (confirm='true'). Reads are on sign.

Fastio files and folders in workspaces and shares (read): list, recent, search, details, trash, versions, locks, previews, content reads, and per-node metadata. FILES OFTEN ALREADY CARRY AI-EXTRACTED METADATA, AND IT IS SEARCHABLE: it frequently answers the question without opening anything, and finds files by value without listing folders. Writes are on storage_manage. action='describe' gives the full reference.

Fastio files and folders (write): create folders, copy, move, rename, restore, add files/links, transfer, versions, locks, node metadata set/extract. Destructive: delete (to trash), purge (permanent), metadata-delete. Reads are on storage. action='describe' gives the full reference.

Fastio uploads (read): upload session status (wait long-polls), active sessions, chunk status, web-import jobs, upload limits, allowed extensions, and the POST /blob sidecar details (blob-info). Writes are on upload_manage. action='describe' gives the full action/param reference.

Fastio uploads (write): stream-upload (one call, auto-finalizes, no filesize), chunked sessions (create-session, chunk, finalize), web URL import, batch (many small files), cancellation. For files and binary the default byte source is the POST /blob sidecar: raw bytes over plain HTTP outside MCP (up to 100 MB, no base64), returning a blob_id for stream-upload/chunk/batch. The chunked path is for files over 100 MB. content is UTF-8 text composed in the call; content_base64 inflates ~33% and fails above a few MB. Uploads create files and consume storage credits; a same-name upload overwrites in place as a new version. Destructive: cancel, cancel-all, chunk-delete, web-cancel. Reads are on upload. action='describe' gives the full action/param reference.

Fastio user account (read): profile, contacts, limits, shares, invitations, assets. Writes are on user_manage.

Fastio user account (write): profile, invitations, assets, report-bug. Destructive: close, asset-delete, invitation-decline. Reads are on user.

Fastio workspaces (read): list and details, members, shares in a workspace, available workspaces, name availability, notes, note export status, QuickShare links, async job status. Writes are on workspace_manage. action='describe' gives the full action/param reference. Metadata is not here: the workspace field vocabulary is on metadata, node-level metadata on storage. Verbosity (detail param): list/available/members/list-shares default to terse; details defaults to full.

Fastio workspaces (write): update settings, archive/unarchive, delete, import a share, create/update/export notes, delete QuickShare links, enable/disable cloud import. Destructive: delete (the workspace and all its files), quickshare-delete. Reads are on workspace. action='describe' gives the full action/param reference. Enabling Deep Indexing costs credits (10 per page); the toggle is rate-limited.