Skip to content
SuperFiles Docs
Esc
↑↓navigate↵open⌘Jpreview
On this page

MCP Server

Use SuperFiles from any AI assistant via the Model Context Protocol.

MCP Server (@superfiles/mcp)

@superfiles/mcp is an MCP (Model Context Protocol) server that exposes all SuperFiles operations as structured tools. Any MCP-compatible AI assistant — Claude Desktop, Cursor, Continue, Cline, etc. — can manage your files, buckets, and CDN without custom code.

Installation

npm install -g @superfiles/mcp
# or run directly with npx (no install needed)

Configure in Claude Desktop

Open ~/Library/Application Support/Claude/claude_desktop_config.json and add:

{
  "mcpServers": {
    "superfiles": {
      "command": "npx",
      "args": ["-y", "@superfiles/mcp"],
      "env": {
        "SUPERFILES_API_URL": "https://api.superfiles.montr.online",
        "SUPERFILES_API_KEY": "sf_live_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Restart Claude Desktop. You’ll see a SuperFiles server in the MCP tools panel.

Configure in Cursor / Continue

Add to your .cursor/mcp.json or .continue/config.json:

{
  "mcpServers": {
    "superfiles": {
      "command": "npx",
      "args": ["-y", "@superfiles/mcp"],
      "env": {
        "SUPERFILES_API_URL": "https://api.superfiles.montr.online",
        "SUPERFILES_API_KEY": "sf_live_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Configure for a self-hosted instance

Point SUPERFILES_API_URL at your self-hosted SuperFiles API:

{
  "env": {
    "SUPERFILES_API_URL": "https://superfiles-api.example.com",
    "SUPERFILES_API_KEY": "sf_live_xxxx"
  }
}

Available tools

The MCP server exposes 28 user tools and, if your API key has admin scope, an additional 4 admin tools.

Bucket tools

Tool Description
list_buckets List all buckets for the authenticated team
get_bucket Get metadata for a single bucket by slug
create_bucket Create a new bucket
update_bucket Update bucket name, public visibility, or CDN settings
delete_bucket Permanently delete a bucket and all its objects

Storage tools

Tool Description
upload_file Upload a file (base64-encoded body) to a bucket
download_file Download a file’s contents (returned as base64)
delete_object Delete an object
copy_object Copy an object within or across buckets
move_object Move / rename an object

Files & folders

Tool Description
list_files List objects in a bucket with optional prefix filter
get_file_info Get object metadata (size, content type, CDN URL)
search_files Full-text search across object keys
create_folder Create a virtual folder (prefix sentinel object)
list_folders List virtual folders under a prefix
delete_folder Delete a folder and all objects inside it

CDN tools

Tool Description
get_cdn_url Build a CDN transform URL (resize, convert, etc.)
invalidate_cdn_cache Purge a cached CDN URL

Presigned URLs

Tool Description
presign_upload Generate a short-lived presigned upload URL
presign_download Generate a short-lived presigned download URL

Shares

Tool Description
create_share Create a public share link for a file or prefix
list_shares List active share links
delete_share Revoke a share link

API keys

Tool Description
list_api_keys List all API keys for the team
create_api_key Create a new API key with selected scopes
revoke_api_key Revoke an API key

Usage & trash

Tool Description
get_storage_usage Get total storage used and object count per bucket
list_trash List soft-deleted objects pending permanent deletion
restore_from_trash Restore a soft-deleted object
empty_trash Permanently delete all trashed objects

Admin tools (requires admin scope)

Tool Description
list_teams List all teams on the instance
get_team_usage Get storage usage for any team
set_team_quota Set a storage quota for a team
get_system_stats Get instance-wide storage and usage statistics

Example prompts

Once configured, you can talk naturally to your AI assistant:

  • “Upload this image to my media bucket as avatars/user-123.jpg”
  • “List all files in the reports/2024/ folder of my documents bucket”
  • “Generate a resized WebP CDN URL for photos/hero.jpg at 1200×630”
  • “Create a 7-day share link for everything under public-release/v2/”
  • “How much storage am I using across all buckets?”

Resources

The server also exposes two MCP resources:

Resource URI Description
Bucket list superfiles://buckets Live list of all team buckets as JSON
System config superfiles://system/config API base URL, CDN base URL, and feature flags

Was this page helpful?