Home / Servers / Netlify API / list_agent_runners
List a site's agent runs
An MCP tool from the Netlify API server, hosted on mcp.hjlabs.in.
List a site's agent runs Lists a site's agent runs, most recently active first. Archived runs are left out unless state is archived. [GET /agent_runners]
Name on the gateway: netlify_api__list_agent_runners · read-only.
Parameters
| Name | Type | Description |
|---|---|---|
site_id required | string | site_id parameter |
account_id required | string | account_id parameter |
page | integer | page parameter |
per_page | integer | per_page parameter |
state | string | Only runs in this state: new, running, await_input, interrupted, error, done… |
title | string | title parameter |
branch | string | branch parameter |
result_branch | string | result_branch parameter |
user_id | string | Only runs started by this user. |
from | integer | Unix timestamp. Only runs created at or after this time. |
to | integer | Unix timestamp. Only runs created before this time. |
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": "netlify_api__list_agent_runners",
"arguments": {
"site_id": "…",
"account_id": "…"
}
}Or connect the Netlify API server directly, which lists 188 tools including this one:
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 a site's agent runs tool with site_id set to ….