LABSCO SUMMARY

A CLI that thought about token cost before exposing itself to an agent.

Markdown rather than JSON on every read and status response is a deliberate choice for LLM consumers, and --tools lets you cut the surface down to the groups a given agent actually needs. Some things stay CLI-only on purpose — sign send and void, fileshare upload write-back and ws-token — and the sign tool only appears when E-Sign is enabled, so a few high-risk operations are simply not reachable from the agent.

What it is

A Rust-built command-line interface to the Fast.io cloud storage platform that also runs as an MCP server. fastio mcp exposes the CLI's action-routed command surface as MCP tools over stdio, so the same authentication, profiles and backend settings apply whether a person or an agent is driving.

What you get

Organizations, workspaces, members and invitations managed as command groups — org, workspace, member, invitation
Files listed, foldered, moved, copied, renamed, deleted, trashed, versioned, searched and locked — files, lock
Chunked uploads with progress, text upload, URL import and session management — upload; streaming downloads, folder ZIP and batch — download
Shares and durable single-file link shares with grants, previews and activity — share, fileshare; plus comment, event, preview, asset
Fast.io's delegated AI agent for ask, chat, search, history and summarize — ripley
Tool responses rendered as GitHub-flavored Markdown, byte-equivalent to the API's ?output=markdown, which is substantially more token-efficient than pretty-printed JSON
Tool filtering — fastio mcp --tools auth,org,workspace,files,upload,download narrows what the agent sees

Requirements

A Fast.io account. Authentication is checked in order: the --token flag, then FASTIO_TOKEN, then FASTIO_API_KEY, then stored profile credentials. fastio auth login opens a browser for PKCE OAuth and refreshes tokens automatically; fastio auth api-key create mints a key for CI. Install with npm install -g @vividengine/fastio-cli (version 0.2.37, binary fastio), a shell script, a prebuilt binary for macOS/Linux/Windows, or cargo install --path . which needs Rust 1.85+. Configure the MCP entry as command fastio with args ["mcp"]. The server honors --api-base, --token and --profile. Apache License 2.0.

Setup effort

One command plus a key — npm install -g @vividengine/fastio-cli, then supply credentials

See installation options

USE CASES

01

Finding a file across a workspace

Search and list through the file group and get the result as a Markdown table instead of a wall of JSON.

02

Getting a large upload in without babysitting it

Use the chunked upload path with its session management, which handles progress and resumption for you.

03

Giving an agent only what it needs

Start the server with the tool filter set to the groups the task requires, so the rest of the surface never reaches the model.

04

Running it against a staging backend

Launch with a named profile or an API base override, since the MCP server honors the same global flags as the CLI.

BEFORE YOU INSTALL

What to know first

Requires

fastio on PATH
FASTIO_TOKEN in your environment
FASTIO_API_KEY in your environment

INSTALLATION

Connect your client

Add the block to your client, or run the command directly.

Server setup

Configuration file

JSON

{
  "mcpServers": {
    "fastio": {
      "command": "fastio",
      "args": [
        "mcp"
      ]
    }
  }
}

The configuration on this page does not set FASTIO_TOKEN and FASTIO_API_KEY; the project's instructions set them with an export line. That line reaches only programs started from the same terminal, so to supply them, start your client or the server from that terminal.

npm

TERMINAL

npm install -g @vividengine/fastio-cli

Fast.io