Sonarr (TV) MCP Server for Mastra AIGive Mastra AI instant access to 18 tools to Add Series, Delete Episode File, Delete Queue Item, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Sonarr (TV) 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 Sonarr (TV) MCP Server for Mastra AI is a standout in the Productivity category — giving your AI agent 18 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: {
"sonarr-tv": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Sonarr (TV) Agent",
instructions:
"You help users interact with Sonarr (TV) " +
"using 18 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Sonarr (TV)?"
);
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 Sonarr (TV) MCP Server
Connect your Sonarr instance to any AI agent to take full control of your TV media library through natural conversation.
Mastra's agent abstraction provides a clean separation between LLM logic and Sonarr (TV) tool infrastructure. Connect 18 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 series, add new shows via TVDB ID, and update monitoring status or quality profiles.
- Episode Tracking — Fetch details for specific episodes, list all episodes in a series, and manage their monitored state.
- File Control — List and delete physical episode files directly from your storage to manage disk space.
- Activity Monitoring — Access download history and current queue status to see what's downloading or stalled.
- System Health — Check Sonarr's connectivity, system status, and internal health metrics to ensure smooth operation.
The Sonarr (TV) MCP Server exposes 18 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 18 Sonarr (TV) tools available for Mastra AI
When Mastra AI connects to Sonarr (TV) through Vinkius, your AI agent gets direct access to every tool listed below — spanning media-management, pvr, automation, 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 series on Sonarr (TV)
Adds a new series to the library
Delete episode file on Sonarr (TV)
Deletes an episode file from disk
Delete queue item on Sonarr (TV)
Removes an item from the queue
Delete series on Sonarr (TV)
Removes a series from the library
Get episode on Sonarr (TV)
Returns a specific episode by its ID
Get episode file on Sonarr (TV)
Returns a specific episode file
Get health on Sonarr (TV)
Returns any health check warnings or errors
Get history on Sonarr (TV)
Access the history of grabbed and imported episodes
Get queue on Sonarr (TV)
Returns all items in the download queue
Get series on Sonarr (TV)
Returns a specific series by its ID
Get system status on Sonarr (TV)
Returns system information (version, OS, paths)
List commands on Sonarr (TV)
Returns all currently running commands
List episode files on Sonarr (TV)
Returns all episode files for a series
List episodes on Sonarr (TV)
Returns all episodes for a specific series
List series on Sonarr (TV)
Returns all series in the library
Start command on Sonarr (TV)
g., SeriesSearch, RescanSeries, RefreshSeries). Starts a new command
Update episode on Sonarr (TV)
Updates an episode (e.g., marking it as monitored)
Update series on Sonarr (TV)
Updates an existing series
Connect Sonarr (TV) to Mastra AI via MCP
Follow these steps to wire Sonarr (TV) 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 Sonarr (TV) MCP Server
Mastra AI provides unique advantages when paired with Sonarr (TV) through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Sonarr (TV) 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 Sonarr (TV) 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
Sonarr (TV) + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Sonarr (TV) MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Sonarr (TV), process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Sonarr (TV) as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Sonarr (TV) on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Sonarr (TV) tools alongside other MCP servers
Example Prompts for Sonarr (TV) in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Sonarr (TV) immediately.
"List all TV series in my Sonarr library."
"Check the current download queue and history."
"Get details for episode ID 1542."
Troubleshooting Sonarr (TV) MCP Server with Mastra AI
Common issues when connecting Sonarr (TV) to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpSonarr (TV) + Mastra AI FAQ
Common questions about integrating Sonarr (TV) 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 →
RenderForm
12 toolsGenerate dynamic images and social media graphics from templates with an API that personalizes visuals at scale for any campaign.
Payload CMS
10 toolsManage headless content via Payload CMS — manipulate documents, patch JSON states, retrieve singletons, and structure database endpoints using AI.
SendCloud
10 toolsLeading email and SMS marketing platform — manage campaigns, templates, and addresses via AI.
Adzuna
4 toolsSearch job listings and salary data — find vacancies and employment trends via AI.