Home / Servers / DigitalOcean API / harness_list_workspaces

List the team's persistent workspaces.

An MCP tool from the DigitalOcean API server, hosted on mcp.hjlabs.in.

List the team's persistent workspaces. Lists the calling team's persistent workspaces, optionally only those in one state. A page can hold fewer results than page_size, so keep paging until next_page_token is empty. [GET /v2/agents/workspaces]

Name on the gateway: digitalocean_api__harness_list_workspaces · read-only.

Parameters

NameTypeDescription
page_sizeintegerPage size. The server applies a default when omitted and clamps large values.
page_tokenstringOpaque cursor returned by the previous page. Empty starts from the beginning.
stateAVAILABLE | ATTACHING | ATTACHED | RELEASING | FAILED | DELETINGOnly list workspaces in this state.

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:

call_tool arguments
{
  "name": "digitalocean_api__harness_list_workspaces",
  "arguments": {}
}

Or connect the DigitalOcean API server directly, which lists 874 tools including this one:

Run in your terminal
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 list the team's persistent workspaces. tool with page_size set to ….

More from DigitalOcean API