Home / Servers / DigitalOcean API / genai_list_simulation_episodes

List Simulation Episodes

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

List Simulation Episodes To list the episodes within a simulation run, send a GET request to /v2/gen-ai/simulation_runs/{run_uuid}/episodes. [GET /v2/gen-ai/simulation_runs/{run_uuid}/episodes]

Name on the gateway: digitalocean_api__genai_list_simulation_episodes · read-only.

Parameters

NameTypeDescription
run_uuid requiredstringUUID of the run whose episodes to list.
scenario_uuidstringOptional filter by scenario.
pageintegerPage number.
per_pageintegerItems per page.
statusesarrayFilter by one or more statuses. Empty means no status filter.…
verdictsarrayFilter by one or more verdicts. Empty means no verdict filter.…
searchstringFree-text search across scenario_uuid and session_id (case-insensitive…
sort_bySIMULATION_EPISODE_SORT_FIELD_UNSPECIFIED | SIMULATION_EPISODE_SORT_FIELD_SCENARIO | SIMULATION_EPISODE_SORT_FIELD_CREATED_AT | SIMULATION_EPISODE_SORT_FIELD_STATUS | SIMULATION_EPISODE_SORT_FIELD_VERDICTField to sort by. Defaults to scenario ordering when unspecified.…
sort_directionSORT_DIRECTION_UNSPECIFIED | SORT_DIRECTION_ASC | SORT_DIRECTION_DESCSort direction. Defaults to ascending when unspecified.

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__genai_list_simulation_episodes",
  "arguments": {
    "run_uuid": "…"
  }
}

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 simulation episodes tool with run_uuid set to ….

More from DigitalOcean API