By filestack
Official Filestack plugin — upload files, build transformations, and generate security policies directly from Claude Code.
Use when user encounters Filestack API errors. Activates on: domain tokens (filestackapi.com, filestackcontent.com, process.filestackapi.com), error shapes ({'result': 'error', 'error':, {'error':, result: null in Filestack context), HTTP 401/403/404/429 from Filestack endpoints, or when user pastes a Filestack API error message.
Use when the user wants to analyze a file's content with AI/ML — content tagging, NSFW detection, OCR, image captioning, copyright check, document detection, or sentiment. Activates on: image tagging, NSFW/SFW classification, content moderation, OCR text extraction, image caption generation, "what's in this image", document scan/detection, sentiment analysis, AWS Rekognition, Google Cloud Vision, content classification, AI moderation pipeline, image analysis, or tokens like `filestack_analyze`, `/tags/`, `/sfw/`, `/caption/`, `/ocr/`, `/doc_detection/`.
Use when the user is working with Filestack SDK or API. Activates on: import tokens (filestack-js, filestack-loader, loadModule, from filestack import, filestack.Client), usage tokens (FilestackClient, client.upload(, client.picker(, new Picker(, PickerOptions), config tokens (acceptedFileTypes, fromSources, storeTo), or when user asks how to add file upload to their app using Filestack.
Use when user is setting up Filestack webhook endpoints. Activates on: FS-Signature, FS-Timestamp, fp.upload, fp.converse, fp.delete, fp.overwrite, fp.video_converse, fp.scan, fp.export, fs.workflow, filestack_webhook, webhook_url, or when user asks about Filestack event notifications.
Use when the user wants to design, run, or troubleshoot a Filestack Workflow — a multi-step file processing pipeline. Activates on: workflow design, multi-step processing, conditional file processing, automated pipelines, virus scanning workflow, video intelligence pipelines, async file processing, `runWorkflow` policy call, `run_workflow` task, `filestack_run_workflow`, `fs.workflow` webhook event, `wf.json`, workflow UUID, Filestack Workflows UI / Developer Portal Workflows.
Admin access level
Server config contains admin-level keywords
Requires secrets
Needs API keys or credentials to function
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
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.
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 |
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/
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.
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 |
filestack_uploadUpload 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_retrieveGet 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_deletenpx claudepluginhub filestack/filestack-claude-plugin --plugin filestack-claude-pluginExpert agent for file upload handling, AWS S3 integration, image processing with Sharp, video transcoding with FFmpeg, presigned URLs, and chunked uploads
Vercel Blob object storage with CDN for Next.js. Use for file uploads (images, PDFs, videos), presigned URLs, user-generated content, file management, or encountering BLOB_READ_WRITE_TOKEN errors, file size limits, client upload token errors.
Sync Claude Code sessions across devices with encrypted cloud storage
Auto-resize oversized screenshots to prevent Claude API dimension errors and session corruption
Upload images and media files to S3, auto-trigger after Playwright screenshots
Claude Code skill pack for Adobe (30 skills)