Home / Servers / Netlify API / create_site_agent_runner

Start an agent run on a site

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

Start an agent run on a site Starts an agent run on the site. [POST /sites/{site_id}/agent_runners]

Name on the gateway: netlify_api__create_site_agent_runner · may change things.

Parameters

Name	Type	Description
`site_id` required	`string`	The site's ID or one of its hostnames.
`prompt` required	`string`
`branch`	`string`	Branch to start from. Defaults to the site's production branch.
`deploy_id`	`string`	Deploy to start from. Takes precedence over branch.
`agent`	`string`	Agent to run, for example claude or codex.
`model`	`string`	Model for the agent to use. Omit to let Netlify choose.
`effort`	`low \| medium \| high`	Reasoning effort. Omit to let the agent decide.
`mode`	`normal \| ask`	normal (the default) changes code; ask answers questions without changing code.

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__create_site_agent_runner",
  "arguments": {
    "site_id": "…",
    "prompt": "…"
  }
}

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"

Use the start an agent run on a site tool with site_id set to ….