FileStack MCP Server for Mastra AIGive Mastra AI instant access to 8 tools to Generate Transform Url, Get Image Tags, Get Metadata, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect FileStack through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The FileStack MCP Server for Mastra AI is a standout in the Image Video category — giving your AI agent 8 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Geminiimport { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"filestack": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "FileStack Agent",
instructions:
"You help users interact with FileStack " +
"using 8 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with FileStack?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About FileStack MCP Server
Connect your Filestack account to any AI agent to handle complex file workflows, from cloud uploads to advanced AI content analysis, through simple commands.
Mastra's agent abstraction provides a clean separation between LLM logic and FileStack tool infrastructure. Connect 8 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
What you can do
- Smart Uploads — Upload files directly from any public URL to your Filestack S3 storage using
upload_from_url. - AI Intelligence — Automatically extract text from documents (
get_ocr), detect objects and features in images (get_image_tags), and check for unsafe content (get_sfw_status). - Image Transformations — Generate optimized CDN URLs for resizing, blurring, or filtering images using
generate_transform_urlwithout manual editing. - Video Processing — Initiate and monitor asynchronous video transcoding jobs (
start_video_transcode) to convert files into web-ready formats like MP4 or HLS. - Metadata Inspection — Retrieve deep technical details including dimensions, mime types, and file sizes with
get_metadata.
The FileStack MCP Server exposes 8 tools through the Vinkius. Connect it to Mastra AI in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 8 FileStack tools available for Mastra AI
When Mastra AI connects to FileStack through Vinkius, your AI agent gets direct access to every tool listed below — spanning file-upload, image-processing, ocr, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Generate transform url on FileStack
g., resize=width:400). Does not execute the request, just returns the URL. Generate a Filestack transformation URL
Get image tags on FileStack
Detect objects and features in an image
Get metadata on FileStack
Get metadata for a Filestack file
Get ocr on FileStack
Extract printed or handwritten text (OCR)
Get sfw status on FileStack
Detect unsafe content (Safe for Work)
Get video status on FileStack
Poll status of a video transcoding job
Start video transcode on FileStack
Returns a UUID that must be used to poll for status. Start asynchronous video/audio transcoding
Upload from url on FileStack
Upload a file to Filestack from a public URL
Connect FileStack to Mastra AI via MCP
Follow these steps to wire FileStack into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the FileStack MCP Server
Mastra AI provides unique advantages when paired with FileStack through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add FileStack without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every FileStack tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
FileStack + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the FileStack MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query FileStack, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed FileStack as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query FileStack on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using FileStack tools alongside other MCP servers
Example Prompts for FileStack in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with FileStack immediately.
"Upload this image to Filestack: https://example.com/photo.jpg"
"What objects are detected in the image with handle ABC123XYZ?"
"Convert the video ABC123XYZ to mp4 format."
Troubleshooting FileStack MCP Server with Mastra AI
Common issues when connecting FileStack to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpFileStack + Mastra AI FAQ
Common questions about integrating FileStack MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
Tencent TRTC
11 toolsBring Tencent's Dominant Real-Time Communications Engine to your AI workflow. Manage rooms, cloud recordings, and call metrics.
Nabis
10 toolsCannabis wholesale and distribution — manage orders, inventory, and retailers via Nabis.
RongCloud
10 toolsLeading IM and RTC platform in China — manage users, messages, and chatrooms via AI.
Moodle
12 toolsPower your e-learning environment with the world most flexible open-source LMS for course creation and student management.