Automate transfers, trigger conversions, and build AI agent workflows with the FileFlippers REST API and MCP server.
import { FileFlippersMCP } from "@fileflippers/mcp";
const ff = new FileFlippersMCP({ apiKey: process.env.FF_API_KEY });
// Upload a file and get a shareable link
const transfer = await ff.create_transfer({
file: "./finals/campaign_v3.mp4",
expiry: "7d",
password: "studio2024",
});
console.log(transfer.shareUrl);
// https://fileflippers.com/share/abc123Upgrade to Pro or Squad
API access is available on Pro (£11.99/mo) and Squad plans. API keys are created per user account.
View pricingCreate an API key
Go to Account Settings → API Keys → Create key. Copy the key straight away, since it's only shown once. You can create up to 5 keys per account.
Account settingsInstall the MCP package
Run npm install @fileflippers/mcp and set your FF_API_KEY environment variable. That's it.
Send your first transfer
Call create_transfer with a file path and options. The API returns a shareable link you can send directly to your client.
Full upload pipeline
API transfers use the same multipart chunked upload as the browser, with pause, resume, and crash recovery included.
Same scanning, no bypass
Every API upload goes through the same ClamAV virus scanning and CSAM checks as a manual upload. There is no scan bypass for API keys.
Convert + enhance via API
Trigger format conversion and AI enhancement programmatically. Credits deduct from your plan allowance exactly as they would in the UI.
MCP server for AI agents
Install @fileflippers/mcp and let Claude, Cursor, or any MCP-compatible agent send files on your behalf without leaving your workflow.
Per-key rate limits
Create up to 5 API keys per account. Each key has its own rate limit. Revoke a single key without disrupting other integrations.
Webhooks (coming soon)
Get notified when a scan completes, a payment clears, or a file is downloaded. Webhook support is on the roadmap.
API uploads go through the same security checks.
There is no bypass for API keys. Every file uploaded via the API is scanned by ClamAV for malware (up to 2 GB) with Cloudflare's CSAM detection running at our delivery layer. The same rules apply whether a file is uploaded from a browser or from your CI pipeline.
| Feature | Browser | API / MCP |
|---|---|---|
| Upload files | ||
| Set expiry & password | ||
| Virus scanning (ClamAV) | ||
| CSAM screening (Cloudflare) | ||
| File conversion | ||
| AI enhancement (Boost) | ||
| Watermarked delivery | — | |
| Payment-gated delivery | — | |
| Branded download page | — | |
| Client review & feedback | — |
create_transferUpload a file and get a shareable link. Supports expiry, password, and title.
get_transfer_statusCheck the scan status, download count, and expiry of a transfer.
list_transfersList your recent transfers with status and metadata.
convert_fileConvert a file to a different format and return the download URL.
API access, MCP server, and key management are included in Pro and Squad plans. No extra charge.
See plans and pricing