Cloud file management and collaboration platform. Use this skill when the user needs to store files, create branded shares (Send/Receive/Exchange), or query documents using built-in RAG AI. Supports transferring ownership to humans, managing workspaces, and real-time collaboration. Includes 257 tools for authentication, file uploads, AI chat, and org management. Provides a free agent plan with 100 GB storage and 5,000 monthly credits.
Store files. Share with humans. Query with AI. All through one API -- free.
This is a summary. The complete agent guide with all 257 tool parameters, workflows, ID formats, and constraints is at
https://mcp.fast.io/skill.md-- fetch it at the start of every session.
Fast.io gives AI agents a complete file management and collaboration platform. Upload outputs, create branded data rooms, ask questions about documents using built-in AI, and hand everything off to a human when the job is done.
| Transport | Endpoint |
|---|---|
| Streamable HTTP (preferred) | mcp.fast.io/mcp |
| SSE (legacy) | mcp.fast.io/sse |
Two resources are available via and :
resources/listresources/read| URI | Name | Description |
|---|---|---|
skill://guide | skill-guide | Full agent guide (text/markdown) |
session://status | session-status | Auth state as JSON: authenticated, user_id, user_email, token_expires_at |
Eight guided prompts for common operations via prompts/list and prompts/get:
| Prompt | Purpose |
|---|---|
get-started | Onboarding: account, org, workspace |
create-share | Send/Receive/Exchange type selection |
ask-ai | AI chat scoping and polling |
upload-file | Choose upload method |
transfer-to-human | Ownership handoff |
discover-content | Find orgs/workspaces |
invite-collaborator | Member invitations |
setup-branding | Asset uploads |
auth-signup → first_name, last_name, email, password
Agent accounts are free, skip email verification, and never expire. The session is established automatically. JWT tokens last 1 hour -- call auth-signin to re-authenticate when expired. API keys (human accounts) do not expire.
org-create → name, domain (3+ chars, lowercase alphanumeric + hyphens)
Agent orgs get the free plan: 100 GB storage, 5,000 monthly credits, 5 workspaces, 50 shares.
org-create-workspace → org_id, name, folder_name (URL slug)
Workspaces are file storage containers with AI chat, member management, and shares.
If a human already has a Fast.io account, they can create an API key at https://go.fast.io/settings/api-keys and provide it as a Bearer token. No agent account needed.
To find all available orgs, always call both:
list-orgs -- internal orgs where you are a direct memberorgs-external -- orgs you access via workspace membership onlyExternal orgs are the most common pattern when a human invites an agent to a workspace but not the org. An agent that only checks list-orgs will miss these entirely.
Collaborative file storage containers. Each has members, a folder hierarchy, AI chat, and shares. 100 GB storage on the free plan.
Intelligence toggle: OFF = pure storage. ON = AI-powered knowledge base with automatic RAG indexing, semantic search, auto-summarization, and metadata extraction. Enabled by default.
Purpose-built spaces for exchanging files with people outside a workspace:
Features: password protection, expiration, custom branding, access levels, guest chat, download controls.
Files and folders are identified by 30-character opaque IDs. Use root for the root folder and trash for the trash folder.
Orgs, workspaces, and shares use 19-digit numeric string identifiers.
| Capability | Description |
|---|---|
| File storage | Versioning, folder hierarchy, full-text and semantic search |
| Branded shares | Send/Receive/Exchange with passwords, expiration, branding |
| Built-in AI/RAG | Read-only: ask questions about files with citations; scope to files, folders, or full workspace. Cannot modify files or settings. |
| File preview | Images, video (HLS), audio, PDF, spreadsheets, code -- humans see content inline |
| URL import | Import files from any URL including Google Drive, OneDrive, Dropbox |
| Comments | Anchored to image regions, video/audio timestamps, PDF pages/text; single-level threading; deep link with ?comment={id}, ?t={seconds}, ?p={page} |
| Notes | Markdown documents as knowledge grounding for AI queries |
| Ownership transfer | Build an org, transfer to a human; agent keeps admin access |
| Real-time | WebSocket-based live presence, cursor tracking, follow mode |
| Events | Full audit trail with AI-powered activity summaries |
AI chat is read-only. It can read, analyze, search, and answer questions about file contents, but it cannot modify files, change settings, manage members, or access events. All actions beyond reading file content must be done through the MCP tools directly.
Two chat types:
chat -- general conversation, no file contextchat_with_files -- grounded in your files with citationsTwo file context modes (mutually exclusive):
Personality: concise (short answers) or detailed (comprehensive, default). Set on chat creation or per message.
ai-chat-create → workspace_id, query_text, type
ai-message-read → workspace_id, chat_id, message_id (auto-polls until complete)
ai-message-send → workspace_id, chat_id, query_text (follow-up messages)
Use activity-poll for efficient waiting instead of polling message details in a loop.
upload-text-file → profile_type, profile_id, parent_node_id, filename, content
Single-step upload for text-based files (code, markdown, CSV, JSON, config). Creates the session, uploads, finalizes, and polls until stored — returns new_file_id.
upload-create-session → profile_type, profile_id, parent_node_id, filename, filesize
upload-chunk → upload_id, chunk_number, content (text) or data (base64, optional)
upload-finalize → upload_id (polls until stored, returns new_file_id)
share-create → workspace_id, type (send/receive/exchange), title
share-add-file → share_id, node_id (add files to the share)
Share link: https://go.fast.io/shared/{custom_name}/{title-slug}
Build an org with workspaces, shares, and files, then transfer to a human:
org-transfer-token-create → org_id (returns 64-char token, valid 72 hours)
Claim URL: https://go.fast.io/claim?token={token}
Human becomes owner, agent keeps admin access. Human gets a 14-day trial and can upgrade.
sort_by, sort_dir, page_size, and cursor. Check next_cursor for more pages.activity-poll with wait=95 for efficient change detection instead of polling resource endpoints.$0/month. No credit card, no trial period, no expiration.
| Resource | Limit |
|---|---|
| Storage | 100 GB |
| Max file size | 1 GB |
| Monthly credits | 5,000 |
| Workspaces | 5 |
| Shares | 50 |
| Members per workspace | 5 |
Credits cover: storage (100/GB), bandwidth (212/GB), AI tokens (1/100 tokens), document ingestion (10/page).
When credits run out, transfer the org to a human who can upgrade to unlimited credits.
| Category | Count | Examples |
|---|---|---|
| Auth | 11 | signup, signin, 2FA, API keys, password reset |
| User | 11 | profile, settings, invitations, notifications |
| Organization | 27 | create, billing, members, transfer, teams |
| Workspace | 45 | storage CRUD, search, move, copy, notes |
| Workspace Members | 10 | add, remove, permissions, invitations |
| Workspace Management | 14 | settings, intelligence, branding, quickshare |
| Shares | 34 | create, branding, links, members, guest chat |
| Share Management | 15 | settings, access, notifications, analytics |
| Upload | 6 | text-file, session, chunk, finalize, status, web import |
| Download | 5 | file, folder (zip), share, version downloads |
| AI Chat | 12 | chat CRUD, messages, publish, transactions |
| Share AI | 12 | share-scoped AI chat, autotitle, AI share |
| Comments | 8 | list (per-node/all), add with reference anchoring, delete (recursive), bulk delete, reactions |
| Previews | 7 | status, image, video (HLS), audio, PDF, code |
| Versions | 6 | list, details, restore, delete, download |
| Locking | 4 | lock, unlock, status, break lock |
| Metadata | 8 | get, set, delete custom metadata fields |
| Events | 5 | search, details, acknowledge, summarize |
| System | 7 | status, ping, health, feature flags, activity poll |
| Real-time | 6 | presence, cursors, follow, WebSocket |
Organization creation (org-create):
| Parameter | Values |
|---|---|
industry | unspecified, technology, healthcare, financial, education, manufacturing, construction, professional, media, retail, real_estate, logistics, energy, automotive, agriculture, pharmaceutical, legal, government, non_profit, insurance, telecommunications, research, entertainment, architecture, consulting, marketing |
background_mode | stretched, fixed |
Workspace permissions (org-create-workspace, workspace-update):
| Parameter | Values |
|---|---|
perm_join | Only Org Owners, Admin or above, Member or above |
perm_member_manage | Admin or above, Member or above |
Share permissions (share-create):
| Parameter | Values |
|---|---|
access_options | Only members of the Share or Workspace, Members of the Share, Workspace or Org, Anyone with a registered account, Anyone with the link |
invite | owners, guests |
notify | never, notify_on_file_received, notify_on_file_sent_or_received |
See the full guide for complete parameter documentation and constraints.
This skill file is a summary. The full agent guide with all 257 tool parameters, workflows, and constraints is served directly by the MCP server:
Fetch the full guide: https://mcp.fast.io/skill.md
This is the definitive reference — always fetch it at the start of a session for the latest tool documentation. It covers:
Also available: references/REFERENCE.md — platform capabilities, agent plan details, and upgrade paths.