Fastio
Fastio MCP Skill Package
Workspaces for agentic teams — where agents collaborate with other agents and with humans. Upload outputs, create branded shares, query documents with built-in AI, coordinate with peer agents, and hand everything off to a human when the job is done.
What is Fastio?
Fastio gives AI agents a complete file management and collaboration platform through the Model Context Protocol (MCP). No infrastructure to manage, no SDKs to wire up — connect, authenticate, and call tools.
| Problem | Solution |
|---|---|
| Nowhere professional to put agent outputs | Branded workspaces with inline preview for 10+ formats |
| Sharing files with humans is awkward | Purpose-built shares (Send / Receive / Exchange) with passwords, expiration, and branding |
| Collecting files from humans is harder | Receive shares let humans upload directly into your workspace |
| Understanding document contents | Built-in AI (Ripley) reads, summarizes, and answers questions about your files with citations |
| Building a RAG pipeline from scratch | Enable workspace intelligence and files are automatically indexed and queryable |
| Two agents colliding on the same work | Agent Intents — announce what you're working on so peers see the conflict before it happens |
| Handing a project off to a human | One-step ownership transfer — the human gets the org, the agent keeps admin access |
Connecting
| Tool set | Endpoint (Streamable HTTP) |
|---|---|
| Named mode — one tool per area | https://mcp.fast.io/mcp/tools |
| Code mode — search the API and call it | https://mcp.fast.io/mcp/code |
The URL fixes the tool set for the session. A client without an Authorization header signs in with OAuth in the browser; a client can instead send Authorization: Bearer <api-key>. The earlier URLs https://mcp.fast.io/mcp, /mcp/oauth, /mcp/key and /sse keep working; on those the tool set is chosen from the client's clientInfo.name.
Two Modes
The server exposes one of two tool sets, chosen by the URL (see Connecting):
- Named mode (35 tools; 39 where e-signature and cloud import are enabled) — action-routed tools covering the full REST surface. Each area has a read tool (
storage) and a_managetool for its create, update and delete actions (storage_manage). - Code mode (8 tools) — a lightweight set (
auth,auth_manage,upload,upload_manage,search,execute,execute_manage,how-to) for headless coding agents (e.g. Claude Code, Cursor, Codex).searchdiscovers content or API endpoints;executemakes structured authenticated GET calls andexecute_managethe writes.
Tools (Named mode)
Each tool covers a domain and uses an action parameter to select the operation. Reads are on the domain tool (org), writes on its _manage sibling (org_manage); find, download and how-to are read-only and have no sibling. Every tool supports action: "describe" (no auth required), which returns the authoritative per-action parameter reference.
| Tool | Domain |
|---|---|
auth / auth_manage | Sign-in/sign-up, 2FA, API key management, OAuth/PKCE sessions |
user / user_manage | Current user profile, contacts, invitations, user assets, account eligibility |
org / org_manage | Organization CRUD, members, invitations, assets, org discovery, ownership transfer |
workspace / workspace_manage | Workspace lifecycle & settings, archive, members, notes, share import, async-job status |
share / share_manage | Share CRUD (Send / Receive / Exchange), archiving, passwords, members, AI titling |
fileshare / fileshare_manage | Durable single-file share links, the replacement for QuickShare (access tiers, password, expiry, per-user grants, version history) |
storage / storage_manage | Files & folders: list/search/move/copy/rename/delete/restore, versions, locking, previews, per-node metadata |
metadata / metadata_manage | Workspace metadata vocabulary, lexical value search, combined metadata + content matching, extraction eligibility |
find | Unified search across a workspace or share — one query, results grouped into files, metadata, and comments |
upload / upload_manage | File uploads: single-call streaming, chunked, bulk batch, web import from URLs |
download | Pre-authenticated download / ZIP URLs (MCP cannot stream binary directly) |
ai / ai_manage (Ripley) | Ask a natural-language question about workspace/share content and get a cited answer; manages chat threads |
comment / comment_manage | Comments on files, with optional anchoring to regions/timestamps/pages |
event / event_manage | Audit & activity log, AI activity summaries, activity polling, per-member dashboard feed |
member / member_manage | Member management for workspaces and shares (roles, ownership transfer, join/leave) |
invitation / invitation_manage | Invitation management for workspaces and shares |
asset / asset_manage | Branding asset upload/list/read/delete for orgs, workspaces, shares, users |
intent / intent_manage | Agent Intents — announce what you're working on in a workspace so peers see a collision before it happens |
how-to | Built-in product help — ask "how do I…" questions about Fastio (explain-only) |
The how-to tool
The guide and tool descriptions stay lean by deferring product how-tos to a built-in help tool. Call how-to action=ask question="..." whenever the right approach on Fastio isn't obvious (branded shares, metadata extraction, coordinating with another agent, ownership transfer). It returns the canonical, product-aware sequence of steps.
- Explain-only — it returns guidance; it never creates, updates, or deletes anything.
- Available in both modes (answers are phrased as named-tool calls or
execute/execute_managecalls to match).
Resources
Read via resources/list / resources/read:
| URI | Description |
|---|---|
skill://guide | This package's full agent guide (SKILL.md) |
session://status | Current authentication state |
resource://status | Server identity, version, and transport endpoints (no auth) |
download://workspace/{workspace_id}/{node_id} | Inline file content from a workspace |
download://share/{share_id}/{node_id} | Inline file content from a share |
download://fileshare/{fileshare_id} | Inline file content from a File Share link |
The download:// resources return content inline up to 100 KB — UTF-8 text for textual types, base64 otherwise. Above that they return a fallback download URL instead; for anything larger use the download tool's file-url action.
No MCP prompts are registered.
Authentication
Four ways to authenticate:
- Agent account —
auth_manage action=signupcreates an agent account. Signup does not auto-sign-in; follow it withauth_manage action=signin, then verify the email. - API key —
auth_manage action=set-api-keywith a key from an existing human account; you operate as that human. - Sign in —
auth_manage action=signinwith email and password. - PKCE browser login —
auth_manage action=pkce-login→ user approves in browser →auth_manage action=pkce-complete. Secure OAuth 2.0 flow without sharing a password. Not for headless agents.
Core Capabilities
- File storage with in-place overwrite versioning, folder hierarchy, and full-text/semantic search
- Branded shares (Send / Receive / Exchange) with passwords, expiration, custom branding, and inline preview
- Built-in AI/RAG (Ripley) — ask questions about files with citations, scoped to folders or an entire workspace
- Metadata extraction — pull structured data out of unstructured files, then search across the workspace field vocabulary
- Agent Intents — declare what you're working on in a workspace so parallel agents don't collide
- File preview — images, video (HLS), audio, PDF, spreadsheets, and code rendered inline
- URL import — pull a file straight into a workspace from any URL
- Comments & annotations — anchored to image regions, video/audio timestamps, and PDF pages
- Ownership transfer — build an org, then hand it to a human; the agent keeps admin access
Common Workflows
Deliver a report: Upload the file, create a Send share with a password and expiration, share the branded link.
Collect documents: Create a Receive share, send the link, files appear in your workspace.
Build a knowledge base: Create a workspace, turn on intelligence (it is off by default), upload documents, then query across all content with ai_manage action=ask (Ripley).
Set up a project for a human: Create the org, workspaces, and shares, upload content, configure branding, then transfer ownership.
Package Contents
| File | Description |
|---|---|
SKILL.md | Complete agent guide — tool menu, MCP-server mechanics, authentication, and guardrails |
references/REFERENCE.md | Platform deep-dive — capabilities, concepts, URL construction |
skills/fast-io/ | The same guide and reference laid out as a plugin skill (generated copy of the two files above) |
.claude-plugin/plugin.json, .mcp.json | Claude Code plugin manifest and its remote MCP server (/mcp/tools) |
plugin.json, mcp.json | Portable Agent Plugins manifest and MCP configuration (/mcp/tools; the OpenAI package uses /mcp/operations) |
Links
- Platform guide: references/REFERENCE.md
- API reference: https://api.fast.io/llms.txt
- Website: https://fast.io
- Privacy policy: https://fast.io/privacy/
- Terms of service: https://fast.io/terms/
- Support: https://mcp.fast.io/docs#support