Home / Servers / Netlify API / create_site_build

Start a build

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

Start a build Runs a build for a site. The build will be scheduled to run at the first opportunity, but it might not start immediately if insufficient account build capacity is available. Files for build can be… [POST /sites/{site_id}/builds]

Name on the gateway: netlify_api__create_site_build · may change things.

Parameters

NameTypeDescription
site_id requiredstringsite_id parameter
branchstringIf no branch is specified, it is treated as a production deploy If a branch IS…
clear_cachebooleanWhether to clear the build cache before building
commit_shastringThe commit SHA to build; when omitted, the head of the branch or pull request…
draftbooleanWhether to create a draft deploy, which uses the deploy-preview context and is…
imagestringThe build image tag to use for the build
review_idintegerThe merge/pull request ID to build; triggers a deploy preview. Ignored for zip…
template_idstringThe build template to use for the build
titlestringThe title of the build
zipstringA zip file containing the site files to build. Only used with Content-Type…

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__create_site_build",
  "arguments": {
    "site_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 start a build tool with site_id set to ….

More from Netlify API