arcane-mcp
Provides tools for managing Docker resources (containers, images, volumes, networks, Compose projects, registries, etc.) via the Arcane API.
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., "@arcane-mcp list all running containers in my environment"
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.
arcane-mcp
An MCP server that exposes Arcane Docker management capabilities to AI agents via the Model Context Protocol. Built with FastMCP.
Covers the core Docker management API: containers, images, volumes, networks, Compose projects, registries, vulnerability scanning, port mappings, webhooks, system management, updater, activities/events, and environment management.
125 tools across 14 modules.
Install
Not on PyPI. Install directly from GitHub:
# pip
pip install git+https://github.com/MikeCase/arcane-mcp.git
# uv
uv tool install git+https://github.com/MikeCase/arcane-mcp.git
# or clone and install locally
git clone https://github.com/MikeCase/arcane-mcp.git
cd arcane-mcp
uv syncRelated MCP server: MCP Dockhand
Configuration
Set these environment variables (or put them in a .env file in the working directory):
ARCANE_API_KEY=arc_your_api_key_here
ARCANE_BASE_URL=http://localhost:3552OpenCode
Add to your opencode.json:
{
"mcp": {
"arcane-docker": {
"type": "local",
"command": ["arcane-mcp"],
"env": {
"ARCANE_API_KEY": "arc_your_key_here",
"ARCANE_BASE_URL": "http://localhost:3552"
}
}
}
}Or set environment variables globally and omit them from the config.
Tools (125 total)
Containers (18)
list_containers, inspect_container, create_container, start_container, stop_container, restart_container, kill_container, pause_container, unpause_container, remove_container, redeploy_container, commit_container, update_container, set_container_auto_update, exec_in_container, get_container_logs, get_container_stats, get_container_counts
Images (19)
list_images, inspect_image, pull_image, remove_image, tag_image, prune_images, get_image_counts, build_image, search_images, upload_image, get_image_history, get_image_export, get_image_attestations, scan_image_vulnerabilities, get_image_vulnerabilities, get_vulnerability_summary, check_image_update, check_all_image_updates, get_image_update_summary
Volumes (18)
list_volumes, create_volume, inspect_volume, remove_volume, prune_volumes, get_volume_counts, get_volume_sizes, get_volume_usage, list_volume_backups, create_volume_backup, restore_volume_backup, delete_volume_backup, download_volume_backup, browse_volume, read_volume_file, create_volume_directory, upload_to_volume, delete_volume_file
Projects / Compose (17)
list_projects, get_project, deploy_project, redeploy_project, remove_project, update_project, get_project_counts, project_down, restart_project, build_project, archive_project, unarchive_project, pull_project_images, get_project_compose, get_project_file, update_project_services, get_project_runtime
Networks (9)
list_networks, create_network, inspect_network, remove_network, connect_container_to_network, disconnect_container_from_network, prune_networks, get_network_counts, get_network_topology
Environments (5)
list_environments, get_environment, create_environment, update_environment, remove_environment
System (9)
get_docker_info, get_docker_version, prune_system, get_system_health, check_system_upgrade, trigger_upgrade, start_all_containers, start_stopped_containers, stop_all_containers
Activities & Events (7)
list_activities, get_activity, cancel_activity, clear_activity_history, list_events, get_environment_events, delete_event
Container Registries (6)
list_registries, create_registry, get_registry, update_registry, delete_registry, test_registry
Vulnerabilities (6)
get_vulnerability_summary_all, list_all_vulnerabilities, ignore_vulnerability, list_ignored_vulnerabilities, unignore_vulnerability, get_scanner_status
Webhooks (5)
trigger_webhook, list_webhooks, create_webhook, update_webhook, delete_webhook
Updater (3)
run_updater, get_updater_status, get_updater_history
Ports (1)
list_ports
Operations / Safety (2)
confirm_operation, read_audit_log
Usage
All resource tools accept env_id: str = "0" to target a specific Arcane environment (local Docker is "0", remote agents use UUIDs). Remote agent operations can pass agent_token: str | None for authentication via the X-Arcane-Agent-Token header.
Safety
Destructive operations use a three-layer safety system:
1. Confirmation tokens (two-step handshake)
Every tool that removes, prunes, kills, restores, or overwrites returns a short-lived confirmation_token instead of executing. The agent must call confirm_operation(token) as a separate tool call to proceed. Tokens expire after 120 seconds.
remove_container("my-app")
→ {"warning": "...", "confirmation_token": "a1b2c3d4e5f6", "target": "my-app"}
confirm_operation(token="a1b2c3d4e5f6")
→ {"success": true, ...}This prevents an agent from blasting through a safety gate in one call — it must stop, process the warning, and make a second call.
2. Dry-run mode (prune/cleanup tools)
Prune operations (prune_images, prune_volumes, prune_networks, prune_system, clear_activity_history) default to dry_run=True, showing what would be affected without making changes:
prune_images()
→ {"dry_run": true, "warning": "Dry-run. Set dry_run=False to proceed.", "target": "all"}
prune_images(dry_run=False)
→ {"warning": "...", "confirmation_token": "..."}3. Audit log
Every confirmed destructive operation is recorded to a structured JSON-lines audit log. Read it anytime:
read_audit_log(lines=10)
→ [{"timestamp": "2026-06-29T...", "action": "remove_container", "target": "my-app", "env_id": "0"}]Set ARCANE_MCP_AUDIT_LOG environment variable to change the log file path (default: ~/.arcane-mcp-audit.log).
Development
git clone https://github.com/MikeCase/arcane-mcp.git
cd arcane-mcp
uv sync
uv run fastmcp run src/arcane_mcp/server.pyLicense
MIT
Available Tools
127 toolsarchive_projectC
Archive a Compose project.
Inputs: project_id (required), env_id, agent_token.
browse_volumeC
List files and directories at a path inside a volume.
Inputs: name (required), path, env_id, agent_token.
build_imageC
Build an image from Dockerfile content.
Inputs: dockerfile_content (required), tag, env_id, agent_token.
build_projectC
Build a Compose project's images.
Inputs: project_id (required), env_id, agent_token.
cancel_activityC
Cancel a running background activity.
Inputs: activity_id (required), env_id, agent_token.
check_all_image_updatesC
Check for updates on all images in the environment.
Inputs: env_id, agent_token.
check_image_updateC
Check if a newer version of an image is available by reference.
Inputs: reference (required), env_id, agent_token.
check_system_upgradeB
Check if a system upgrade is available for the given environment.
Inputs: env_id, agent_token.
classify_toolD
Return the classification label for a given tool classification value.
Inputs: action (required), classification.
clear_activity_historyC
Clear activity history for an environment. Requires confirmation via confirmation_token.
Inputs: env_id, dry_run, agent_token.
commit_containerC
Commit a container's current state to a new image.
Inputs: container_id (required), tag, repo, env_id, +1 more.
confirm_operationA
Confirm and execute a destructive operation.
Provide the confirmation_token that the earlier destructive tool
call returned, and optionally the operation_hash for strongest
safety. The token expires after 120 seconds.
When operation_hash is provided it MUST match the hash returned
by the destructive tool. This prevents a token obtained for
remove_container("my-app")from being used to execute
remove_container("other-app").If the target resource supports it, the server will also check whether the resource has changed since the token was issued. If it has, the confirmation is denied.
Inputs: token (required), operation_hash.
connect_container_to_networkC
Connect a container to a network.
Inputs: network_id (required), container_id (required), env_id, agent_token.
create_containerB
Create and optionally start a container. Command is a string that will be split into an array (e.g. 'sleep 60' becomes ['sleep', '60']). For the raw array form use the JSON format for env/labels.
Inputs: name (required), image (required), env, env_id, +3 more.
create_environmentC
Register a new remote agent environment.
Inputs: name (required), api_url (required), agent_token (required).
create_networkC
Create a new network in the given environment.
Inputs: name (required), driver, env_id, agent_token.
create_registryC
Create a new container registry.
Inputs: url (required), name (required), env_id, password, +2 more.
create_volumeC
Create a new volume in the given environment.
Inputs: name (required), driver, env_id, labels, +1 more.
create_volume_backupC
Create a new backup of a volume.
Inputs: name (required), env_id, agent_token.
create_volume_directoryC
Create a directory inside a volume.
Inputs: name (required), path (required), env_id, agent_token.
create_webhookC
Create a new webhook in the given environment.
Inputs: url (required), name (required), env_id, agent_token.
delete_eventC
Delete a system event. Requires confirmation via confirmation_token.
Inputs: event_id (required), agent_token.
delete_registryA
Delete a container registry. Requires confirmation via confirmation_token.
Inputs: registry_id (required), env_id, agent_token.
delete_volume_backupA
Delete a volume backup. Destructive; requires confirmation token.
Inputs: backup_id (required), env_id, agent_token.
delete_volume_fileC
Delete a file or directory inside a volume. Destructive; requires confirmation token.
Inputs: name (required), path (required), env_id, agent_token.
delete_webhookA
Delete a webhook. Destructive; requires confirmation via confirmation_token.
Inputs: webhook_id (required), env_id, agent_token.
deploy_projectC
Deploy a new Compose project from compose content.
Inputs: project_name (required), compose_content (required), env_id, agent_token.
disconnect_container_from_networkC
Disconnect a container from a network.
Inputs: network_id (required), container_id (required), env_id, agent_token.
download_volume_backupC
Download a volume backup.
Inputs: backup_id (required), env_id, agent_token.
exec_in_containerB
Execute a command inside a running container. NOTE: The Arcane API does not expose a container exec endpoint. This tool will attempt to use SSH as a fallback if available, otherwise returns an error.
Inputs: command (required), container_id (required), env_id, agent_token.
get_activityC
Get a specific background activity.
Inputs: activity_id (required), env_id, agent_token.
get_container_countsC
Get container counts by status (running, stopped, paused, etc.).
Inputs: env_id, agent_token.
get_container_logsB
Fetch logs from a container. NOTE: The Arcane API may not expose a direct logs endpoint. If 404 is returned, use SSH to the Docker host as workaround.
Inputs: container_id (required), tail, env_id, agent_token.
get_container_statsB
Get live resource usage stats for a container. NOTE: The Arcane API may not expose a stats endpoint. If 404 is returned, use SSH to the Docker host as workaround.
Inputs: container_id (required), env_id, agent_token.
get_docker_infoC
Get Docker system information for the given environment.
Inputs: env_id, agent_token.
get_docker_versionC
Get Docker version for the given environment.
Inputs: env_id, agent_token.
get_environmentC
Get details of a specific environment.
Inputs: env_id (required).
get_environment_eventsC
Get events for a specific environment.
Inputs: environment_id (required), agent_token.
get_image_attestationsC
Get attestations for an image.
Inputs: name (required), env_id, agent_token.
get_image_countsC
Get image count statistics for the environment.
Inputs: env_id, agent_token.
get_image_exportB
Export an image by name (download its tar archive).
Inputs: name (required), env_id, agent_token.
get_image_historyC
Get the build history for an image.
Inputs: image_id (required), env_id, agent_token.
get_image_update_summaryC
Get a summary of available image updates.
Inputs: env_id, agent_token.
get_image_vulnerabilitiesC
Get vulnerability report for an image.
Inputs: image_id (required), env_id, agent_token.
get_network_countsC
Get network counts for the given environment.
Inputs: env_id, agent_token.
get_network_topologyC
Get network topology for the given environment.
Inputs: env_id, agent_token.
get_operation_statusA
Check whether a confirmation token is still valid without consuming it.
Returns the operation details (minus sensitive fields) or an error if the token is invalid or expired.
Inputs: token (required).
get_projectC
Get details of a specific Compose project.
Inputs: project_id (required), env_id, agent_token.
get_project_composeC
Get the Compose file content for a project.
Inputs: project_id (required), env_id, agent_token.
get_project_countsC
Get counts of Compose projects in the given environment.
Inputs: env_id, agent_token.
get_project_fileC
Get the project file content for a Compose project.
Inputs: project_id (required), env_id, agent_token.
get_project_runtimeC
Get the runtime info for a Compose project.
Inputs: project_id (required), env_id, agent_token.
get_registryB
Get a container registry by ID.
Inputs: registry_id (required), env_id, agent_token.
get_scanner_statusC
Get vulnerability scanner (Trivy) status.
Inputs: env_id, agent_token.
get_system_healthC
Get system health metrics for the given environment.
Inputs: env_id, agent_token.
get_updater_historyC
Get updater operation history.
Inputs: env_id, agent_token.
get_updater_statusC
Get the current updater status.
Inputs: env_id, agent_token.
get_volume_countsC
Get volume counts for the given environment.
Inputs: env_id, agent_token.
get_volume_sizesC
Get volume sizes for the given environment.
Inputs: env_id, agent_token.
get_volume_usageC
Get disk usage for a specific volume.
Inputs: name (required), env_id, agent_token.
get_vulnerability_summaryC
Get a summary of vulnerabilities for an image.
Inputs: image_id (required), env_id, agent_token.
get_vulnerability_summary_allC
Get vulnerability summary across all scanned images.
Inputs: env_id, agent_token.
ignore_vulnerabilityC
Ignore a specific vulnerability by URN.
Inputs: urn (required), env_id, agent_token.
inspect_containerC
Get detailed information about a specific container.
Inputs: container_id (required), env_id, agent_token.
inspect_imageC
Inspect image by id.
Inputs: image_id (required), env_id, agent_token.
inspect_networkC
Inspect a specific network.
Inputs: network_id (required), env_id, agent_token.
inspect_volumeC
Inspect a volume by name.
Inputs: name (required), env_id, agent_token.
kill_containerC
Force-kill a running container. Requires confirmation token to execute.
Inputs: container_id (required), env_id, agent_token.
list_activitiesB
List current and recent background activities for an environment.
Inputs: env_id, agent_token.
list_all_vulnerabilitiesC
List all vulnerabilities across the environment.
Inputs: env_id, agent_token.
list_containersC
List containers for a given Arcane environment.
Inputs: all, env_id, agent_token.
list_environmentsA
List all environments (local + remote agents).
Inputs: no named parameters.
list_eventsC
List system events (paginated, across all environments).
Inputs: agent_token.
list_ignored_vulnerabilitiesC
List all ignored vulnerabilities.
Inputs: env_id, agent_token.
list_imagesC
List all images in the given environment.
Inputs: env_id, agent_token.
list_networksA
List all networks in the given environment.
Inputs: env_id, agent_token.
list_portsC
List all port mappings for the given environment.
Inputs: env_id, agent_token.
list_projectsB
List all Compose projects in the given environment.
Inputs: env_id, agent_token.
list_registriesC
List all container registries.
Inputs: env_id, agent_token.
list_volume_backupsC
List all backups for a volume.
Inputs: name (required), env_id, agent_token.
list_volumesC
List all volumes in the given environment.
Inputs: env_id, agent_token.
list_webhooksC
List all webhooks for the given environment.
Inputs: env_id, agent_token.
pause_containerB
Pause a running container (freeze its processes).
Inputs: container_id (required), env_id, agent_token.
project_downC
Take a Compose project down (stop and remove containers).
Inputs: project_id (required), env_id, agent_token.
prune_imagesA
Prune unused Docker images. Destructive; use dry_run=False and confirmation token to execute.
When dry_run=True (default), returns a dry-run warning without creating a confirmation token. Set dry_run=False to get a confirmation token for execution.
Inputs: env_id, dry_run, agent_token.
prune_networksA
Prune unused Docker networks. Destructive; use dry_run=False and confirm to execute.
Inputs: env_id, dry_run, agent_token.
prune_systemA
Prune system resources for the given environment. Select what to prune via flags (containers, images, volumes, networks, build_cache). Volumes default to False. Use dry_run=True (default) to preview what would be pruned without making changes.
Inputs: env_id, images, dry_run, volumes, +4 more.
prune_volumesC
Prune unused Docker volumes. Destructive; use dry_run=False and confirm to execute.
Inputs: env_id, dry_run, agent_token.
pull_imageC
Pull image from registry into environment.
Inputs: repository (required), tag, env_id, agent_token.
pull_project_imagesC
Pull images for a Compose project.
Inputs: project_id (required), env_id, agent_token.
read_audit_logC
Read the last N lines of the audit log for destructive operations.
Inputs: lines, event_type.
read_volume_fileC
Read the contents of a file inside a volume.
Inputs: name (required), path (required), env_id, agent_token.
redeploy_containerC
Redeploy a container using its original image and configuration.
Inputs: container_id (required), env_id, agent_token.
redeploy_projectC
Redeploy a Compose project.
Inputs: project_id (required), env_id, agent_token.
remove_containerC
Remove a container. Requires confirmation token to execute.
Inputs: container_id (required), force, env_id, agent_token.
remove_environmentC
Remove an environment. Requires confirmation via confirmation_token.
Inputs: env_id (required).
remove_imageC
Remove image by id. Requires confirmation token to execute.
Inputs: image_id (required), force, env_id, agent_token.
remove_networkC
Remove a network. Destructive; requires confirmation token.
Inputs: network_id (required), env_id, agent_token.
remove_projectC
Remove a Compose project.
Inputs: project_id (required), env_id, agent_token.
remove_volumeB
Remove a volume by name. Destructive; requires confirmation token.
Inputs: name (required), force, env_id, agent_token.
restart_containerC
Restart a running container.
Inputs: container_id (required), env_id, timeout, agent_token.
restart_projectC
Restart a Compose project.
Inputs: project_id (required), env_id, agent_token.
restore_volume_backupB
Restore a volume backup. Destructive; requires confirmation token.
Inputs: backup_id (required), volume_name (required), env_id, agent_token.
run_updaterC
Run the updater to apply pending container updates. Requires confirmation via confirmation_token.
Inputs: env_id, agent_token.
scan_image_vulnerabilitiesC
Trigger a vulnerability scan on an image.
Inputs: image_id (required), env_id, agent_token.
search_imagesC
Search images by name/query in the environment.
Inputs: query (required), env_id, agent_token.
set_container_auto_updateC
Enable or disable automatic updates for a container.
Inputs: enabled (required), container_id (required), env_id, agent_token.
start_all_containersC
Start all stopped containers for the given environment.
Inputs: env_id, agent_token.
start_containerC
Start a stopped container.
Inputs: container_id (required), env_id, agent_token.
start_stopped_containersB
Start only containers that are currently stopped for the given environment.
Inputs: env_id, agent_token.
stop_all_containersC
Stop all running containers for the given environment.
Inputs: env_id, agent_token.
stop_containerC
Stop a running container gracefully.
Inputs: container_id (required), env_id, timeout, agent_token.
tag_imageC
Tag an existing image with a new repository name.
Inputs: source (required), target (required), env_id, agent_token.
test_registryC
Test connectivity to a container registry.
Inputs: registry_id (required), env_id, agent_token.
trigger_upgradeC
Trigger a system upgrade for the given environment.
Inputs: env_id, agent_token.
trigger_webhookC
Trigger an Arcane inbound webhook by token.
Inputs: token (required), action (required).
unarchive_projectC
Unarchive a Compose project.
Inputs: project_id (required), env_id, agent_token.
unignore_vulnerabilityB
Un-ignore a previously ignored vulnerability. Requires confirmation via confirmation_token.
Inputs: ignore_id (required), env_id, agent_token.
unpause_containerC
Unpause a paused container.
Inputs: container_id (required), env_id, agent_token.
update_containerB
Update a container's configuration (e.g. after image or resource changes).
Inputs: container_id (required), env_id, agent_token.
update_environmentA
Update environment settings (name, API URL, or access token).
Inputs: env_id (required), name, api_url, agent_token.
update_projectC
Update a Compose project's configuration.
Inputs: project_id (required), env_id, agent_token, project_name, +1 more.
update_project_servicesC
Update services of a Compose project from the current compose config.
Inputs: project_id (required), env_id, agent_token.
update_registryC
Update a container registry.
Inputs: registry_id (required), url, name, env_id, +3 more.
update_webhookC
Enable or disable a webhook.
Inputs: enabled (required), webhook_id (required), env_id, agent_token.
upload_imageC
Upload an image to the environment.
Note: This tool calls the upload endpoint but does NOT handle multipart file uploads. Use a direct API client (curl, Postman) with a multipart/form-data request for actual file uploads.
Inputs: env_id, agent_token.
upload_to_volumeC
Upload a file to a path inside a volume.
Inputs: name (required), path (required), content (required), env_id, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 127 tools
Despite the large number of tools, each tool clearly targets a specific resource and action (e.g., create_container vs. create_network). Descriptions further clarify intent. A few close pairs like check_image_update vs. check_all_image_updates exist but are distinguishable by scope.
All tools use consistent snake_case with a verb_noun pattern (e.g., list_containers, start_container, prune_images). No mixing of conventions, making the naming predictable and easy to navigate.
With 127 tools, the set is extremely large. While the server covers a broad domain (Docker management), the sheer number overwhelms typical agent decision-making and far exceeds the recommended range.
The tool surface covers nearly all aspects of Docker management: containers, images, volumes, networks, Compose projects, registries, webhooks, environments, vulnerabilities, and system operations. CRUD and lifecycle management are present for each resource, with only minor limitations noted (e.g., exec fallback).
Maintenance
Related MCP Connectors
A registry of AI agent tools — MCP servers, APIs, CLIs, SDKs — kept current by automated ingestion.
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
Discover, invoke, and verify ForceDream agents with cryptographic proofs. 14 local, 21 hosted tools.
Discover, inspect and run 63,000+ agent tools from one balance. Pay per call, no subscriptions.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Docker containers, images, networks, volumes, and Compose services through the Model Context Protocol. It supports system operations, command execution within containers, and integration with Docker Hub and GitHub Container Registry.167 npm2MIT
- AlicenseNot gradedqualityAmaintenanceExposes over 130 Dockhand API endpoints as tools to manage Docker infrastructure through AI assistants. It enables comprehensive control over containers, stacks, networks, and volumes across multiple environments and hosts.71MIT
- AlicenseNot gradedqualityDmaintenanceProvides Docker management tools for AI agents, including inspecting containers, images, Dockerfiles, and Compose configurations.62 npm1MIT
- AlicenseNot gradedqualityDmaintenanceEnables managing Docker environments through Arcane via natural language, providing tools for containers, images, volumes, networks, and Docker Compose stacks.MIT