filestack

Filestack Plugin for Claude Code & Cursor

Official Filestack plugin for Claude Code and Cursor — 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 your coding agent through 19 MCP tools, 5 context-aware skills, and a natural language slash command. Upload files, build transformation pipelines, run AI/ML analysis (tagging, OCR, captioning, moderation), convert documents and videos, bundle ZIPs, capture web screenshots, run workflows, generate signed security policies, verify webhook signatures, set up integrations, and debug API errors — all through conversation without leaving the terminal.

---

Table of Contents

• Supported Platforms
• Installation
• Configuration
• MCP Tools
  • File Operations
  • Transformations
  • Security
• Skills
  • filestack-sdk-integration
  • filestack-error-diagnosis
  • filestack-webhook-setup
• Slash Command
• Examples
• Available Transformations
• Troubleshooting
• Documentation
• License

---

Supported Platforms

This plugin works with both Claude Code and Cursor. Install it from either marketplace and the correct configuration is detected automatically.

Platform	Manifest
Claude Code	.claude-plugin/plugin.json
Cursor	.cursor-plugin/plugin.json

Installation

From marketplace (recommended):

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

The plugin works immediately with a built-in demo API key. For full access to your own Filestack account, set your API key (see Configuration).

Don't have a Filestack account yet? Sign up free at https://dev.filestack.com/signup/free/

Configuration

The plugin runs a local MCP server and works out of the box with a demo API key (APQLlwqrRScGxhw78gs9Wz). To use your own Filestack account, set your API key as an environment variable before starting your editor:

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

You can find your API key and app secret in the Filestack Developer Portal.

Variable	Required	Used by
FILESTACK_API_KEY	No (demo key used if unset)	All file operation and transformation tools
FILESTACK_APP_SECRET	Only for security tools	filestack_sign_policy, filestack_generate_signed_url

The MCP server runs locally via Node.js. Policy signing happens on your machine — your app secret never leaves your environment.

---

MCP Tools

The plugin exposes 19 tools across 7 categories:

Category	Tools
File operations	filestack_upload, filestack_retrieve, filestack_delete, filestack_store_url
Transformations	filestack_transform_url, filestack_transform_apply, filestack_list_transforms
Security	filestack_generate_policy, filestack_sign_policy, filestack_generate_signed_url
Intelligence (AI/ML)	filestack_analyze (tags / sfw / caption / ocr / copyright / image_sentiment / doc_detection / text_sentiment)
Document & video	filestack_convert_document, filestack_convert_video, filestack_video_status
Archive & capture	filestack_zip_files, filestack_screenshot_url
Workflows & webhooks	filestack_run_workflow, filestack_verify_webhook_signature, filestack_sign_webhook_payload

File Operations

filestack_upload

Upload a local file or remote URL to Filestack and get a CDN-ready file handle.

"Upload ./product-photo.jpg to Filestack"
"Upload https://example.com/image.png to Filestack"

Parameters:

Parameter	Type	Required	Description
filePath	string	Yes	Local file path or remote URL
storeOptions	object	No	Storage options: location, path, container, access

Returns: { handle, url, filename, size, type }

filestack_retrieve

Get metadata for any file handle — size, MIME type, dimensions, upload date, etc.

"What's the metadata for file handle abc123XYZ?"

Parameters:

Parameter	Type	Required	Description
handle	string	Yes	Filestack file handle

filestack_delete