How to Use the Prowlarr (Indexers) MCP in OpenAI Agents SDK

Q: How do I connect Prowlarr (Indexers) to the OpenAI Agents SDK?

Install openai-agents via pip. Initialize MCPServerStreamableHttp with your endpoint URL, then pass it in the mcpservers array when building your agent. Set cacheToolsList=True to speed up initialization.

Manage Prowlarr trackers safely in production using the OpenAI Agents SDK and built-in execution guardrails.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Prowlarr (Indexers) MCP to OpenAI Agents SDK

Create your Vinkius account to connect Prowlarr (Indexers) to OpenAI Agents SDK — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Prowlarr (Indexers) with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Automated tracker health monitoring

The `prowlarr-indexers-mcp` exposes your entire tracker configuration to OpenAI's automated agents. You pass the server to the Agent constructor, and it auto-discovers all eight endpoints without manual mapping. Instead of writing custom polling scripts, your agent runs `get_indexer_status` on a schedule. If an endpoint fails, the built-in guardrails pause execution before the agent attempts a blind `delete_indexer` command, saving your configuration history from accidental wipes.

Strict schema validation via MCP Server

This MCP Server handles the strict schema requirements for adding new Usenet and torrent sources. Your agent calls `get_indexer_schema` to grab the required fields before attempting an `add_indexer` operation. OpenAI's tracing dashboard logs the exact payload sent to Prowlarr. When the agent fires `test_indexer` to validate the new connection, you see the exact HTTP response times and failure reasons right in your telemetry, making debugging instant.

Multi-agent remediation workflows

Fetching your active tracker list happens through the `list_indexers` tool. A specialized diagnostic agent can pull this list and hand off specific failing IDs to a remediation agent. That second agent then uses `get_indexer` to read the current settings and `update_indexer` to apply fixes, like rotating an API key or changing a base URL. The entire multi-step process stays contained within your defined safety constraints.

Setup guide

Set up Prowlarr (Indexers) MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Prowlarr (Indexers) tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Prowlarr (Indexers) tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Prowlarr (Indexers) tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Prowlarr (Indexers) Agent",
            instructions="You have access to Prowlarr (Indexers) tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Prowlarr. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Prowlarr (Indexers) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Prowlarr (Indexers) MCP in OpenAI Agents SDK

Install `openai-agents` via pip. Initialize `MCPServerStreamableHttp` with your endpoint URL, then pass it in the `mcp_servers` array when building your agent. Set `cacheToolsList=True` to speed up initialization.

Yes, if you configure the guardrails to allow it. The agent checks `get_indexer_status` and can execute `update_indexer` to modify URLs or keys when a tracker goes offline.

The SDK handles the handoff, not the server itself. You can have one agent running `list_indexers` to monitor health, which then passes the context to a networking agent that runs `test_indexer` to diagnose the outage.

Prowlarr requires specific payload structures based on the tracker type. Your agent must pull the template via `get_indexer_schema` first, otherwise the `add_indexer` call will reject the missing fields.

Your indexer API keys and base URLs stay entirely within the local V8 Isolate Sandbox. The OpenAI agent requests a connection test, but the actual HTTP request to the tracker originates from the sandbox, keeping your credentials off external LLM servers.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript