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 266 tools for authentication, file uploads, AI chat, and org management. Provides a free agent plan with 100 GB storage and 5,000 monthly credits.
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 266 tools for authentication, file uploads, AI chat, and org management. Provides a free agent plan with 100 GB storage and 5,000 monthly credits.
license
Proprietary
compatibility
Requires network access. Connects to the Fast.io MCP server at mcp.fast.io via Streamable HTTP (/mcp) or SSE (/sse).
metadata
{"author":"fast-io","version":"1.29.0"}
homepage
https://fast.io
Fast.io MCP Server
Store files. Share with humans. Query with AI. All through one API -- free.
This is a summary. The complete agent guide with all 266 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.
Connecting to the Server
Transport
Endpoint
Streamable HTTP (preferred)
mcp.fast.io/mcp
SSE (legacy)
mcp.fast.io/sse
MCP Resources
Two resources are available via resources/list and resources/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
MCP Prompts
Eight guided prompts for common operations via prompts/list and prompts/get:
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.
Workspaces are file storage containers with AI chat, member management, and shares.
Alternative: Assist an Existing Human
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.
Org Discovery (Important)
To find all available orgs, always call both:
list-orgs -- internal orgs where you are a direct member
orgs-external -- orgs you access via workspace membership only
External 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.
Key Concepts
Workspaces
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.
Shares
Purpose-built spaces for exchanging files with people outside a workspace:
Send -- deliver files to humans (reports, exports, generated content)
Receive -- collect files from humans (documents, datasets, submissions)
Files and folders are identified by 30-character opaque IDs. Use root for the root folder and trash for the trash folder.
Profile IDs
Orgs, workspaces, and shares use 19-digit numeric string identifiers.
Core Capabilities
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
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 context
chat_with_files -- grounded in your files with citations
Two file context modes (mutually exclusive):
Folder/file scope (RAG) -- searches indexed content; requires intelligence ON
File attachments -- reads files directly; up to 10 files; no intelligence needed
Personality:concise (short answers) or detailed (comprehensive, default). Set on chat creation or per message.
AI Chat Workflow
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.
Three options for chunk data (provide exactly one):
content — text (strings, code, JSON). Do not put text in data.
blob_ref — preferred for binary. POST raw bytes to /blob with Mcp-Session-Id header and Content-Type: application/octet-stream. Returns { blob_id, size }. Pass blob_id as blob_ref. Avoids base64 overhead. Blobs expire after 5 minutes, consumed on use.
data — legacy base64-encoded binary. Still supported but adds ~33% size overhead.
Shares Workflow
share-create → workspace_id, type (send/receive/exchange), title
share-add-file → share_id, node_id (add files to the share)
Human becomes owner, agent keeps admin access. Human gets a 14-day trial and can upgrade.
Common Patterns
Downloads: Tools return download URLs; they never stream binary.
Pagination: Storage list endpoints use cursor-based pagination (sort_by, sort_dir, page_size, cursor; check next_cursor). All other list endpoints support limit/offset pagination (limit 1-500, default 100; offset default 0).
Trash/delete/purge: Delete moves to trash (recoverable). Purge permanently destroys (confirm with user first).
Activity polling: Use activity-poll with wait=95 for efficient change detection instead of polling resource endpoints.
Agent Plan (Free)
$0/month. No credit card, no trial period, no expiration.
