Arcane MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LOG_LEVEL | No | debug, info, warn, or error | info |
| ARCANE_API_KEY | No | API key for authentication | |
| ARCANE_BASE_URL | Yes | Your Arcane instance URL | |
| ARCANE_PASSWORD | No | Password (alternative JWT auth) | |
| ARCANE_USERNAME | No | Username (alternative JWT auth) | |
| ARCANE_HTTP_HOST | No | Host for HTTP/network mode | localhost |
| ARCANE_HTTP_PORT | No | Port for HTTP/network mode | 3000 |
| ARCANE_TIMEOUT_MS | No | Request timeout in milliseconds | 30000 |
| ARCANE_TOOL_PRESET | No | commonly-used / read-only / minimal / deploy / full / custom — see Tool Filtering | |
| ARCANE_ENABLED_TOOLS | No | Comma-separated tool names to force-enable | |
| ARCANE_DISABLED_TOOLS | No | Comma-separated tool names to force-disable | |
| ARCANE_ENABLED_MODULES | No | Comma-separated module allowlist | |
| ARCANE_SKIP_SSL_VERIFY | No | Skip SSL cert verification (self-signed certs) | false |
| ARCANE_DEFAULT_ENVIRONMENT_ID | No | Auto-select this environment |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| arcane_auth_loginA | Authenticate with Arcane using username and password. Returns JWT tokens. |
| arcane_auth_logoutA | Log out of the current session and invalidate tokens |
| arcane_auth_meA | Get information about the currently authenticated user |
| arcane_auth_refreshB | Refresh the authentication token using the refresh token |
| arcane_auth_change_passwordB | Change the password for the current user |
| arcane_oidc_get_statusA | Get OIDC configuration status (enabled, provider name, etc.) |
| arcane_oidc_get_configA | Get OIDC client configuration details |
| arcane_oidc_device_codeA | Initiate OIDC device authorization flow. Returns a user code to enter at the verification URL. |
| arcane_environment_listB | List all Docker environments configured in Arcane |
| arcane_environment_getA | Get details of a specific Docker environment |
| arcane_environment_createC | Create a new Docker environment in Arcane |
| arcane_environment_updateC | Update an existing Docker environment |
| arcane_environment_deleteA | [HIGH RISK] Delete a Docker environment from Arcane. This removes the environment configuration but does not affect the actual Docker host. |
| arcane_environment_testC | Test connectivity to a Docker environment |
| arcane_environment_pair_agentA | Generate or rotate the local agent pairing token for an environment |
| arcane_environment_get_versionA | Get the Arcane agent version running on an environment |
| arcane_environment_get_docker_infoA | Get Docker system information for an environment |
| arcane_environment_get_deployment_snippetsA | Get deployment snippets for installing Arcane agent on an environment |
| arcane_container_listB | List Docker containers in an environment with pagination and filtering |
| arcane_container_getB | Get detailed information about a specific container |
| arcane_container_createC | Create a new Docker container |
| arcane_container_startB | Start a stopped container |
| arcane_container_stopA | Stop a running container |
| arcane_container_restartB | Restart a container |
| arcane_container_updateB | Pull the latest image and recreate a container with the same configuration. Automatically pulls latest image before recreating. |
| arcane_container_deleteA | [HIGH RISK] Delete a Docker container permanently. Use force=true to delete running containers, volumes=true to remove associated volumes. |
| arcane_container_redeployB | Redeploy a single container (pull latest image and recreate) |
| arcane_container_set_auto_updateB | Enable or disable automatic updates for a specific container |
| arcane_container_get_countsA | Get container status counts for an environment (running, stopped, etc.) |
| arcane_image_listB | List Docker images in an environment |
| arcane_image_getC | Get detailed information about a Docker image |
| arcane_image_pullB | Pull a Docker image from a registry |
| arcane_image_deleteB | [HIGH RISK] Remove a Docker image from the host |
| arcane_image_pruneA | [HIGH RISK] Remove all unused Docker images. This frees disk space but cannot be undone. |
| arcane_image_get_countsA | Get image counts and size statistics for an environment |
| arcane_image_check_updateB | Check if a newer version of an image is available |
| arcane_image_check_updates_allC | Check for updates on all images in an environment |
| arcane_image_get_update_summaryB | Get a summary of available image updates across all containers |
| arcane_network_listA | List Docker networks in an environment |
| arcane_network_getB | Get detailed information about a Docker network |
| arcane_network_createB | Create a new Docker network |
| arcane_network_deleteA | [HIGH RISK] Delete a Docker network. Connected containers will be disconnected. |
| arcane_network_pruneA | [HIGH RISK] Remove all unused Docker networks. This cannot be undone. |
| arcane_network_get_countsC | Get network counts for an environment |
| arcane_volume_listB | List Docker volumes in an environment |
| arcane_volume_getA | Get detailed information about a Docker volume |
| arcane_volume_createB | Create a new Docker volume |
| arcane_volume_deleteA | [CRITICAL RISK] Permanently delete a Docker volume and ALL its data. This cannot be undone! |
| arcane_volume_pruneA | [CRITICAL RISK] Remove ALL unused Docker volumes and their data. This cannot be undone! |
| arcane_volume_get_countsB | Get volume counts for an environment |
| arcane_volume_browseB | Browse files and directories in a Docker volume |
| arcane_volume_browse_contentA | Read the content of a file in a Docker volume |
| arcane_volume_browse_mkdirB | Create a directory in a Docker volume |
| arcane_volume_backup_listB | List backups for a Docker volume |
| arcane_volume_backup_createC | Create a backup of a Docker volume |
| arcane_volume_backup_deleteC | [HIGH RISK] Delete a volume backup permanently |
| arcane_volume_backup_restoreA | Restore a volume from a backup. This will overwrite existing data in the volume. |
| arcane_volume_backup_list_filesB | List files contained in a volume backup |
| arcane_project_listA | List Docker Compose projects/stacks in an environment |
| arcane_project_getB | Get detailed information about a Docker Compose project |
| arcane_project_createB | Create a new Docker Compose project from a compose file |
| arcane_project_updateC | Update a Docker Compose project configuration |
| arcane_project_upA | Deploy a Docker Compose project (docker-compose up -d). Use arcane_project_pull_images first to pull latest images. |
| arcane_project_downA | Stop and remove containers for a Docker Compose project (docker-compose down). Use arcane_project_destroy to also remove volumes. |
| arcane_project_restartB | Restart all services in a Docker Compose project |
| arcane_project_redeployA | Redeploy a project (down + up). Useful for applying configuration changes. Use arcane_project_pull_images first to pull latest images. |
| arcane_project_destroyA | [CRITICAL RISK] Destroy a project completely, including containers and optionally volumes. This cannot be undone! |
| arcane_project_pull_imagesC | Pull all images for a Docker Compose project |
| arcane_project_get_countsB | Get project status counts for an environment |
| arcane_project_buildB | Build images for a Docker Compose project |
| arcane_gitops_listA | List GitOps sync configurations |
| arcane_gitops_getB | Get details of a GitOps sync configuration |
| arcane_gitops_createB | Create a new GitOps sync configuration |
| arcane_gitops_updateB | Update a GitOps sync configuration |
| arcane_gitops_deleteB | Delete a GitOps sync configuration |
| arcane_gitops_syncB | Trigger a GitOps sync to pull and deploy latest changes from the repository |
| arcane_gitops_get_statusA | Get the current sync status for a GitOps configuration |
| arcane_git_repo_listA | List configured Git repositories |
| arcane_git_repo_createB | Add a new Git repository configuration |
| arcane_git_repo_testB | Test connectivity to a Git repository |
| arcane_git_repo_get_branchesB | List branches in a Git repository |
| arcane_git_repo_browse_filesB | Browse files in a Git repository |
| arcane_git_repo_deleteB | Delete a Git repository configuration |
| arcane_registry_listA | List configured container registries |
| arcane_registry_getA | Get details of a container registry |
| arcane_registry_createB | Add a new container registry configuration |
| arcane_registry_updateB | Update a container registry configuration |
| arcane_registry_deleteA | Delete a container registry configuration |
| arcane_registry_testC | Test connectivity to a container registry |
| arcane_registry_syncA | Sync all container registries to refresh image information |
| arcane_template_listA | List available Docker Compose templates |
| arcane_template_getB | Get details of a Docker Compose template |
| arcane_template_get_contentA | Get the Docker Compose YAML content of a template |
| arcane_template_createB | Create a new Docker Compose template |
| arcane_template_updateA | Update a Docker Compose template |
| arcane_template_deleteA | Delete a Docker Compose template |
| arcane_template_get_variablesA | Get global template variables |
| arcane_template_update_variablesB | Update global template variables |
| arcane_system_get_healthB | Check the health status of the Arcane server |
| arcane_system_get_docker_infoB | Get Docker system information for an environment |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| deploy-stack | Deploy a Docker Compose stack to an environment |
| troubleshoot-container | Diagnose issues with a Docker container |
| security-audit | Run a security audit on an environment |
| cleanup-environment | Clean up unused Docker resources in an environment |
| arcane_configure_tools | Walk through selecting an Arcane tool-filter preset and writing it to ~/.arcane/config.json |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| arcane-environments | Lists all available Arcane environments with IDs and names |
| arcane-version | Returns Arcane MCP server version and configuration info |
| arcane-tools | JSON inventory of every Arcane MCP tool (name, module, enabled) so clients can diff a proposed tool-filter change against the live set |
| arcane-tools-config-notice | Explains tool filtering and points the user at /arcane:configure when the server is running with the unfiltered full tool set |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/RandomSynergy17/Arcane-MCP-Server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server