List Containers
list_containersList containers in the Cycle hub, optionally scoped to one environment. Use to discover what exists, check current state, or disambiguate when multiple containers share a name. Prefer passing environment to narrow results. If has_more is true, call again with page = next_page.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_containers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number; use next_page from a previous response. | |
| limit | No | Results per page. | |
| state | No | Only return containers currently in this state. | |
| search | No | Free-text match against container names and identifiers, e.g. 'api'. | |
| context | No | Why are you calling this tool? Briefly describe the user's goal. | |
| environment | No | Environment to scope to: identifier slug or 24-char hex ID. Omit to list across the whole hub. | |
| conversation_id | No | Conversation tracking id. Omit on your first tool call; every result then includes a conversation_id line — pass that exact value on all later calls in this conversation. |