Docker

Docker MCP Server for Cloudflare Workers

Available Tools

96 tools available in the Docker MCP server. Each tool can be called by AI assistants to perform specific actions.

docker_start_container

Start a stopped container.

Args:

id: Container ID or name

Returns: Confirmation of start.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Container ID or name"
    }
  }
}

docker_list_containers

List Docker containers.

Returns a list of containers. By default only running containers are shown.

Args:

all: Show all containers (default shows just running)
limit: Maximum number of containers to return
format: Response format ('json' or 'markdown')

Returns: List of containers with ID, names, image, status, state, and ports.

{
  "type": "object",
  "properties": {
    "all": {
      "type": "boolean",
      "default": false,
      "description": "Show all containers (default shows just running)"
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Maximum number to return"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

docker_inspect_container

Get detailed information about a container.

Args:

id: Container ID or name
format: Response format ('json' or 'markdown')

Returns: Detailed container configuration and state.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Container ID or name"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

docker_create_container

Create a new container.

Args:

image: Image to use (required)
name: Container name
cmd: Command to run
env: Environment variables (array of KEY=VALUE)
ports: Port mappings (e.g., {"80/tcp": [{"HostPort": "8080"}]})
volumes: Volume bindings (e.g., ["/host/path:/container/path"])
workingDir: Working directory inside container
hostname: Container hostname
user: User to run as
tty: Allocate a TTY
labels: Container labels

Returns: Created container ID and any warnings.

{
  "type": "object",
  "required": [
    "image"
  ],
  "properties": {
    "cmd": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Command to run"
    },
    "env": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Environment variables (KEY=VALUE)"
    },
    "tty": {
      "type": "boolean",
      "description": "Allocate TTY"
    },
    "name": {
      "type": "string",
      "description": "Container name"
    },
    "user": {
      "type": "string",
      "description": "User to run as"
    },
    "image": {
      "type": "string",
      "description": "Image to use"
    },
    "ports": {
      "type": "object",
      "description": "Port mappings"
    },
    "labels": {
      "type": "object",
      "description": "Container labels"
    },
    "volumes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Volume bindings"
    },
    "hostname": {
      "type": "string",
      "description": "Container hostname"
    },
    "workingDir": {
      "type": "string",
      "description": "Working directory"
    }
  }
}

docker_stop_container

Stop a running container.

Args:

id: Container ID or name
timeout: Seconds to wait before killing (default: 10)

Returns: Confirmation of stop.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Container ID or name"
    },
    "timeout": {
      "type": "integer",
      "default": 10,
      "minimum": 0,
      "description": "Seconds to wait before killing"
    }
  }
}

docker_restart_container

Restart a container.

Args:

id: Container ID or name
timeout: Seconds to wait before killing (default: 10)

Returns: Confirmation of restart.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Container ID or name"
    },
    "timeout": {
      "type": "integer",
      "default": 10,
      "minimum": 0,
      "description": "Seconds to wait before killing"
    }
  }
}

docker_kill_container

Kill a running container (send signal).

Args:

id: Container ID or name
signal: Signal to send (default: SIGKILL)

Returns: Confirmation of kill.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Container ID or name"
    },
    "signal": {
      "type": "string",
      "default": "SIGKILL",
      "description": "Signal to send"
    }
  }
}

docker_pause_container

Pause a running container.

Args:

id: Container ID or name

Returns: Confirmation of pause.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Container ID or name"
    }
  }
}

docker_unpause_container

Unpause a paused container.

Args:

id: Container ID or name

Returns: Confirmation of unpause.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Container ID or name"
    }
  }
}

docker_remove_container

Remove a container.

Args:

id: Container ID or name
force: Force removal of running container
removeVolumes: Remove associated volumes

Returns: Confirmation of removal.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Container ID or name"
    },
    "force": {
      "type": "boolean",
      "default": false,
      "description": "Force removal of running container"
    },
    "removeVolumes": {
      "type": "boolean",
      "default": false,
      "description": "Remove associated volumes"
    }
  }
}

docker_rename_container

Rename a container.

Args:

id: Container ID or name
name: New name for the container

Returns: Confirmation of rename.

{
  "type": "object",
  "required": [
    "id",
    "name"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Container ID or current name"
    },
    "name": {
      "type": "string",
      "description": "New name for the container"
    }
  }
}

docker_get_logs

Get container logs.

Args:

id: Container ID or name
tail: Number of lines to show from end (default: 100)
timestamps: Include timestamps

Returns: Container log output.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Container ID or name"
    },
    "tail": {
      "type": "integer",
      "default": 100,
      "minimum": 1,
      "description": "Number of lines to show"
    },
    "timestamps": {
      "type": "boolean",
      "default": false,
      "description": "Include timestamps"
    }
  }
}

docker_get_stats

Get container resource usage statistics.

Args:

id: Container ID or name
format: Response format ('json' or 'markdown')

Returns: CPU, memory, network, and I/O statistics.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Container ID or name"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

docker_get_top

Get running processes in a container.

Args:

id: Container ID or name
psArgs: Arguments to pass to ps (default: -ef)

Returns: List of processes running in the container.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Container ID or name"
    },
    "psArgs": {
      "type": "string",
      "default": "-ef",
      "description": "Arguments to pass to ps"
    }
  }
}

docker_get_changes

Get filesystem changes in a container.

Args:

id: Container ID or name

Returns: List of changed files (0=Modified, 1=Added, 2=Deleted).

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Container ID or name"
    }
  }
}

docker_wait_container

Wait for a container to stop.

Args:

id: Container ID or name

Returns: Exit code and any error message.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Container ID or name"
    }
  }
}

docker_prune_containers

Remove all stopped containers.

Returns: List of deleted container IDs and space reclaimed.

{
  "type": "object",
  "properties": {}
}

docker_update_container

Update container resource limits.

Args:

id: Container ID or name
cpuShares: CPU shares (relative weight)
memory: Memory limit in bytes
memorySwap: Total memory limit (memory + swap)
cpuPeriod: CPU CFS period
cpuQuota: CPU CFS quota
cpusetCpus: CPUs to use (e.g., "0-3" or "0,1")
cpusetMems: Memory nodes to use

Returns: Warnings from the update.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Container ID or name"
    },
    "memory": {
      "type": "integer",
      "description": "Memory limit in bytes"
    },
    "cpuQuota": {
      "type": "integer",
      "description": "CPU CFS quota"
    },
    "cpuPeriod": {
      "type": "integer",
      "description": "CPU CFS period"
    },
    "cpuShares": {
      "type": "integer",
      "description": "CPU shares (relative weight)"
    },
    "cpusetCpus": {
      "type": "string",
      "description": "CPUs to use"
    },
    "cpusetMems": {
      "type": "string",
      "description": "Memory nodes to use"
    },
    "memorySwap": {
      "type": "integer",
      "description": "Total memory limit"
    }
  }
}

docker_exec

Execute a command in a running container.

This is a convenience tool that creates and starts an exec instance.

Args:

containerId: Container ID or name
cmd: Command to execute (array of strings)
workingDir: Working directory inside container
user: User to run as
env: Environment variables (array of KEY=VALUE)
privileged: Run in privileged mode
tty: Allocate a TTY

Returns: Command output.

{
  "type": "object",
  "required": [
    "containerId",
    "cmd"
  ],
  "properties": {
    "cmd": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Command to execute"
    },
    "env": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Environment variables"
    },
    "tty": {
      "type": "boolean",
      "default": false,
      "description": "Allocate a TTY"
    },
    "user": {
      "type": "string",
      "description": "User to run as"
    },
    "privileged": {
      "type": "boolean",
      "default": false,
      "description": "Run in privileged mode"
    },
    "workingDir": {
      "type": "string",
      "description": "Working directory"
    },
    "containerId": {
      "type": "string",
      "description": "Container ID or name"
    }
  }
}

docker_inspect_secret

Get detailed information about a secret.

Args:

id: Secret ID or name

Returns: Secret metadata (not the secret data itself).

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Secret ID or name"
    }
  }
}

docker_create_exec

Create an exec instance in a container.

This creates an exec instance that can be started later.

Args:

containerId: Container ID or name
cmd: Command to execute (array of strings)
workingDir: Working directory inside container
user: User to run as
env: Environment variables (array of KEY=VALUE)
privileged: Run in privileged mode
tty: Allocate a TTY
attachStdin: Attach stdin
attachStdout: Attach stdout
attachStderr: Attach stderr
detachKeys: Escape keys for detach

Returns: Exec instance ID.

{
  "type": "object",
  "required": [
    "containerId",
    "cmd"
  ],
  "properties": {
    "cmd": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Command to execute"
    },
    "env": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Environment variables"
    },
    "tty": {
      "type": "boolean",
      "default": false,
      "description": "Allocate a TTY"
    },
    "user": {
      "type": "string",
      "description": "User to run as"
    },
    "detachKeys": {
      "type": "string",
      "description": "Escape keys for detach"
    },
    "privileged": {
      "type": "boolean",
      "default": false,
      "description": "Run in privileged mode"
    },
    "workingDir": {
      "type": "string",
      "description": "Working directory"
    },
    "attachStdin": {
      "type": "boolean",
      "default": false,
      "description": "Attach stdin"
    },
    "containerId": {
      "type": "string",
      "description": "Container ID or name"
    },
    "attachStderr": {
      "type": "boolean",
      "default": true,
      "description": "Attach stderr"
    },
    "attachStdout": {
      "type": "boolean",
      "default": true,
      "description": "Attach stdout"
    }
  }
}

docker_start_exec

Start a previously created exec instance.

Args:

id: Exec instance ID
detach: Detach from the exec
tty: Allocate a TTY

Returns: Command output (if not detached).

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Exec instance ID"
    },
    "tty": {
      "type": "boolean",
      "default": false,
      "description": "Allocate a TTY"
    },
    "detach": {
      "type": "boolean",
      "default": false,
      "description": "Detach from the exec"
    }
  }
}

docker_inspect_exec

Get information about an exec instance.

Args:

id: Exec instance ID

Returns: Exec instance details including running state and exit code.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Exec instance ID"
    }
  }
}

docker_resize_exec

Resize the TTY of an exec instance.

Args:

id: Exec instance ID
height: TTY height
width: TTY width

Returns: Confirmation of resize.

{
  "type": "object",
  "required": [
    "id",
    "height",
    "width"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Exec instance ID"
    },
    "width": {
      "type": "integer",
      "minimum": 1,
      "description": "TTY width"
    },
    "height": {
      "type": "integer",
      "minimum": 1,
      "description": "TTY height"
    }
  }
}

docker_hub_login

Args:

username: Docker Hub username
password: Docker Hub password

Returns: Authentication token.

{
  "type": "object",
  "required": [
    "username",
    "password"
  ],
  "properties": {
    "password": {
      "type": "string",
      "description": "Docker Hub password"
    },
    "username": {
      "type": "string",
      "description": "Docker Hub username"
    }
  }
}

docker_hub_list_repos

List repositories in a Docker Hub namespace.

Args:

namespace: Docker Hub namespace (username or organization)
page: Page number (default: 1)
pageSize: Items per page (default: 25)
format: Response format ('json' or 'markdown')

Returns: List of repositories with name, description, stars, and pull count.

{
  "type": "object",
  "required": [
    "namespace"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "pageSize": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    },
    "namespace": {
      "type": "string",
      "description": "Docker Hub namespace"
    }
  }
}

docker_hub_get_repo

Get details of a Docker Hub repository.

Args:

namespace: Docker Hub namespace
repository: Repository name
format: Response format ('json' or 'markdown')

Returns: Repository details including description, stars, and pull count.

{
  "type": "object",
  "required": [
    "namespace",
    "repository"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "namespace": {
      "type": "string",
      "description": "Docker Hub namespace"
    },
    "repository": {
      "type": "string",
      "description": "Repository name"
    }
  }
}

docker_hub_list_tags

List tags for a Docker Hub repository.

Args:

namespace: Docker Hub namespace
repository: Repository name
page: Page number (default: 1)
pageSize: Items per page (default: 25)
format: Response format ('json' or 'markdown')

Returns: List of tags with name, size, and last updated time.

{
  "type": "object",
  "required": [
    "namespace",
    "repository"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "pageSize": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    },
    "namespace": {
      "type": "string",
      "description": "Docker Hub namespace"
    },
    "repository": {
      "type": "string",
      "description": "Repository name"
    }
  }
}

docker_hub_get_tag

Get details of a specific tag.

Args:

namespace: Docker Hub namespace
repository: Repository name
tag: Tag name

Returns: Tag details including images for each architecture.

{
  "type": "object",
  "required": [
    "namespace",
    "repository",
    "tag"
  ],
  "properties": {
    "tag": {
      "type": "string",
      "description": "Tag name"
    },
    "namespace": {
      "type": "string",
      "description": "Docker Hub namespace"
    },
    "repository": {
      "type": "string",
      "description": "Repository name"
    }
  }
}

docker_hub_delete_tag

Delete a tag from a Docker Hub repository.

Args:

namespace: Docker Hub namespace
repository: Repository name
tag: Tag name

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "namespace",
    "repository",
    "tag"
  ],
  "properties": {
    "tag": {
      "type": "string",
      "description": "Tag name"
    },
    "namespace": {
      "type": "string",
      "description": "Docker Hub namespace"
    },
    "repository": {
      "type": "string",
      "description": "Repository name"
    }
  }
}

docker_hub_list_webhooks

List webhooks for a Docker Hub repository.

Args:

namespace: Docker Hub namespace
repository: Repository name

Returns: List of webhooks with name and URL.

{
  "type": "object",
  "required": [
    "namespace",
    "repository"
  ],
  "properties": {
    "namespace": {
      "type": "string",
      "description": "Docker Hub namespace"
    },
    "repository": {
      "type": "string",
      "description": "Repository name"
    }
  }
}

docker_hub_create_webhook

Create a webhook for a Docker Hub repository.

Args:

namespace: Docker Hub namespace
repository: Repository name
name: Webhook name
webhookUrl: URL to call when triggered

Returns: Created webhook details.

{
  "type": "object",
  "required": [
    "namespace",
    "repository",
    "name",
    "webhookUrl"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Webhook name"
    },
    "namespace": {
      "type": "string",
      "description": "Docker Hub namespace"
    },
    "repository": {
      "type": "string",
      "description": "Repository name"
    },
    "webhookUrl": {
      "type": "string",
      "description": "URL to call"
    }
  }
}

docker_hub_delete_webhook

Delete a webhook from a Docker Hub repository.

Args:

namespace: Docker Hub namespace
repository: Repository name
webhookId: Webhook ID

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "namespace",
    "repository",
    "webhookId"
  ],
  "properties": {
    "namespace": {
      "type": "string",
      "description": "Docker Hub namespace"
    },
    "webhookId": {
      "type": "integer",
      "description": "Webhook ID"
    },
    "repository": {
      "type": "string",
      "description": "Repository name"
    }
  }
}

docker_hub_build_settings

Get automated build settings for a repository.

Args:

namespace: Docker Hub namespace
repository: Repository name

Returns: Build settings including build tags and autotests configuration.

{
  "type": "object",
  "required": [
    "namespace",
    "repository"
  ],
  "properties": {
    "namespace": {
      "type": "string",
      "description": "Docker Hub namespace"
    },
    "repository": {
      "type": "string",
      "description": "Repository name"
    }
  }
}

docker_hub_build_history

Get build history for a repository.

Args:

namespace: Docker Hub namespace
repository: Repository name
page: Page number (default: 1)
pageSize: Items per page (default: 25)

Returns: List of builds with status, tag, and timestamps.

{
  "type": "object",
  "required": [
    "namespace",
    "repository"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "pageSize": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page"
    },
    "namespace": {
      "type": "string",
      "description": "Docker Hub namespace"
    },
    "repository": {
      "type": "string",
      "description": "Repository name"
    }
  }
}

docker_hub_trigger_build

Trigger an automated build for a repository.

Args:

namespace: Docker Hub namespace
repository: Repository name
sourceType: Source type (Branch or Tag)
sourceName: Source name (branch or tag name)

Returns: Confirmation of build trigger.

{
  "type": "object",
  "required": [
    "namespace",
    "repository"
  ],
  "properties": {
    "namespace": {
      "type": "string",
      "description": "Docker Hub namespace"
    },
    "repository": {
      "type": "string",
      "description": "Repository name"
    },
    "sourceName": {
      "type": "string",
      "default": "main",
      "description": "Source name"
    },
    "sourceType": {
      "enum": [
        "Branch",
        "Tag"
      ],
      "type": "string",
      "default": "Branch",
      "description": "Source type"
    }
  }
}

docker_list_images

List Docker images.

Args:

all: Show all images (default hides intermediate images)
dangling: Show only dangling images
format: Response format ('json' or 'markdown')

Returns: List of images with ID, tags, size, and creation time.

{
  "type": "object",
  "properties": {
    "all": {
      "type": "boolean",
      "default": false,
      "description": "Show all images"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "dangling": {
      "type": "boolean",
      "description": "Show only dangling images"
    }
  }
}

docker_inspect_image

Get detailed information about an image.

Args:

name: Image name or ID
format: Response format ('json' or 'markdown')

Returns: Detailed image configuration and metadata.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Image name or ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

docker_get_image_history

Get the history of an image (layers).

Args:

name: Image name or ID

Returns: List of image layers with creation info.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Image name or ID"
    }
  }
}

docker_pull_image

Pull an image from a registry.

Args:

image: Image name (e.g., "nginx", "ubuntu", "myregistry.com/myimage")
tag: Tag to pull (default: "latest")
username: Registry username (optional)
password: Registry password (optional)

Returns: Pull progress and result.

{
  "type": "object",
  "required": [
    "image"
  ],
  "properties": {
    "tag": {
      "type": "string",
      "default": "latest",
      "description": "Tag to pull"
    },
    "image": {
      "type": "string",
      "description": "Image name"
    },
    "password": {
      "type": "string",
      "description": "Registry password"
    },
    "username": {
      "type": "string",
      "description": "Registry username"
    }
  }
}

docker_push_image

Push an image to a registry.

Args:

name: Image name (e.g., "myregistry.com/myimage")
tag: Tag to push (optional)
username: Registry username
password: Registry password

Returns: Push progress and result.

{
  "type": "object",
  "required": [
    "name",
    "username",
    "password"
  ],
  "properties": {
    "tag": {
      "type": "string",
      "description": "Tag to push"
    },
    "name": {
      "type": "string",
      "description": "Image name"
    },
    "password": {
      "type": "string",
      "description": "Registry password"
    },
    "username": {
      "type": "string",
      "description": "Registry username"
    }
  }
}

docker_tag_image

Tag an image.

Args:

name: Source image name or ID
repo: Target repository name
tag: Target tag (default: "latest")

Returns: Confirmation of tagging.

{
  "type": "object",
  "required": [
    "name",
    "repo"
  ],
  "properties": {
    "tag": {
      "type": "string",
      "default": "latest",
      "description": "Target tag"
    },
    "name": {
      "type": "string",
      "description": "Source image name or ID"
    },
    "repo": {
      "type": "string",
      "description": "Target repository name"
    }
  }
}

docker_swarm_leave

Leave the swarm.

Args:

force: Force leave even if this is the last manager

Returns: Confirmation of leave.

{
  "type": "object",
  "properties": {
    "force": {
      "type": "boolean",
      "default": false,
      "description": "Force leave"
    }
  }
}

docker_remove_image

Remove an image.

Args:

name: Image name or ID
force: Force removal
noPrune: Don't delete untagged parents

Returns: List of deleted/untagged layers.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Image name or ID"
    },
    "force": {
      "type": "boolean",
      "default": false,
      "description": "Force removal"
    },
    "noPrune": {
      "type": "boolean",
      "default": false,
      "description": "Don't delete untagged parents"
    }
  }
}

docker_search_images

Search Docker Hub for images.

Args:

term: Search term
limit: Maximum results (default: 25)
format: Response format ('json' or 'markdown')

Returns: List of matching images from Docker Hub.

{
  "type": "object",
  "required": [
    "term"
  ],
  "properties": {
    "term": {
      "type": "string",
      "description": "Search term"
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum results"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

docker_prune_images

Remove unused images.

Args:

dangling: Only remove dangling images (default: true)

Returns: List of deleted images and space reclaimed.

{
  "type": "object",
  "properties": {
    "dangling": {
      "type": "boolean",
      "default": true,
      "description": "Only remove dangling images"
    }
  }
}

docker_list_networks

List Docker networks.

Args:

driver: Filter by driver (e.g., "bridge", "overlay")
scope: Filter by scope ("swarm", "global", "local")
format: Response format ('json' or 'markdown')

Returns: List of networks with ID, name, driver, and scope.

{
  "type": "object",
  "properties": {
    "scope": {
      "enum": [
        "swarm",
        "global",
        "local"
      ],
      "type": "string",
      "description": "Filter by scope"
    },
    "driver": {
      "type": "string",
      "description": "Filter by driver"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

docker_inspect_network

Get detailed information about a network.

Args:

id: Network ID or name
format: Response format ('json' or 'markdown')

Returns: Detailed network configuration including connected containers.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Network ID or name"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

docker_create_network

Create a new network.

Args:

name: Network name (required)
driver: Network driver (default: "bridge")
internal: Restrict external access
attachable: Enable manual container attachment
enableIPv6: Enable IPv6
subnet: Subnet in CIDR format (e.g., "172.28.0.0/16")
gateway: Gateway address
ipRange: IP range to allocate from
labels: Network labels

Returns: Created network ID.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Network name"
    },
    "driver": {
      "type": "string",
      "default": "bridge",
      "description": "Network driver"
    },
    "labels": {
      "type": "object",
      "description": "Network labels"
    },
    "subnet": {
      "type": "string",
      "description": "Subnet in CIDR format"
    },
    "gateway": {
      "type": "string",
      "description": "Gateway address"
    },
    "ipRange": {
      "type": "string",
      "description": "IP range to allocate from"
    },
    "internal": {
      "type": "boolean",
      "description": "Restrict external access"
    },
    "attachable": {
      "type": "boolean",
      "description": "Enable manual container attachment"
    },
    "enableIPv6": {
      "type": "boolean",
      "description": "Enable IPv6"
    }
  }
}

docker_remove_network

Remove a network.

Args:

id: Network ID or name

Returns: Confirmation of removal.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Network ID or name"
    }
  }
}

docker_connect_network

Connect a container to a network.

Args:

networkId: Network ID or name
containerId: Container ID or name
ipv4Address: IPv4 address to assign
ipv6Address: IPv6 address to assign
aliases: Network aliases for the container

Returns: Confirmation of connection.

{
  "type": "object",
  "required": [
    "networkId",
    "containerId"
  ],
  "properties": {
    "aliases": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Network aliases"
    },
    "networkId": {
      "type": "string",
      "description": "Network ID or name"
    },
    "containerId": {
      "type": "string",
      "description": "Container ID or name"
    },
    "ipv4Address": {
      "type": "string",
      "description": "IPv4 address to assign"
    },
    "ipv6Address": {
      "type": "string",
      "description": "IPv6 address to assign"
    }
  }
}

docker_disconnect_network

Disconnect a container from a network.

Args:

networkId: Network ID or name
containerId: Container ID or name
force: Force disconnection

Returns: Confirmation of disconnection.

{
  "type": "object",
  "required": [
    "networkId",
    "containerId"
  ],
  "properties": {
    "force": {
      "type": "boolean",
      "default": false,
      "description": "Force disconnection"
    },
    "networkId": {
      "type": "string",
      "description": "Network ID or name"
    },
    "containerId": {
      "type": "string",
      "description": "Container ID or name"
    }
  }
}

docker_prune_networks

Remove all unused networks.

Returns: List of deleted network IDs.

{
  "type": "object",
  "properties": {}
}

docker_list_plugins

List installed Docker plugins.

Args:

enabled: Filter by enabled status
format: Response format ('json' or 'markdown')

Returns: List of plugins with name, enabled status, and description.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "enabled": {
      "type": "boolean",
      "description": "Filter by enabled status"
    }
  }
}

docker_inspect_plugin

Get detailed information about a plugin.

Args:

name: Plugin name

Returns: Detailed plugin configuration.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Plugin name"
    }
  }
}

docker_plugin_privileges

Get privileges required by a plugin.

Args:

remote: Plugin image reference

Returns: List of privileges required by the plugin.

{
  "type": "object",
  "required": [
    "remote"
  ],
  "properties": {
    "remote": {
      "type": "string",
      "description": "Plugin image reference"
    }
  }
}

docker_swarm_unlock_key

Get the swarm unlock key.

Returns: The unlock key for the swarm.

{
  "type": "object",
  "properties": {}
}

docker_swarm_unlock

Unlock a locked swarm.

Args:

unlockKey: The unlock key

Returns: Confirmation of unlock.

{
  "type": "object",
  "required": [
    "unlockKey"
  ],
  "properties": {
    "unlockKey": {
      "type": "string",
      "description": "The unlock key"
    }
  }
}

docker_install_plugin

Install a plugin from a registry.

Args:

remote: Plugin image reference (e.g., "vieux/sshfs:latest")
name: Local name for the plugin
grantAllPermissions: Grant all required permissions automatically

Returns: Confirmation of installation.

{
  "type": "object",
  "required": [
    "remote"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Local name for the plugin"
    },
    "remote": {
      "type": "string",
      "description": "Plugin image reference"
    },
    "grantAllPermissions": {
      "type": "boolean",
      "default": false,
      "description": "Grant all permissions"
    }
  }
}

docker_enable_plugin

Enable a plugin.

Args:

name: Plugin name
timeout: Timeout in seconds

Returns: Confirmation of enable.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Plugin name"
    },
    "timeout": {
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "description": "Timeout in seconds"
    }
  }
}

docker_disable_plugin

Disable a plugin.

Args:

name: Plugin name
force: Force disable

Returns: Confirmation of disable.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Plugin name"
    },
    "force": {
      "type": "boolean",
      "default": false,
      "description": "Force disable"
    }
  }
}

docker_remove_plugin

Remove a plugin.

Args:

name: Plugin name
force: Force removal

Returns: Confirmation of removal.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Plugin name"
    },
    "force": {
      "type": "boolean",
      "default": false,
      "description": "Force removal"
    }
  }
}

docker_upgrade_plugin

Upgrade a plugin.

Args:

name: Plugin name
remote: New plugin image reference
grantAllPermissions: Grant all required permissions automatically

Returns: Confirmation of upgrade.

{
  "type": "object",
  "required": [
    "name",
    "remote"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Plugin name"
    },
    "remote": {
      "type": "string",
      "description": "New plugin image reference"
    },
    "grantAllPermissions": {
      "type": "boolean",
      "default": false,
      "description": "Grant all permissions"
    }
  }
}

docker_configure_plugin

Configure a plugin.

Args:

name: Plugin name
settings: Plugin settings (array of KEY=VALUE)

Returns: Confirmation of configuration.

{
  "type": "object",
  "required": [
    "name",
    "settings"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Plugin name"
    },
    "settings": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Plugin settings (KEY=VALUE)"
    }
  }
}

docker_list_secrets

List Docker secrets (Swarm mode).

Args:

format: Response format ('json' or 'markdown')

Returns: List of secrets with ID and name.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

docker_create_secret

Create a new secret.

Args:

name: Secret name
data: Secret data (will be base64 encoded)
labels: Secret labels

Returns: Created secret ID.

{
  "type": "object",
  "required": [
    "name",
    "data"
  ],
  "properties": {
    "data": {
      "type": "string",
      "description": "Secret data"
    },
    "name": {
      "type": "string",
      "description": "Secret name"
    },
    "labels": {
      "type": "object",
      "description": "Secret labels"
    }
  }
}

docker_remove_secret

Remove a secret.

Args:

id: Secret ID or name

Returns: Confirmation of removal.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Secret ID or name"
    }
  }
}

docker_list_configs

List Docker configs (Swarm mode).

Args:

format: Response format ('json' or 'markdown')

Returns: List of configs with ID and name.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

docker_inspect_config

Get detailed information about a config.

Args:

id: Config ID or name

Returns: Config details including data.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Config ID or name"
    }
  }
}

docker_create_config

Create a new config.

Args:

name: Config name
data: Config data (will be base64 encoded)
labels: Config labels

Returns: Created config ID.

{
  "type": "object",
  "required": [
    "name",
    "data"
  ],
  "properties": {
    "data": {
      "type": "string",
      "description": "Config data"
    },
    "name": {
      "type": "string",
      "description": "Config name"
    },
    "labels": {
      "type": "object",
      "description": "Config labels"
    }
  }
}

docker_remove_config

Remove a config.

Args:

id: Config ID or name

Returns: Confirmation of removal.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Config ID or name"
    }
  }
}

docker_swarm_inspect

Get information about the swarm.

Returns: Swarm configuration and status.

{
  "type": "object",
  "properties": {}
}

docker_swarm_init

Initialize a new swarm.

Args:

listenAddr: Listen address (default: "0.0.0.0:2377")
advertiseAddr: Advertise address
dataPathAddr: Data path address
forceNewCluster: Force create a new cluster

Returns: Node ID of the swarm manager.

{
  "type": "object",
  "properties": {
    "listenAddr": {
      "type": "string",
      "default": "0.0.0.0:2377",
      "description": "Listen address"
    },
    "dataPathAddr": {
      "type": "string",
      "description": "Data path address"
    },
    "advertiseAddr": {
      "type": "string",
      "description": "Advertise address"
    },
    "forceNewCluster": {
      "type": "boolean",
      "default": false,
      "description": "Force create a new cluster"
    }
  }
}

docker_swarm_join

Join an existing swarm.

Args:

joinToken: Token to join the swarm (worker or manager)
remoteAddrs: Addresses of existing managers
listenAddr: Listen address (default: "0.0.0.0:2377")
advertiseAddr: Advertise address
dataPathAddr: Data path address

Returns: Confirmation of join.

{
  "type": "object",
  "required": [
    "joinToken",
    "remoteAddrs"
  ],
  "properties": {
    "joinToken": {
      "type": "string",
      "description": "Token to join the swarm"
    },
    "listenAddr": {
      "type": "string",
      "default": "0.0.0.0:2377",
      "description": "Listen address"
    },
    "remoteAddrs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Addresses of existing managers"
    },
    "dataPathAddr": {
      "type": "string",
      "description": "Data path address"
    },
    "advertiseAddr": {
      "type": "string",
      "description": "Advertise address"
    }
  }
}

docker_list_nodes

List swarm nodes.

Args:

role: Filter by role (worker or manager)
format: Response format ('json' or 'markdown')

Returns: List of swarm nodes.

{
  "type": "object",
  "properties": {
    "role": {
      "enum": [
        "worker",
        "manager"
      ],
      "type": "string",
      "description": "Filter by role"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

docker_inspect_node

Get detailed information about a node.

Args:

id: Node ID
format: Response format ('json' or 'markdown')

Returns: Detailed node information.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Node ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

docker_remove_node

Remove a node from the swarm.

Args:

id: Node ID
force: Force removal

Returns: Confirmation of removal.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Node ID"
    },
    "force": {
      "type": "boolean",
      "default": false,
      "description": "Force removal"
    }
  }
}

docker_update_node

Update a node's configuration.

Args:

id: Node ID
version: Node version (for optimistic locking)
role: Node role (worker or manager)
availability: Node availability (active, pause, drain)
name: Node name
labels: Node labels

Returns: Confirmation of update.

{
  "type": "object",
  "required": [
    "id",
    "version",
    "role",
    "availability"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Node ID"
    },
    "name": {
      "type": "string",
      "description": "Node name"
    },
    "role": {
      "enum": [
        "worker",
        "manager"
      ],
      "type": "string",
      "description": "Node role"
    },
    "labels": {
      "type": "object",
      "description": "Node labels"
    },
    "version": {
      "type": "integer",
      "description": "Node version"
    },
    "availability": {
      "enum": [
        "active",
        "pause",
        "drain"
      ],
      "type": "string",
      "description": "Node availability"
    }
  }
}

docker_list_services

List swarm services.

Args:

mode: Filter by mode (replicated or global)
format: Response format ('json' or 'markdown')

Returns: List of swarm services.

{
  "type": "object",
  "properties": {
    "mode": {
      "enum": [
        "replicated",
        "global"
      ],
      "type": "string",
      "description": "Filter by mode"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

docker_inspect_service

Get detailed information about a service.

Args:

id: Service ID or name
format: Response format ('json' or 'markdown')

Returns: Detailed service configuration.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Service ID or name"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

docker_create_service

Create a new swarm service.

Args:

name: Service name
image: Image to use
replicas: Number of replicas (for replicated mode)
global: Run one task per node (global mode)
cmd: Command to run
env: Environment variables
labels: Service labels
publishedPorts: Ports to publish (array of {targetPort, publishedPort, protocol})

Returns: Created service ID.

{
  "type": "object",
  "required": [
    "name",
    "image"
  ],
  "properties": {
    "cmd": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Command to run"
    },
    "env": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Environment variables"
    },
    "name": {
      "type": "string",
      "description": "Service name"
    },
    "image": {
      "type": "string",
      "description": "Image to use"
    },
    "global": {
      "type": "boolean",
      "description": "Run one task per node"
    },
    "labels": {
      "type": "object",
      "description": "Service labels"
    },
    "replicas": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of replicas"
    }
  }
}

docker_remove_service

Remove a swarm service.

Args:

id: Service ID or name

Returns: Confirmation of removal.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Service ID or name"
    }
  }
}

docker_service_logs

Get logs from a swarm service.

Args:

id: Service ID or name
tail: Number of lines to show
timestamps: Include timestamps

Returns: Service log output.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Service ID or name"
    },
    "tail": {
      "type": "integer",
      "default": 100,
      "minimum": 1,
      "description": "Number of lines"
    },
    "timestamps": {
      "type": "boolean",
      "default": false,
      "description": "Include timestamps"
    }
  }
}

docker_list_tasks

List swarm tasks.

Args:

service: Filter by service ID
node: Filter by node ID
desiredState: Filter by desired state (running, shutdown, accepted)
format: Response format ('json' or 'markdown')

Returns: List of tasks.

{
  "type": "object",
  "properties": {
    "node": {
      "type": "string",
      "description": "Filter by node ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "service": {
      "type": "string",
      "description": "Filter by service ID"
    },
    "desiredState": {
      "enum": [
        "running",
        "shutdown",
        "accepted"
      ],
      "type": "string",
      "description": "Filter by desired state"
    }
  }
}

docker_inspect_task

Get detailed information about a task.

Args:

id: Task ID

Returns: Detailed task information.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Task ID"
    }
  }
}

docker_system_info

Get Docker system-wide information.

Args:

format: Response format ('json' or 'markdown')

Returns: System information including containers, images, kernel, OS, CPU, memory.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

docker_version

Get Docker version information.

Returns: Docker version, API version, Go version, OS, architecture.

{
  "type": "object",
  "properties": {}
}

docker_ping

Ping the Docker daemon.

Returns: "OK" if the daemon is responsive.

{
  "type": "object",
  "properties": {}
}

docker_disk_usage

Get Docker disk usage information.

Args:

format: Response format ('json' or 'markdown')

Returns: Disk usage for images, containers, volumes, and build cache.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

docker_events

Get Docker events.

Args:

since: Unix timestamp to start from
until: Unix timestamp to end at
type: Filter by event type (container, image, volume, network, daemon, plugin, node, service, secret, config)
format: Response format ('json' or 'markdown')

Returns: List of Docker events.

{
  "type": "object",
  "properties": {
    "type": {
      "enum": [
        "container",
        "image",
        "volume",
        "network",
        "daemon",
        "plugin",
        "node",
        "service",
        "secret",
        "config"
      ],
      "type": "string",
      "description": "Filter by event type"
    },
    "since": {
      "type": "integer",
      "description": "Unix timestamp to start from"
    },
    "until": {
      "type": "integer",
      "description": "Unix timestamp to end at"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

docker_auth

Authenticate with a registry.

Args:

username: Registry username
password: Registry password
serveraddress: Registry address (default: Docker Hub)

Returns: Authentication status.

{
  "type": "object",
  "required": [
    "username",
    "password"
  ],
  "properties": {
    "password": {
      "type": "string",
      "description": "Registry password"
    },
    "username": {
      "type": "string",
      "description": "Registry username"
    },
    "serveraddress": {
      "type": "string",
      "description": "Registry address"
    }
  }
}

docker_list_volumes

List Docker volumes.

Args:

dangling: Filter by dangling status
driver: Filter by driver
format: Response format ('json' or 'markdown')

Returns: List of volumes with name, driver, scope, and mountpoint.

{
  "type": "object",
  "properties": {
    "driver": {
      "type": "string",
      "description": "Filter by driver"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "dangling": {
      "type": "boolean",
      "description": "Filter by dangling status"
    }
  }
}

docker_inspect_volume

Get detailed information about a volume.

Args:

name: Volume name
format: Response format ('json' or 'markdown')

Returns: Detailed volume configuration.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Volume name"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

docker_create_volume

Create a new volume.

Args:

name: Volume name (optional, will be generated if not provided)
driver: Volume driver (default: "local")
driverOpts: Driver-specific options
labels: Volume labels

Returns: Created volume details.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Volume name"
    },
    "driver": {
      "type": "string",
      "default": "local",
      "description": "Volume driver"
    },
    "labels": {
      "type": "object",
      "description": "Volume labels"
    },
    "driverOpts": {
      "type": "object",
      "description": "Driver-specific options"
    }
  }
}

docker_remove_volume

Remove a volume.

Args:

name: Volume name
force: Force removal even if in use

Returns: Confirmation of removal.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Volume name"
    },
    "force": {
      "type": "boolean",
      "default": false,
      "description": "Force removal"
    }
  }
}

docker_prune_volumes

Remove all unused volumes.

Returns: List of deleted volume names and space reclaimed.

{
  "type": "object",
  "properties": {}
}