container_list
List Docker containers running on a daemon, with options to include stopped ones, filter by status/label, and limit results.
Instructions
List containers on the daemon (running only by default).
Pass all=True to include stopped containers. For a compose project compose_ps groups
containers by service; for swarm services use service_ps (tasks may live on other nodes).
args:
all - Show all containers, including stopped ones (default False: running only)
since - Only show containers created after this id or name
before - Only show containers created before this id or name
limit - Maximum number of results
filters - Filter by attributes (e.g. status, label)
sparse - Skip inspect calls and return less detail
ignore_removed - Ignore containers removed during listing
managed_only - Only return containers created by this MCP server (filters on the
docker-mcp-server.managed label); combines with any filters given
returns: list - One dict per container: full inspect payloads by default (each match is
inspected, like container_inspect); sparse=True skips the per-container inspect calls
and returns the daemon's abridged list entries instead
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| all | No | ||
| limit | No | ||
| since | No | ||
| before | No | ||
| sparse | No | ||
| filters | No | ||
| managed_only | No | ||
| ignore_removed | No |