Radarr (Movies) MCP Server for Mastra AIGive Mastra AI instant access to 15 tools to Add Movie, Delete Movie, Delete Queue Item, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Radarr (Movies) 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 Radarr (Movies) MCP Server for Mastra AI is a standout in the Content Management category — giving your AI agent 15 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: {
"radarr-movies": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Radarr (Movies) Agent",
instructions:
"You help users interact with Radarr (Movies) " +
"using 15 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Radarr (Movies)?"
);
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 Radarr (Movies) MCP Server
Connect your Radarr instance to any AI agent to take full control of your movie collection and PVR workflows through natural conversation.
Mastra's agent abstraction provides a clean separation between LLM logic and Radarr (Movies) tool infrastructure. Connect 15 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
- Library Management — List all movies in your collection, fetch detailed metadata, and update movie configurations.
- Discovery & Search — Search for new movies using TMDB integration and add them to your library with specific quality profiles.
- Download Monitoring — Track your active download queue, view history of grabs/imports, and manage queue items.
- System Operations — Check disk space, system status, and execute internal commands like library refreshes.
- Infrastructure Mapping — Retrieve root folders and quality profiles to ensure correct organization of your media files.
The Radarr (Movies) MCP Server exposes 15 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 15 Radarr (Movies) tools available for Mastra AI
When Mastra AI connects to Radarr (Movies) through Vinkius, your AI agent gets direct access to every tool listed below — spanning movies, media-server, pvr, 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.
Add movie on Radarr (Movies)
Requires TMDB ID, quality profile, and root folder path. Add a new movie to Radarr
Delete movie on Radarr (Movies)
Remove a movie from Radarr
Delete queue item on Radarr (Movies)
Remove an item from the download queue
Execute command on Radarr (Movies)
g., RescanMovie, MovieSearch, RefreshMovie, RenameMovie). Execute a specific system command
Get commands on Radarr (Movies)
List active or recently completed commands
Get disk space on Radarr (Movies)
Get disk space information
Get history on Radarr (Movies)
View the history of grabs and imports
Get movie on Radarr (Movies)
Get details for a specific movie
Get quality profiles on Radarr (Movies)
g., HD-1080p, Ultra-HD) configured in Radarr. Get available quality profiles
Get queue on Radarr (Movies)
Get the current download queue
Get root folders on Radarr (Movies)
Get configured root folders
Get system status on Radarr (Movies)
Get Radarr system status
List movies on Radarr (Movies)
List all movies in the Radarr library
Lookup movie on Radarr (Movies)
g., "term=Inception" or "term=tmdb:27205"). Search for movies to add to Radarr
Update movie on Radarr (Movies)
Provide the full movie object payload. Update an existing movie in Radarr
Connect Radarr (Movies) to Mastra AI via MCP
Follow these steps to wire Radarr (Movies) 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 Radarr (Movies) MCP Server
Mastra AI provides unique advantages when paired with Radarr (Movies) through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Radarr (Movies) 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 Radarr (Movies) 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
Radarr (Movies) + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Radarr (Movies) MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Radarr (Movies), process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Radarr (Movies) as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Radarr (Movies) on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Radarr (Movies) tools alongside other MCP servers
Example Prompts for Radarr (Movies) in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Radarr (Movies) immediately.
"List all movies currently in my Radarr library."
"Search for the movie 'Inception' and tell me its TMDB ID."
"Show me the current download queue and estimated completion times."
Troubleshooting Radarr (Movies) MCP Server with Mastra AI
Common issues when connecting Radarr (Movies) to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpRadarr (Movies) + Mastra AI FAQ
Common questions about integrating Radarr (Movies) 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 →
NetBird
89 toolsAutomate Zero Trust networking via NetBird — manage accounts, users, and access controls directly from any AI agent.
Mastercard
12 toolsIdentify cards, validate accounts, find merchants, and detect fraud via Mastercard payment APIs.
Make.com Webhook Trigger
1 toolsThis MCP does exactly one thing: it sends JSON payloads to Make.com Webhooks. That's its only function. Incredible for connecting AI agents to thousands of visual automation workflows instantly.
Resend Alternative
14 toolsSend emails and manage domains via Resend — send transactional emails, track deliveries, manage domains and API keys from any AI agent.