Check Portainer connection and authentication status.

List all Portainer environments (endpoints).

Get details of a specific Portainer environment (endpoint).

Args: endpoint_id: The ID of the endpoint to inspect

List all Portainer stacks.

Get details of a stack including its compose file content.

Args: stack_id: The ID of the stack to inspect

Deploy a new stack from a docker-compose string.

Args: name: Name of the new stack compose_content: Docker Compose file content (YAML string) endpoint_id: Target endpoint ID (uses default if omitted)

Update an existing stack, optionally with new compose content.

Args: stack_id: The ID of the stack to update compose_content: New Docker Compose content (YAML). If omitted, redeploys existing. endpoint_id: Endpoint ID (derived from the stack itself if omitted)

Delete a stack.

Args: stack_id: The ID of the stack to delete

Start a stopped stack.

Args: stack_id: The ID of the stack to start

Stop a running stack.

Args: stack_id: The ID of the stack to stop

List containers on an endpoint.

Args: endpoint_id: Target endpoint ID (uses default if omitted) show_all: If true, show all containers including stopped ones name_filter: Only return containers whose name contains this substring (server-side Docker filter)

Get detailed information about a container.

Args: container_id: Container ID or name endpoint_id: Target endpoint ID (uses default if omitted)

Start a stopped container.

Args: container_id: Container ID or name endpoint_id: Target endpoint ID (uses default if omitted)

Stop a running container.

Args: container_id: Container ID or name endpoint_id: Target endpoint ID (uses default if omitted)

Restart a container.

Args: container_id: Container ID or name endpoint_id: Target endpoint ID (uses default if omitted)

Remove a container.

Args: container_id: Container ID or name force: Force removal of a running container (default false) endpoint_id: Target endpoint ID (uses default if omitted)

Get container logs.

Args: container_id: Container ID or name tail: Number of lines from the end of the logs (default 100, max 1000) endpoint_id: Target endpoint ID (uses default if omitted)

Search container logs for lines matching a regex pattern.

Returns only matching lines (with optional context). Useful for finding specific errors, status codes, or keywords without downloading the full log.

Args: container_id: Container ID or name pattern: Regex pattern to search for (case-insensitive) tail: Number of log lines to fetch before filtering (default 500, max 1000) context_lines: Lines of context around each match (default 0, max 5) endpoint_id: Target endpoint ID (uses default if omitted)

Scan all running containers in a stack for errors.

Fetches logs from every running container whose name starts with the given stack name and filters for common error patterns: HTTP 4xx/5xx, exceptions, fatal/critical/emergency log levels, panics, OOM, PHP errors, segfaults, etc.

Args: stack_name: Stack name prefix (e.g. "taylor", "blog", "somnlyx") tail: Log lines per container to scan (default 500, max 1000) endpoint_id: Target endpoint ID (uses default if omitted)

Get Laravel application-level errors from storage/logs/laravel.log.

Executes inside each running backend/horizon container of a stack to read the actual Laravel error log (not nginx access log). Returns production.ERROR entries with exception messages and context.

Use this AFTER portainer_stack_logs_errors to get root cause details behind HTTP 500 errors seen in nginx access logs.

Args: stack_name: Stack name prefix (e.g. "taylor", "blog", "somnlyx") tail: Number of error lines to return per container (default 50, max 200) endpoint_id: Target endpoint ID (uses default if omitted)

Execute PHP code via Laravel Tinker inside a stack's backend container.

Finds a running backend container for the given stack and runs php artisan tinker --execute="<code>". Useful for inspecting database records, checking model state, running one-off fixes, and debugging application issues.

Args: stack_name: Stack name prefix (e.g. "taylor", "blog", "somnlyx") code: PHP code to execute (will be passed to tinker --execute) endpoint_id: Target endpoint ID (uses default if omitted)

Get live CPU, memory, and network stats for a container.

Args: container_id: Container ID or name endpoint_id: Target endpoint ID (uses default if omitted)

Execute a command inside a running container and return its output.

Args: container_id: Container ID or name command: Shell command to execute (run via sh -c) workdir: Working directory inside the container user: User to run the command as (e.g. 'root', '1000:1000') endpoint_id: Target endpoint ID (uses default if omitted)

List Docker images on an endpoint.

Args: endpoint_id: Target endpoint ID (uses default if omitted) reference_filter: Only return images matching this reference (e.g. 'nginx' or 'nginx:1.25'; server-side Docker filter)

Get detailed information about a Docker image.

Args: image_id: Image ID or name:tag endpoint_id: Target endpoint ID (uses default if omitted)

Pull a Docker image from a registry.

Args: image_name: Image name (e.g. 'nginx', 'ghcr.io/org/app') tag: Image tag (default 'latest') registry_auth: Optional base64-encoded JSON ({"username":..,"password":..,"serveraddress":..}) forwarded as X-Registry-Auth. Required for private registries. endpoint_id: Target endpoint ID (uses default if omitted)

Remove a Docker image.

Args: image_id: Image ID or name:tag endpoint_id: Target endpoint ID (uses default if omitted)

List Docker volumes on an endpoint.

Args: endpoint_id: Target endpoint ID (uses default if omitted) name_filter: Only return volumes whose name contains this substring (server-side Docker filter)

Get detailed information about a Docker volume.

Args: volume_name: Volume name endpoint_id: Target endpoint ID (uses default if omitted)

Create a Docker volume.

Args: name: Volume name driver: Volume driver (default 'local') labels: Optional labels as key-value pairs endpoint_id: Target endpoint ID (uses default if omitted)

Remove a Docker volume.

Args: volume_name: Volume name force: Force removal even if in use (default false) endpoint_id: Target endpoint ID (uses default if omitted)

List Docker networks on an endpoint.

Args: endpoint_id: Target endpoint ID (uses default if omitted) name_filter: Only return networks whose name contains this substring (server-side Docker filter)

Get detailed information about a Docker network.

Args: network_id: Network ID or name endpoint_id: Target endpoint ID (uses default if omitted)

Create a Docker network.

Args: name: Network name driver: Network driver (default 'bridge'; use 'overlay' for Swarm) internal: Restrict external access (default false) labels: Optional labels as key-value pairs endpoint_id: Target endpoint ID (uses default if omitted)

Remove a Docker network.

Args: network_id: Network ID or name endpoint_id: Target endpoint ID (uses default if omitted)

Connect a container to a network.

Args: network_id: Network ID or name container_id: Container ID or name endpoint_id: Target endpoint ID (uses default if omitted)

Disconnect a container from a network.

Args: network_id: Network ID or name container_id: Container ID or name force: Force disconnect (default false) endpoint_id: Target endpoint ID (uses default if omitted)

Get Docker system information for an endpoint (OS, CPU, memory, containers count, etc).

Args: endpoint_id: Target endpoint ID (uses default if omitted)

Get Docker disk usage (containers, images, volumes, build cache).

Args: endpoint_id: Target endpoint ID (uses default if omitted)

List all Portainer users.

Get details of a specific Portainer user.

Args: user_id: The ID of the user to inspect