Netlify through One
Netlify is a frontend-first cloud platform that lets developers seamlessly build, deploy, preview, and scale modern web applications using Git-based workflows, serverless functions, edge caching, and a global CDN—empowering teams to ship fast, secure, and high-performance sites at scale.
One exposes Netlify through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.
How to run an action
- Find the action in the table below, or call
search_one_platform_actions with platform netlify if it is not listed.
- Call
get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
- Call
execute_one_action with parameters copied from that knowledge.
Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.
Before you start
Call list_one_integrations once and confirm Netlify is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.
Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.
Before a write
Creates, updates, deletes and sends land on a real Netlify account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.
Actions
Sites
| Action |
Method |
Path |
Action id |
| Get a Site |
GET |
/sites/{{siteId}} |
conn_mod_def::GJ5BP3MVSVU::cPHqsYEDTNCklvPq6dSOGg |
| Get a Site’s Metadata |
GET |
/sites/{{siteId}}/metadata |
conn_mod_def::GJ5BPMhEr_w::VJYypWfqQbyocUquDBowvQ |
| List an Account’s Sites |
GET |
/{{accountSlug}}/sites |
conn_mod_def::GJ5BP4U4r20::-TzZoanlQZe9PHZi00RULQ |
| List Sites |
GET |
/api/v1/sites |
conn_mod_def::GJ5BP3pIYwA::sqd9N8qzRMGEmGLiLpihQg |
| Configure DNS for a Site |
PUT |
/sites/{{siteId}}/dns |
conn_mod_def::GJ5BOPS3W5s::NTMdJ8OwSmqicMqvdKO2Ow |
| Create a Site |
POST |
/api/v1/sites |
conn_mod_def::GJ5BPtjXdnc::PGQCpw4CSsyX842UHit26Q |
| Create a Site in a Team (Account) |
POST |
/{{accountSlug}}/sites |
conn_mod_def::GJ5BPuh05iU::pjgiz81eSDiRv9-oJ-ZCGw |
| Delete a Site |
DELETE |
/sites/{{siteId}} |
conn_mod_def::GJ5BPviJMK8::avmM_QygRau0rwZ4qY8cMw |
| Disable a Site |
PUT |
/sites/{{siteId}}/disable |
conn_mod_def::GJ5BPtKxVxY::K9LAHER6R5CRLd9Sai1xLw |
| Enable a Site |
PUT |
/sites/{{siteId}}/enable |
conn_mod_def::GJ5BP6YS5lQ::xT9JZYXaTWS4ShOY43eAjA |
| Roll Back a Site’s Deploy |
PUT |
/sites/{{siteId}}/rollback |
conn_mod_def::GJ5BNZXSnxg::qu8MoaigRQSi9phXDYtGqQ |
| Unlink a Site’s Repository |
PUT |
/sites/{{siteId}}/unlink_repo |
conn_mod_def::GJ5BP24FYPI::p8z0pnphTjqemvW8aRd0_Q |
2 more Sites actions are available through search.
Deploys
| Action |
Method |
Path |
Action id |
| Get a Deploy |
GET |
/deploys/{{deployId}} |
conn_mod_def::GJ5BNHj0f6U::1neMKLL4SYWcUf1z4n7Oug |
| Get a Site Deploy |
GET |
/sites/{{siteId}}/deploys/{{deployId}} |
conn_mod_def::GJ5BNH9AY5g::Xulk3DVFT8y7RAVHbdPaYQ |
| List a Site’s Deploys |
GET |
/sites/{{siteId}}/deploys |
conn_mod_def::GJ5BNhBR864::LQxDsUUZTpCw4g-A0puhng |
| Cancel a Site Deploy |
POST |
/deploys/{{deployId}}/cancel |
conn_mod_def::GJ5BM7gBa78::2lDXWxoLSAO_VENjKkVP0A |
| Create a Site Deploy |
POST |
/sites/{{siteId}}/deploys |
conn_mod_def::GJ5BNKCPGL0::BleJube2SSi0hNuBEglgVQ |
| Delete a Deploy |
DELETE |
/deploys/{{deployId}} |
conn_mod_def::GJ5BNHU-Ft0::cH7TSlbZTXSd9nJUnwCaIw |
| Delete a Site Deploy |
DELETE |
/sites/{{siteId}}/deploys/{{deployId}} |
conn_mod_def::GJ5BNSE2_DE::8E5FFCPpQrCRcD-7I9OV3Q |
| Lock a Deploy |
POST |
/deploys/{{deployId}}/lock |
conn_mod_def::GJ5BNbTuKW4::jDcmmfhCSZWaJI6A9GhSxw |
| Restore a Site Deploy |
POST |
/sites/{{siteId}}/deploys/{{deployId}}/restore |
conn_mod_def::GJ5BNZRyilE::xaNbWnXxTxKiWLQpNqzxvA |
| Unlock a Deploy |
POST |
/deploys/{{deployId}}/unlock |
conn_mod_def::GJ5BNaB6Sdw::C8YrxmPQTlONK64_dlL8mg |
| Update a Site’s Deploy |
PUT |
/sites/{{siteId}}/deploys/{{deployId}} |
conn_mod_def::GJ5BNq94u40::u6VYXPTeRg-Yi1Jefwi6Yw |
AgentRunners
| Action |
Method |
Path |
Action id |
| Get an Agent Runner |
GET |
/agent_runners/{{agentRunnerId}} |
conn_mod_def::GJ5BL45z_co::4A1n-GvBRQyvpwRO0C9vUg |
| List Agent Runners |
GET |
/agent_runners |
conn_mod_def::GJ5BL-u-JCM::5FsDTREHTiyl9tWEgOmgjA |
| Archive an Agent Runner |
POST |
/agent_runners/{{agentRunnerId}}/archive |
conn_mod_def::GJ5BLqy5vx8::UatZv6ZFQhePCku0Imb2IQ |
| Create an Agent Runner |
POST |
/api/v1/agent_runners |
conn_mod_def::GJ5BLuHS_ag::7ksCd2PySwCaV5LRej-m5w |
| Delete an Agent Runner |
DELETE |
/agent_runners/{{agentRunnerId}} |
conn_mod_def::GJ5BLq0mFXA::Rdo8ajEjRheumNsyjbrBwQ |
| Update an Agent Runner |
PATCH |
/agent_runners/{{agentRunnerId}} |
conn_mod_def::GJ5BL5dsW2I::94ZnQMn5TeqIjleaNTXf5A |
Hooks
| Action |
Method |
Path |
Action id |
| Get a Hook |
GET |
/hooks/{{hookId}} |
conn_mod_def::GJ5BPE_Sa5w::QDwdqN4IR6OeMs5lTNLFTQ |
| List a Site’s Hooks |
GET |
/hooks |
conn_mod_def::GJ5BPFnG6eQ::vHFDWs-HREqlfU_mJ6fptQ |
| Create a Hook for a Site |
POST |
/hooks |
conn_mod_def::GJ5BO9q5Tkc::qULS1xsATvi3QHBUkD2urg |
| Delete a Hook |
DELETE |
/hooks/{{hookId}} |
conn_mod_def::GJ5BO8EiBFo::-VwmSnYdQDqtElGtDuHXBQ |
| Enable a Hook |
POST |
/hooks/{{hookId}}/enable |
conn_mod_def::GJ5BO8-0WBw::ys3Gs5X1Tju4NMDoodryRw |
| Update a Hook |
PUT |
/hooks/{{hookId}} |
conn_mod_def::GJ5BPFLrCmM::z8bFYYqMQEaC8MJcEQc9mQ |
TrafficSplits
| Action |
Method |
Path |
Action id |
| Get a Site’s Traffic Split Test |
GET |
/sites/{{siteId}}/traffic_splits/{{splitTestId}} |
conn_mod_def::GJ5BQVCJB3Q::zFqCZoPmRTe-0IYlq1Hcjg |
| List a Site’s Traffic Split Tests |
GET |
/sites/{{siteId}}/traffic_splits |
conn_mod_def::GJ5BQU5XXNo::a1z9y4cKRCiRRAAuk55TXg |
| Create a Site Traffic Split Test |
POST |
/sites/{{siteId}}/traffic_splits |
conn_mod_def::GJ5BQMlkel4::jvHeHqOCTCi3JX27Bja06A |
| Disable a Site’s Split Test (Unpublish Traffic Split) |
POST |
/sites/{{siteId}}/traffic_splits/{{splitTestId}}/unpublish |
conn_mod_def::GJ5BQaqQ17E::TN0qCyaZSQSlzyTz2-B-Uw |
| Enable a Site’s Traffic Split Test (Publish) |
POST |
/sites/{{siteId}}/traffic_splits/{{splitTestId}}/publish |
conn_mod_def::GJ5BQUgqKxQ::7ukQfEQzTP6gKr2ISBQl-g |
| Update a Site’s Traffic Split Test |
PUT |
/sites/{{siteId}}/traffic_splits/{{splitTestId}} |
conn_mod_def::GJ5BQUntYgc::cKEPWTnvSN6l4ZAzru3KDQ |
Accounts
| Action |
Method |
Path |
Action id |
| Get an Account |
GET |
/accounts/{{accountId}} |
conn_mod_def::GJ5BLiajL4g::dNr87XXYQ321zmbAJQyTeA |
| List Accounts for the Authenticated User |
GET |
/accounts |
conn_mod_def::GJ5BLjACo9w::OTWsClazRmqGBD3u9dH9Ow |
| Cancel an Account |
DELETE |
/accounts/{{accountId}} |
conn_mod_def::GJ5BLiLk7yI::6KjoeLjnTQmQC2tP7l7CyQ |
| Create Account |
POST |
/api/v1/accounts |
conn_mod_def::GJ5BLiS-958::IMJRZkFXRJCJycin10zaAw |
| Update an Account |
PUT |
/accounts/{{accountId}} |
conn_mod_def::GJ5BLquMdGk::udWNOsOgSGaRfCISlJLQ4g |
AgentRunnerSessions
| Action |
Method |
Path |
Action id |
| Get an Agent Runner Session |
GET |
/agent_runners/{{agentRunnerId}}/sessions/{{agentRunnerSessionId}} |
conn_mod_def::GJ5BMGhm5XA::Kj6kVLWyTwqWaUr-my6qqg |
| List an Agent Runner’s Sessions |
GET |
/agent_runners/{{agentRunnerId}}/sessions |
conn_mod_def::GJ5BMIO4v_Y::nbdlubJqSkOD0S2NAAvk1A |
| Create an Agent Runner Session |
POST |
/agent_runners/{{agentRunnerId}}/sessions |
conn_mod_def::GJ5BL9Gc57g::1s3_tFStQnSX8--ca9ofrw |
| Delete an Agent Runner Session |
DELETE |
/agent_runners/{{agentRunnerId}}/sessions/{{agentRunnerSessionId}} |
conn_mod_def::GJ5BL5Nb460::GowRcikUQNqzksg7lT79dw |
| Update an Agent Runner Session |
PATCH |
/agent_runners/{{agentRunnerId}}/sessions/{{agentRunnerSessionId}} |
conn_mod_def::GJ5BMKtMaL0::q-sCeiTVT1Wv21KO-lAz5A |
SiteAssets
| Action |
Method |
Path |
Action id |
| Get a Site Asset's Info |
GET |
/sites/{{siteId}}/assets/{{assetId}} |
conn_mod_def::GJ5BMSOq1eI::7x1YV4ZCScy9gWogpbKXUg |
| Get a Site Asset’s Public Signature |
GET |
/sites/{{siteId}}/assets/{{assetId}}/public_signature |
conn_mod_def::GJ5BMlOnoy4::pJbhVd2cT4CmV88_yJFMGA |
| Create a Site Asset |
POST |
/sites/{{siteId}}/assets |
conn_mod_def::GJ5BMS1WLDQ::rSBLqafSStmqrxlMCOHrqw |
| Delete a Site Asset |
DELETE |
/sites/{{siteId}}/assets/{{assetId}} |
conn_mod_def::GJ5BMdmxTjA::c0L6AFqDSyeYMOdY9MbZiw |
| Update a Site Asset |
PUT |
/sites/{{siteId}}/assets/{{assetId}} |
conn_mod_def::GJ5BMoN3Hvg::HanKpQgPQv68d8apwwZgPA |
BuildHooks
| Action |
Method |
Path |
Action id |
| Get a Site’s Build Hook |
GET |
/sites/{{siteId}}/build_hooks/{{id}} |
conn_mod_def::GJ5BNASfidU::vUYztyuBS_u6un51xhsKCQ |
| List a Site’s Build Hooks |
GET |
/sites/{{siteId}}/build_hooks |
conn_mod_def::GJ5BM7G9PS0::0jUT_SQwQLqUBcNyBRVivg |
| Create a Site Build Hook |
POST |
/sites/{{siteId}}/build_hooks |
conn_mod_def::GJ5BMz487UE::o_tbgWd6RMKuXFWP2agnww |
| Delete a Site Build Hook |
DELETE |
/sites/{{siteId}}/build_hooks/{{id}} |
conn_mod_def::GJ5BMyo_-5k::64Mf9uDDR-GYrmPygoqcgw |
| Update a Site’s Build Hook |
PUT |
/sites/{{siteId}}/build_hooks/{{id}} |
conn_mod_def::GJ5BM7Xwczs::qKqv6Lg8QA-y12J0kM1jBA |
DevServers
| Action |
Method |
Path |
Action id |
| Get a Site’s Dev Server |
GET |
/sites/{{siteId}}/dev_servers/{{devServerId}} |
conn_mod_def::GJ5BN32bmjA::bJCJtwCiRyGIYso21Jk-Wg |
| List a Site’s Dev Servers |
GET |
/sites/{{siteId}}/dev_servers |
conn_mod_def::GJ5BN7O6nng::twQtZFtbTXuRZpoRmiWkjA |
| Create a Site Dev Server |
POST |
/sites/{{siteId}}/dev_servers |
conn_mod_def::GJ5BN4NuDl0::KeLtGE_kTr6thGTv-42H6w |
| Delete a Site’s Dev Servers |
DELETE |
/sites/{{siteId}}/dev_servers |
conn_mod_def::GJ5BN8Ck8DI::mEg3aHqqSqekw-08YqOyyg |
| Update a Site Dev Server’s State |
POST |
/sites/{{siteId}}/dev_servers/{{devServerId}}/state |
conn_mod_def::GJ5BOF89PSw::3EQLChusSKqBrZkOPeNG1A |
DevServerHooks
| Action |
Method |
Path |
Action id |
| Get a Site’s Dev Server Hook |
GET |
/sites/{{siteId}}/dev_server_hooks/{{id}} |
conn_mod_def::GJ5BOEmO3rU::5QLaOpP3RIaqfDMkqO8vcw |
| List a Site’s Dev Server Hooks |
GET |
/sites/{{siteId}}/dev_server_hooks |
conn_mod_def::GJ5BOFd6R9c::8QHF3U8nS-2-tcwYniRItg |
| Create a Site Dev Server Hook |
POST |
/sites/{{siteId}}/dev_server_hooks |
conn_mod_def::GJ5BOGJoPZA::xX0tZ6oISseD_o8254_CTA |
| Delete a Site’s Dev Server Hook |
DELETE |
/sites/{{siteId}}/dev_server_hooks/{{id}} |
conn_mod_def::GJ5BOGww7j0::ABloXb8FRzupxccexoVy3A |
| Update a Site’s Dev Server Hook |
PUT |
/sites/{{siteId}}/dev_server_hooks/{{id}} |
conn_mod_def::GJ5BOOZiDPY::B1uXVkFxRHKE41ezj8p17w |
DnsZones
| Action |
Method |
Path |
Action id |
| Get a DNS Zone |
GET |
/dns_zones/{{zoneId}} |
conn_mod_def::GJ5BOb0bpEE::Sh4V_MEXQ3anQpEP_YQJ-g |
| List DNS Zones |
GET |
/dns_zones |
conn_mod_def::GJ5BOW4QqZw::oQQ8ZvqoQZSYESsF0q1BYA |
| Create a DNS Zone |
POST |
/dns_zones |
conn_mod_def::GJ5BOOH2-sI::H1C3zQX0TvGNao8uSn9f1A |
| Delete a DNS Zone |
DELETE |
/dns_zones/{{zoneId}} |
conn_mod_def::GJ5BOW90TCI::-X5w3pfxQe6zd7z3HzxE_g |
| Transfer a DNS Zone to Another Account or User |
PUT |
/dns_zones/{{zoneId}}/transfer |
conn_mod_def::GJ5BOklttOk::MY-jMyEeQs2ida3pQeobeA |
Builds
| Action |
Method |
Path |
Action id |
| Get a Site Build |
GET |
/builds/{{buildId}} |
conn_mod_def::GJ5BMvbxIZk::wxE5og6FT5Sob990i_8gIg |
| List a Site’s Builds |
GET |
/sites/{{siteId}}/builds |
conn_mod_def::GJ5BMyrQ19E::P0FBHSj9Tq2cFN5le0p5jg |
| Notify a Build's Start |
POST |
/builds/{{buildId}}/start |
conn_mod_def::GJ5BMwY0AZM::yV5JvGTeSDSpjGp6oOdSzw |
| Run a Site Build |
POST |
/sites/{{siteId}}/builds |
conn_mod_def::GJ5BMmwM68c::IxAx0DFtR3uWo9KBAL3etw |
DeployKeys
| Action |
Method |
Path |
Action id |
| Get a Deploy Key |
GET |
/deploy_keys/{{keyId}} |
conn_mod_def::GJ5BNwPbw0Q::F8Q9_-RBRvqHTuAuqr2Xfg |
| List Deploy Keys |
GET |
/deploy_keys |
conn_mod_def::GJ5BN5kBGWU::ofABgZGIS3qIQMUwnagrfQ |
| Create a Deploy Key |
POST |
/api/v1/deploy_keys |
conn_mod_def::GJ5BNuFFC5c::6GHR6Y7zTN2DNxhC0ycc1w |
| Delete a Deploy Key |
DELETE |
/deploy_keys/{{keyId}} |
conn_mod_def::GJ5BNo-j8Cw::u0UX1c8OTwOPVfTQDtnp_w |
DnsRecords
| Action |
Method |
Path |
Action id |
| Get an Individual DNS Record in a DNS Zone |
GET |
/dns_zones/{{zoneId}}/dns_records/{{dnsRecordId}} |
conn_mod_def::GJ5BOkO_JXw::jNXpg2CzRvWSeQenRWHxEA |
| List a DNS Zone’s DNS Records |
GET |
/dns_zones/{{zoneId}}/dns_records |
conn_mod_def::GJ5BOXjpNco::TBgHeTpwTtSL_bx5ipS7QQ |
| Create a DNS Record in a DNS Zone |
POST |
/dns_zones/{{zoneId}}/dns_records |
conn_mod_def::GJ5BOQASC4A::znzONZvzRmKb2wyQXBKTgQ |
| Delete a DNS Record in a DNS Zone |
DELETE |
/dns_zones/{{zoneId}}/dns_records/{{dnsRecordId}} |
conn_mod_def::GJ5BOOJ8e28::WoVFsrLQTJim6sC5Hqewsw |
AccountEnvironmentVariables
| Action |
Method |
Path |
Action id |
| Get an Account Environment Variable |
GET |
/accounts/{{accountId}}/env/{{key}} |
conn_mod_def::GJ5BOtaD-zw::BFkEu-guR9qT7Dec6ROcWQ |
| List an Account’s Environment Variables |
GET |
/accounts/{{accountId}}/env |
conn_mod_def::GJ5BOsfhqAw::mp3pqIfYQFG-mowGTDPtsg |
2 more AccountEnvironmentVariables actions are available through search.
This lists 90 of 147 actions. For anything not here, call search_one_platform_actions with platform netlify. The full catalog is at https://www.withone.ai/knowledge/netlify.
When a call fails
The error comes from Netlify, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.
Full catalog: https://www.withone.ai/knowledge/netlify
Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.
withoneai