Skip to content
rDownloader
GitHubDownload

MCP and API

Built for humans. Ready for automation.

Use the installable web interface, script the CLI or the REST/SSE API, connect media clients through compatibility adapters, or give an MCP client access.

An AI assistant drives rDownloader through the built-in MCP server: a magnet link, a YouTube video, an NZB and a direct link land in one queue, then it asks for the progress.

Give your MCP client a download queue

Built-in tools reach the queue, LinkGrabber, logs and settings, with the same permissions as the REST API, and no tool ever hands out a secret.

Integrate against a documented contract

JSON endpoints under /api/v1, an OpenAPI document for generated clients, live changes through Server-Sent Events and a remote CLI for scripts.

Connect media automation without replacing the native API

SABnzbd and BitTorrent compatibility connects Sonarr, Radarr and similar tools; an aria2 adapter, off by default, serves AriaNg.

Explore MCP →Read the API docs →

Monitoring

Watch it from your own Grafana.

rDownloader exposes queue, transfers, providers and free space at /api/v1/metrics. A metrics token reaches that one route and nothing else.

Grafana — rDownloader
The rDownloader dashboard in Grafana during a stretch of demo downloads: version, uptime, waiting downloads, active runners, transfer rate and blocked hosts, then the transfer rate by kind and the queue by state.
The rDownloader dashboard in Grafana during a stretch of demo downloads: version, uptime, waiting downloads, active runners, transfer rate and blocked hosts, then the transfer rate by kind and the queue by state.

Scrape it with Prometheus

Every figure comes from the database at scrape time, so counters survive restarts. Labels never hold a URL, file name or user name.

Import the ready dashboard

A ready Grafana dashboard ships with the repository: queue, throughput, retries, wait times and free space, for one or several installations.

Prometheus target health: the rdownloader job scrapes /api/v1/metrics and is up.
Prometheus target health: the rdownloader job scrapes /api/v1/metrics and is up.
Prometheus graph of rdownloader_transfer_rate_bytes_per_second over the same stretch.
Prometheus graph of rdownloader_transfer_rate_bytes_per_second over the same stretch.
Set up monitoring →

Browser extension

Capture in the browser.

Browser extension

Chromium browsers and Firefox

Context actions, download interception, captchas and Click'n'Load where no desktop agent answers, for the sites you allow — DE / EN / FR / ES. Chrome installs the extension from the Chrome Web Store, Edge from Edge Add-ons, Firefox from Firefox Add-ons; updates arrive automatically. Guide in the wiki

ChromeWeb StoreEdgeAdd-onsFirefoxAdd-ons