Home / Servers / DigitalOcean API / harness_list_sessions
ListSessions enumerates sessions for the caller's tenant.
An MCP tool from the DigitalOcean API server, hosted on mcp.hjlabs.in.
ListSessions enumerates sessions for the caller's tenant. Keyset-paginated on an opaque cursor. Results are scoped to the authenticated team. Destroyed and failed sessions are omitted by default (matching the Cloud Console); pass status=SESSION_STATUS_ALL… [GET /v2/agents/sessions]
Name on the gateway: digitalocean_api__harness_list_sessions · read-only.
Parameters
| Name | Type | Description |
|---|---|---|
page_size | integer | Page size. Defaults to 50 when omitted or non-positive; values above 200 are… |
page_token | string | Opaque keyset cursor returned by the previous page. Empty starts from the… |
status | SESSION_STATUS_UNSPECIFIED | SESSION_STATUS_PROVISIONING | SESSION_STATUS_READY | SESSION_STATUS_DETACHED | SESSION_STATUS_DESTROYING | SESSION_STATUS_DESTROYED | SESSION_STATUS_FAILED | SESSION_STATUS_PAUSED | SESSION_STATUS_ALL | SESSION_STATUS_LOCKED | Optional filter on session status. Empty / SESSION_STATUS_UNSPECIFIED means no… |
name | string | Optional exact-name filter (case-insensitive). Returns the single live… |
search | string | Optional case-insensitive substring filter on session name (contains), for… |
How to call it
Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:
{
"name": "digitalocean_api__harness_list_sessions",
"arguments": {}
}Or connect the DigitalOcean API server directly, which lists 874 tools including this one:
claude mcp add --transport http hj-digitalocean-api https://mcp.hjlabs.in/mcp/digitalocean-api \
--header "Authorization: Bearer YOUR_API_KEY"Try asking
Use the listsessions enumerates sessions for the caller's tenant. tool with page_size set to ….