Claude Code Plugin

Official Claude Code plugin for Filestack – the file handling platform-as-a-service for uploads, cloud source ingestion, on-the-fly image/video/document processing, CDN delivery, and policy-based security.

This plugin brings the full Filestack platform into Claude Code through 10 MCP tools, 3 context-aware skills, and a natural language slash command. Upload files, build transformation pipelines, generate signed security policies, set up webhooks, and debug API errors – all through conversation, right in the terminal.

Two ways to install the plugin into Claude Code.

Claude Code

/plugin marketplace add https://github.com/filestack/filestack-claude-plugin.git
/plugin install filestack-claude-plugin@filestack-plugin

bash

git clone https://github.com/filestack/filestack-claude-plugin.git
cd filestack-claude-plugin/mcp && npm install && npm run build

Set these environment variables before starting Claude Code.

bash

export FILESTACK_API_KEY=your_api_key 
export FILESTACK_APP_SECRET=your_app_secret  # only needed for security tools

Find your API key and app secret in the Filestack Developer Portal.

Skills activate automatically based on conversation context – no manual invocation needed.

How skills work: Claude detects relevant patterns in your code, imports, error messages, or questions and automatically loads domain-specific knowledge about Filestack patterns, best practices, and debugging techniques.

filestack-js from filestack import client.picker( client.upload() fromSources storeTo acceptedFileTypes

Also activates when you ask how to add file upload to your app.

filestackapi.com filestackcontent.com HTTP 401 HTTP 403 HTTP 404 HTTP 429 {"result": "error"} result: null

Also activates when you paste a Filestack error message.

FS-Signature FS-Timestamp fp.upload fp.converse fp.delete fp.video_converse fp.scan filestack_webhook

Also activates when you paste a Filestack error message.

Convert plain-English descriptions into Filestack CDN transformation URLs.

/filestack-transform <handle-or-url> <description>

Accepts bare handles or full CDN URLs. If called with no arguments, shows usage and examples.

Examples

Claude Code

/filestack-transform abc123XYZ resize to 800x600 and convert to webp
-> https://cdn.filestackcontent.com/resize=width:800,height:600/output=format:webp/abc123XYZ

 /filestack-transform abc123XYZ detect face, enhance, and convert to jpg at 85 quality
-> https://cdn.filestackcontent.com/crop_faces=faces:1/enhance/output=format:jpg,quality:85/abc123XYZ

 /filestack-transform https://cdn.filestackcontent.com/abc123XYZ rotate 90 and monochrome
-> https://cdn.filestackcontent.com/rotate=deg:90/monochrome/abc123XYZ

Use with filestack_transform_url, filestack_transform_apply, and /filestack-transform.

Order matters: Transforms are chained left-to-right in the CDN URL. Put processing operations (resize, crop, enhance) before format conversion (output).

Run the MCP server remotely instead of locally.

Replace .mcp.json with:

.mcp.json

{
  "filestack": {
    "type": "http",
    "url": "https://mcp.filestack.com/mcp",
    "headers": {
      "Authorization": "Bearer ${FILESTACK_API_KEY}"
    }
  }
}

Tip: The remote endpoint stays up-to-date with the latest Filestack API automatically – no local rebuilds required.

Common problems and their solutions.