Home / Servers / Netlify API / list_agent_runner_sessions

List an agent run's sessions

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

List an agent run's sessions [GET /agent_runners/{agent_runner_id}/sessions]

Name on the gateway: netlify_api__list_agent_runner_sessions · read-only.

Parameters

NameTypeDescription
agent_runner_id requiredstringagent_runner_id parameter
pageintegerpage parameter
per_pageintegerper_page parameter
statestringOnly sessions in this state: new, running, await_input, interrupted, error…
fromintegerUnix timestamp. Only sessions created at or after this time.
tointegerUnix timestamp. Only sessions created before this time.
order_byasc | descorder_by parameter

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": "netlify_api__list_agent_runner_sessions",
  "arguments": {
    "agent_runner_id": "…"
  }
}

Or connect the Netlify API server directly, which lists 188 tools including this one:

Run in your terminal
claude mcp add --transport http hj-netlify-api https://mcp.hjlabs.in/mcp/netlify-api \
  --header "Authorization: Bearer YOUR_API_KEY"

Try asking

Use the list an agent run's sessions tool with agent_runner_id set to ….

More from Netlify API