agentmods.dev

servarr-mcp AGENTS.md

servarr-mcp AGENTS.md is an instructions file for Codex, OpenCode from CarlDog/servarr-mcp. It costs 2,460 tokens per session, scanned A, original, MIT.

A project instruction file for servarr-mcp, a Docker-based MCP server for Sonarr, Radarr, Lidarr, Readarr, and Prowlarr. These are self-hosted apps for managing media libraries and downloads.

In plain words
What is it for?
Use it when maintaining integrations with the Servarr apps, including status, queue, history, authentication, and container builds.
Why use it?
It points the agent to the project’s current status and defines the code structure, APIs, runtime, and deployment rules.

Instructions file for CodexOpenCode

not rated 0 yesterday A scan 2,460 tokens original MIT
View the source file CarlDog/servarr-mcp
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/carldog/servarr-mcp/agents-md
Clone the repo
git clone --depth 1 https://github.com/CarlDog/servarr-mcp

Made for: Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for servarr-mcp AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/carldog/servarr-mcp/agents-md.svg)](https://agentmods.dev/instructions/carldog/servarr-mcp/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/carldog/servarr-mcp/agents-md"><img src="https://agentmods.dev/badge/instructions/carldog/servarr-mcp/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 2,460 This file is loaded in full into every session.
When invoked 2,460 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.02460 $0.02460
Opus 5 $0.01230 $0.01230
Sonnet 5 $0.00492 $0.00492
Haiku 4.5 $0.00246 $0.00246

Measured 3d ago against content hash 5024b59bed03, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

servarr-mcp AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

Copies of this mod

1 near-identical copy found in the catalogue:

AGENTS.md · 217 lines

How it starts

The opening of the file, as written. The whole thing — 217 lines — stays where its author put it; the contents beside it link to each section on GitHub.

servarr-mcp

MCP server for the Servarr stack (Sonarr, Radarr, Lidarr, Readarr, Prowlarr), packaged as a Docker container.

Status

Single source of truth: STATUS.md. Do not duplicate status into this file, MEMORY.md, or Serena memories — reference STATUS.md.

Current Sprint

See STATUS.md for the active phase, what's done, and what's next.

Stack

  • TypeScript (Node 22+, ESM, NodeNext module resolution)
  • @modelcontextprotocol/sdk (high-level McpServer API)
  • zod for tool input schemas
  • Servarr REST APIs accessed directly via fetch (no third-party client)
  • Docker multi-stage build (alpine, non-root user)

Layout

  • src/index.ts — MCP server entry / composition root. Computes which apps are enabled from env vars at startup, then decides transport (stdio vs HTTP) based on MCP_PORT. Per-session McpServer instances via the createServer() factory; client instances are computed once at startup.
  • src/clients/base.ts — ServarrClient base class with shared HTTP plumbing (X-Api-Key auth, request helper, common endpoints: systemStatus, queue, history). Also exports the asText() helper.
  • src/clients/<app>.ts — one file per app, holding only the <App>Client class (subclass of ServarrClient with app-specific resource methods). Today: sonarr.ts, radarr.ts, lidarr.ts, readarr.ts, prowlarr.ts.
  • src/tools/<app>/index.ts — MCP tool registrations for that app. Each exports a register<App>Tools(server, client) function. Today each app's index.ts holds all of that app's registrations directly. As tool counts grow, pull resource groups into sibling files (series.ts, wanted.ts, etc.) — see "Per-resource splitting" below.
  • docs/SERVARR-API.md — cross-cutting Servarr API reference (auth, paging, command pattern, errors).
  • docs/<app>.md — per-app endpoint catalogue + tool decisions (current tools, candidate read/write tools, out-of-scope, gotchas).
  • docs/specs/<app>.json — version-pinned OpenAPI spec snapshots.
  • Dockerfile — multi-stage build (alpine, non-root)
  • docker-compose.yml — Compose/Portainer deployment using HTTP transport
  • .githooks/pre-commit — gitleaks + PII pattern scan

Read the full file on GitHub · 217 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 217 lines · 2,460 tokens per session scan A 5024b59bed03

Subscribe to this mod's changes

servarr-mcp AGENTS.md is an instructions file published in the GitHub repository CarlDog/servarr-mcp (0 stars, last pushed yesterday), licensed MIT. It adds 2,460 tokens to every session, about $0.0123 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Project management
Related

Other instructions, from other repositories

ESAA-Core AGENTS.md

Instructions for elzobrito/ESAA-Core, covering agents.md — contrato operacional codex/esaa, 1. autoridade e termos, 2. cli e runner, ou configure o runner uma vez por sessão and 3. concorrência.

elzobrito/ESAA-Core · 2,154 tokens

idd-skill idd-resume.instructions.md

Instructions for kurone-kito/idd-skill, covering idd — resume phase, required inputs, step 0 — route classifier, operator-present release and step 1 — identify claim state.

kurone-kito/idd-skill · 3,747 tokens

codecrucible AGENTS.md

Instructions for block/codecrucible, covering agent instructions, quick reference and landing the plane (session completion).

block/codecrucible · 333 tokens

tmetric-minimal-mcp CLAUDE.md

Claude Code instructions for guglielmo/tmetric-minimal-mcp, covering claude.md, development commands, project architecture, file structure and core architecture patterns.

guglielmo/tmetric-minimal-mcp · 780 tokens

shelly-forge CLAUDE.md

Claude Code instructions for mslavov/shelly-forge, covering documentation usage guidelines, critical: framework-first reading order, 📚 mandatory reading order, pre-task protocol and post-task protocol.

mslavov/shelly-forge · 388 tokens

vibelive AGENTS.md

AGENTS.md instructions for pooriaarab/vibelive, covering agents.md, repository context, pull requests, cloud agents (cursor) and install & test.

pooriaarab/vibelive · 589 tokens