abdm-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@abdm-mcp Download the large file from https://example.com/data.zip to the downloads folder"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
AB Download Manager MCP Server (abdm-mcp)
MCP server for AB Download Manager. Connects AI coding assistants and autonomous agents (Claude Desktop, OpenAI Codex & ChatGPT, Google Antigravity, Kimi, Cursor, Windsurf, Cline, Zed) to ABDM so they can offload large downloads—model weights, datasets, and archives—with multi-threaded acceleration (up to 32 connections), pause/resume, and queueing instead of choking on single-threaded agent HTTP calls.
Quick Start
Run with uvx (No installation needed)
uvx abdm-mcpNetwork Transports (SSE & HTTP)
# Run with Server-Sent Events (SSE) for remote/containerized agents
uvx abdm-mcp --transport sse --port 8000
# Run with Streamable HTTP
uvx abdm-mcp --transport streamable-http --port 8000Install with pip
pip install abdm-mcp
python -m abdm_mcpRelated MCP server: aria2-agent
Agent Configuration
abdm-mcp complies with the Model Context Protocol standard and works across all major AI coding agents, IDEs, and assistant platforms.
1. Claude Desktop
Add to your claude_desktop_config.json:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"abdm": {
"command": "uvx",
"args": ["abdm-mcp"],
"env": {
"ABDM_MCP_DEFAULT_MODE": "interactive",
"ABDM_API_KEY": "your_api_key_if_configured"
}
}
}
}2. OpenAI Codex & ChatGPT Desktop
Add to ~/.codex/config.toml (global) or .codex/config.toml (project-scoped):
[mcp_servers.abdm]
command = "uvx"
args = ["abdm-mcp"]
env = { "ABDM_MCP_DEFAULT_MODE" = "headless" }Or add via the Codex CLI:
codex mcp add abdm -- uvx abdm-mcp3. Google Antigravity
Add to your workspace or user mcp.json:
{
"mcpServers": {
"abdm": {
"command": "uvx",
"args": ["abdm-mcp"]
}
}
}4. Kimi (Moonshot AI / Kimi CLI)
Add to your Kimi Agent configuration (kimi_mcp.json or agent settings):
{
"mcpServers": {
"abdm": {
"command": "uvx",
"args": ["abdm-mcp"],
"env": {
"ABDM_MCP_DEFAULT_MODE": "headless"
}
}
}
}5. Cursor
Add to your project's .cursor/mcp.json or Cursor Settings > Features > MCP:
{
"mcpServers": {
"abdm": {
"command": "uvx",
"args": ["abdm-mcp"]
}
}
}6. Windsurf (Codeium)
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"abdm": {
"command": "uvx",
"args": ["abdm-mcp"]
}
}
}7. Cline & Roo Code (VS Code)
Open Settings in Cline / Roo Code and add under MCP Servers:
{
"mcpServers": {
"abdm": {
"command": "uvx",
"args": ["abdm-mcp"]
}
}
}8. Zed Editor
Add to ~/.config/zed/settings.json:
{
"context_servers": {
"abdm": {
"command": {
"env": {},
"path": "uvx",
"args": ["abdm-mcp"]
}
}
}
}9. Continue.dev
Add to ~/.continue/config.json:
{
"experimental": {
"modelContextProtocolServers": [
{
"transport": {
"type": "stdio",
"command": "uvx",
"args": ["abdm-mcp"]
}
}
]
}
}10. Goose (Block)
Run the extension add command or add to ~/.config/goose/config.yaml:
goose configure add-extension --name abdm --command uvx --args abdm-mcpTool Surface & Capabilities
All tools return strongly-typed Pydantic schemas and include explicit MCP Tool Annotations:
Tool Name | Parameters | MCP Annotations | Description |
|
|
| Submits an HTTP/HTTPS download task with multi-threaded acceleration. Fails fast if interactive options clash. |
|
|
| Captures and downloads an HLS (.m3u8) video/audio stream with automatic chunk assembly. |
|
|
| Enqueues up to 50 URLs in a batch with partial success tracking. |
| none |
| Fetches configured download queues from ABDM. |
| none |
| Probes REST reachability, authentication, dynamic port discovery, CLI status, and active capabilities. |
|
|
| Lists current downloads reported by ABDM. |
|
|
| Returns status and metadata for a single download task by ID. |
|
|
| Pauses one or more active download tasks by ID. |
|
|
| Resumes one or more paused download tasks by ID. |
| none |
| Pauses all currently active download tasks across ABDM. |
| none |
| Resumes all currently paused download tasks across ABDM. |
|
|
| Cancels and removes one or more download tasks. File deletion requires policy opt-in and path verification. |
Architectural Highlights
Auto-Wake on Demand: If the ABDM desktop client is closed when an agent attempts a download or query,
abdm-mcpautomatically launches the GUI viaabdm gui start-if-not-started.Dynamic Port Auto-Discovery: Automatically queries the active Ktor integration port via
abdm gui integration show, preventing failure if ABDM is configured with an alternate port.Resilient ANSI-Safe Parsing: Mordant color formatting and Unicode/ASCII table borders are safely normalized during CLI state inspection.
Zero-Port Setup over Stdio: Runs seamlessly out of the box via
uvx abdm-mcpwithout firewall warnings or localhost port conflicts.
Security & Sandboxing Guardrails
Autonomous agents are powerful, but should not have unrestricted filesystem or network write access. abdm-mcp implements defense-in-depth:
Path Sandboxing: By default, headless downloads are strictly confined to
~/Downloads/ABDM. Path traversal escapes (../) and absolute paths outside allowed roots are rejected.Private-Network URL Guard: Protects against SSRF by rejecting direct requests to
localhost,127.0.0.0/8,::1, RFC1918 LAN subnets (10.0.0.0/8,172.16.0.0/12,192.168.0.0/16), and link-local metadata endpoints (169.254.169.254).Filename Sanitization: Rejects slashes, drive prefixes, control characters, and reserved Windows device names (
CON,PRN,AUX,NUL, etc.).Header Protection: Blocks sensitive headers (
Cookie,Authorization,Proxy-Authorization,Host) by default to prevent credential leakage.Safe Subprocess Execution: The CLI backend strictly uses
asyncio.create_subprocess_exec(nevershell=True) with bounded streaming readers (1MB limit) and hard execution timeouts.
Environment Variables
Variable | Default | Description |
|
| Custom or portable configuration directory path. |
|
| Default port of the ABDM local integration server (overridden by dynamic discovery). |
| None | Optional authentication key configured in ABDM. |
| Auto-detected | Explicit path to |
|
| Automatically wakes the ABDM desktop process on demand if offline. |
|
| Queries |
|
| Default mode: |
|
| Comma-separated list of allowed download directories. |
|
| Set to |
|
| Set to |
|
| Set to |
|
| Maximum URLs accepted in a single |
Development & Testing
# Clone the repository
git clone https://github.com/shivamtawari/ab-download-manager-mcp.git
cd ab-download-manager-mcp
# Install dependencies with uv
uv sync --all-groups
# Run full test suite
uv run pytest tests/
# Run linting
uv run ruff check .License
MIT License. See LICENSE for details.
Available Tools
12 toolsabdm_check_statusARead-onlyIdempotent
Inspect reachability, authentication, port discovery, and capabilities.
Inputs: no named parameters. Returns: Health and capability report of the connected AB Download Manager system.
abdm_downloadA
Submit an HTTP/HTTPS download task to AB Download Manager with multi-threaded acceleration. In 'interactive' mode, triggers the desktop confirmation GUI. In 'headless' mode, starts silent background download into allowed sandboxed folder.
Inputs: url (required), mode, headers, filename, +6 more. Returns: Result of submitting a download request.
abdm_download_batchA
Enqueue up to 50 URLs in a batch with per-item status tracking.
Inputs: urls (required), mode, queue_id. Returns: Summary result of submitting a batch of download requests.
abdm_download_hlsA
Download an HLS (.m3u8) streaming video/audio task with segment reassembly. In 'interactive' mode, triggers the desktop confirmation GUI. In 'headless' mode, starts silent background download into allowed sandboxed folder.
Inputs: url (required), mode, headers, filename, +6 more. Returns: Result of submitting a download request.
abdm_get_downloadARead-onlyIdempotent
Fetch detailed metadata for a single download task by ID.
Inputs: download_id (required). Returns: Detailed information about an individual download task.
abdm_get_queuesARead-onlyIdempotent
List all configured download queues in AB Download Manager.
Inputs: no named parameters. Returns: result
abdm_list_downloadsBRead-onlyIdempotent
List downloads currently tracked by AB Download Manager.
Inputs: status. Returns: List of downloads currently reported by the system.
abdm_pauseAIdempotent
Pause one or more active download tasks by ID.
Inputs: download_id (required). Returns: Result of an action performed on download task(s) (pause, resume, remove).
abdm_pause_allAIdempotent
Pause all currently active download tasks across AB Download Manager.
Inputs: no named parameters. Returns: Result of an action performed on download task(s) (pause, resume, remove).
abdm_removeADestructiveIdempotent
Remove/cancel one or more download tasks. File deletion requires explicit policy opt-in (ABDM_MCP_ALLOW_FILE_DELETION=true) and path verification.
Inputs: download_id (required), delete_file. Returns: Result of an action performed on download task(s) (pause, resume, remove).
abdm_resumeAIdempotent
Resume one or more paused download tasks by ID.
Inputs: download_id (required). Returns: Result of an action performed on download task(s) (pause, resume, remove).
abdm_resume_allAIdempotent
Resume all currently paused download tasks across AB Download Manager.
Inputs: no named parameters. Returns: Result of an action performed on download task(s) (pause, resume, remove).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Each tool targets a distinct action or resource: download submission (HTTP, HLS, batch), task inspection, lifecycle controls (pause/resume/remove), and server status. Single vs. all pause/resume variants are clearly separated by the '_all' suffix.
All tools share the 'abdm_' prefix and use snake_case, with mostly clear verb_noun naming. Minor deviations: 'abdm_download' and 'abdm_pause' omit explicit objects while related batch/all variants include suffixes.
12 tools is well-scoped for a download manager MCP server, covering submission, listing, status, and lifecycle actions without unnecessary surface area. Every tool corresponds to a meaningful operation.
The download task lifecycle is well covered: create via download/HLS/batch, read via list/get, pause/resume/remove. Queue support is read-only (only get_queues) and there is no explicit update/options editing, which is a minor gap.
Maintenance
Related MCP Connectors
Let your AI agent build, preview and update web apps, download source and publish when you allow it.
Your AI agent is smart enough to code all day. Local firewall & zero-loss runtime.
Governed app access for AI agents: 1,000+ apps & 12,000+ tools via Code Mode MCP.
Run AI agent tasks in isolated sandboxes with a cost cap, saved workflows and scoped connections.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI models to manage file downloads with multi-threading, progress monitoring, and task control through standardized MCP interfaces.8ISC
- AlicenseNot gradedqualityAmaintenanceA download tool for AI agents that wraps aria2 with safety rules and MCP server support, enabling reliable downloads without false positives.1MIT

Praxis Liteofficial
AlicenseAqualityBmaintenanceEnables AI agents to safely interact with local files by enforcing policies that allow, block, or require approval for actions, while protecting credentials and maintaining a tamper-proof audit log.122MIT- AlicenseAqualityBmaintenanceEnables AI agents and CLI tools to dispatch downloads through Chrome's native download engine over the MCP protocol, automatically inheriting browser cookies, login sessions, and proxy settings. Supports submitting, monitoring, pausing, resuming, and cancelling download tasks locally without manual server setup.8MIT