Netlify MCP integration for AI agents.
Connect AI agents to Netlify through 19 structured actions, including get account, create site build, and cancel deploy. Review authentication, inputs, workf…
- ACTION CONTRACTS
- 19
- AUTHENTICATION
- OAuth 2.0 + API key
- SOURCE STATUS
- Provider-backed
CATALOG SOURCE REVIEWED AUGUST 23, 2026 / ACTION NAMES AND SCHEMAS DERIVED FROM WORKING MACHINES PROVIDER SOURCE
CAPABILITY PROFILE
What the Netlify integration exposes
The Netlify Agent App exposes 19 provider-backed actions for developer tools work. Its current contract lets an authorized agent retrieve one netlify account membership, including billing and capability fields returned by netlify, start a netlify build for one site without uploading binary files, and cancel one netlify deploy by deploy id. These operations are called through Working Machines as typed capabilities rather than through browser navigation or copied UI steps.
A connection uses OAuth 2.0 and API key. Before execution, the agent can inspect the selected action, its required fields, declared scopes, and expected output contract. Provider credentials remain inside the Working Machines runtime; the calling agent receives the capability and its structured result, not the underlying secret.
For reliable operation, start with the narrowest action that satisfies the task, resolve stable provider identifiers before changing state, and validate the returned object or status after execution. Availability still depends on the connected Netlify account, granted provider permissions, workspace policy, region, plan, and upstream API behavior.
VERIFIED ACTION SAMPLE
Real Netlify capabilities.
Showing 12 of 19 actions. Risk labels are conservative signals based on operation names, not substitutes for provider documentation or runtime policy.
get_accountREADRetrieve one Netlify account membership, including billing and capability fields returned by Netlify.
INPUTS: accountId
create_site_buildWRITEStart a Netlify build for one site without uploading binary files.
INPUTS: siteId / branch / clearCache / image / templateId
cancel_deployHIGH IMPACTCancel one Netlify deploy by deploy ID.
INPUTS: deployId
create_site_deploy_from_zip_urlHIGH IMPACTCreate a Netlify site deploy by downloading a public zip file URL and uploading it to Netlify.
INPUTS: siteId / zipUrl / title
delete_submissionHIGH IMPACTDelete one Netlify form submission by submission ID.
INPUTS: submissionId
get_buildREADRetrieve one Netlify build by build ID.
INPUTS: buildId
get_current_userREADRetrieve the Netlify user associated with the connected credential.
get_deployHIGH IMPACTRetrieve one Netlify deploy by deploy ID.
INPUTS: deployId
get_siteREADRetrieve one Netlify site by site ID or name.
INPUTS: siteId
list_accountsREADList Netlify accounts accessible to the connected credential.
list_site_deploysREADList deploys for one Netlify site.
INPUTS: siteId / page / perPage
list_site_formsREADList forms detected for one Netlify site.
INPUTS: siteId
INPUT CONTRACTS
Know what the action needs before it runs.
get_account
accountIdREQUIRED- The Netlify account ID.
create_site_build
siteIdREQUIRED- The Netlify site ID or site name.
branchOPTIONAL- The branch to build. Omit this for a production deploy.
clearCacheOPTIONAL- Whether Netlify should clear the build cache before building.
imageOPTIONAL- The Netlify build image tag to use.
templateIdOPTIONAL- The Netlify build template ID to use.
cancel_deploy
deployIdREQUIRED- The Netlify deploy ID.
create_site_deploy_from_zip_url
siteIdREQUIRED- The Netlify site ID or site name.
zipUrlREQUIRED- The public HTTP or HTTPS URL of a zip file containing the site files. For local files, upload the file with oo file upload and pass its downloadUrl.
titleOPTIONAL- The title to attach to the deploy.
PROVIDER-SPECIFIC WORKFLOWS
Jobs this Agent App can support
Inspect Get Account
Retrieve one Netlify account membership, including billing and capability fields returned by Netlify. Use this as a bounded discovery step, retain the returned identifier, and avoid expanding the read beyond the task's stated scope.
get_accountControl Create Site Build
Start a Netlify build for one site without uploading binary files. Resolve the target first, present material changes for confirmation, and make retries idempotent where the provider supports it.
create_site_buildVerify with Get Build
Retrieve one Netlify build by build ID. Compare the returned provider state with the intended outcome and preserve stable IDs or canonical links in the run record.
get_buildSAFETY BOUNDARY
Operate Netlify with explicit limits
- Authorize Netlify with OAuth 2.0 and API key and grant only the provider access required by the selected actions.
- 10 actions are change-capable by name. Confirm the target identity and material parameters before allowing a write.
- Treat `cancel_deploy`, `create_site_deploy_from_zip_url`, and `delete_submission` as high-impact operations and require an explicit approval boundary.
- No provider scope string is declared on the sampled actions. Verify the connected account's actual permissions in Netlify rather than assuming unrestricted access.
- After a call, inspect the structured result and execution record before reporting that the Netlify task completed successfully.
CONNECTION MODEL
OAuth 2.0 + API key
Netlify personal access token used with the Authorization Bearer header. Create or manage tokens from User settings under Applications > Personal access tokens.
Working Machines stores provider credentials behind the execution boundary. An agent can use an authorized connection identity, but catalog discovery alone does not reveal OAuth tokens, API keys, or provider secrets.
- READ SIGNALS
- 9
- WRITE SIGNALS
- 2
- HIGH IMPACT
- 8
- REVIEW SIGNALS
- 0
EVIDENCE AND AVAILABILITY
Provider reference
Action names, input fields, authentication types, and counts on this page are generated from the Working Machines provider catalog. Provider behavior, quotas, object semantics, account eligibility, and regional availability remain governed by Netlify.