aria2-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ARIA2_RPC_URL | Yes | Full JSON-RPC endpoint, e.g. http://127.0.0.1:6800/jsonrpc. Must use http or https and must not embed credentials. | |
| ARIA2_RPC_SECRET | No | Value passed to --rpc-secret; both secret and token:secret are accepted. | |
| ARIA2_TIMEOUT_MS | No | Per-request timeout in milliseconds. | 30000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| aria2_add_uriA | Queue one or more download URIs (HTTP, HTTPS, FTP, SFTP or magnet links) and return the new GID. |
| aria2_listA | List downloads by state. |
| aria2_statusA | Return the full status record of a single download. |
| aria2_pauseB | Pause an active or waiting download. |
| aria2_unpauseC | Resume a paused download. |
| aria2_removeB | Remove a download and purge its result entry. Set |
| aria2_global_statB | Return aggregate download and upload speeds plus queue counters. |
| aria2_get_versionA | Return the aria2 version and the features it was built with. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 8 tools
Each tool targets a distinct aria2 operation: add, remove, pause, unpause, list, status, global_stat, and get_version. Collection vs. single-download vs. aggregate reporting tools are clearly separated by their descriptions.
All tools share the aria2_ prefix and snake_case formatting, which is highly consistent. However, the verb/noun pattern is mixed: some are verbs (remove, pause, unpause, list), some are noun-only (status, global_stat), and some are verb_noun (add_uri, get_version).
Eight tools is well-scoped for an aria2 download management server. Each tool covers a core, non-redundant operation without excessive surface area.
The surface covers the core download lifecycle: add, pause, resume, remove, and query status/list/aggregate stats. Minor gaps exist for update/configuration operations (e.g., changing download or global options, session management) that agents could work around or that may be out of scope.