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`:

| 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 |

## Getting Started

### 1. Create an Agent Account

```
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.

### 2. Create an Organization

```
org-create → name, domain (3+ chars, lowercase alphanumeri...