Cloady
OfficialThis MCP server exposes the Cloady API as AI-assistant tools for inspecting and managing Cloady resources, subject to API token scope and workspace role.
Get the authenticated user, list regions/workspaces, create/update/delete workspaces, and check slug availability.
Deploy, update, redeploy, roll back, transfer, and delete apps; inspect services, logs, status, metrics, deploys, branches, backups, and restore backups.
Manage environment variables, app/workspace domains, TLS certificate statuses, volumes, and volume credentials.
Run shell commands, create SSH sessions, query databases, read DB credentials/schema, and manage S3 sessions.
Inspect Git state/diffs and perform Git actions such as stage, commit, checkout, merge, rebase, revert, cherry-pick, pull, and push.
Manage billing/plans, payment setup, account billing state, API tokens, notification preferences, passwords, phone verification, and MFA.
Manage workspace members, invitations, ownership, GitHub integrations/repos, and support tickets/messages.
Browse templates, tiers, and pricing, and accept or decline invitations.
Links a GitHub App installation to a Cloady workspace and gives tools to search and list GitHub repositories and branches, so deploys can be configured from GitHub git sources and auto-deploy settings managed; installations can also be disconnected from the workspace.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
@cloady/mcp
Local MCP server for Cloady — gives AI assistants the whole Cloady API as tools: workspaces, apps, deploys, environment variables, domains, volumes, members, integrations, billing and support tickets.
Generated from Cloady's OpenAPI contract, so every REST operation is a tool named after its operation id (listVars, createVar, deployApp, execCommand). It runs over stdio and calls https://cloady.com with your API token.
Setup
For the OAuth-based Claude plugin, see Cloady for Claude. It connects to the hosted MCP endpoint without installing the npm server or copying an API token.
Gemini CLI extension
Install the extension from this repository:
gemini extensions install https://github.com/Cloady/cloady-mcpOpen Gemini CLI and run /mcp auth cloady to sign in to Cloady through OAuth. Complete any required account verification and choose the narrowest scope for your task: read, deploy, or full. No API key or local npm server is needed for this extension.
Try "List my Cloady workspaces and running apps", "Explain the latest deployment failure from my app's build logs", or "Show available database templates and pricing before creating anything."
The extension sends tool arguments to https://cloady.com/api/mcp and returns permitted results to Gemini. These can include account and workspace metadata, application configuration, code, logs, metrics, database content, and support messages, depending on the tools you request. Google handles received results under its own policies; Cloady's handling, retention, and deletion are described in the Privacy Policy. An account-level connection can cover all workspaces the account belongs to, subject to scope and workspace role. Revoke its token in Cloady Account → API tokens to stop future requests. Revocation does not delete hosted data or copies already received by Gemini.
Review the target workspace, app, environment, region, and any charges before authorizing changes. Write tools can change or delete resources. The extension is free; hosted resources follow Cloady pricing. Support and deletion requests: hello@cloady.com.
The Gemini extension and Claude plugin are versioned separately from the local npm package.
Qwen Code
Qwen Code supports Gemini CLI extensions and converts their manifest during installation:
qwen extensions install https://github.com/Cloady/cloady-mcpUse Cloady's OAuth connection in your client. The same account permissions, data handling, and hosting charges described above apply. See Qwen Code's extension documentation.
Local stdio package
Create an API token in the dashboard under Account → API tokens.
Claude Code
claude mcp add cloady -e BEARER_TOKEN_CLOADY=cldy_… -- npx -y @cloady/mcpClaude Desktop / Cursor / any MCP client
{
"mcpServers": {
"cloady": {
"command": "npx",
"args": ["-y", "@cloady/mcp"],
"env": { "BEARER_TOKEN_CLOADY": "cldy_…" }
}
}
}API_BASE_URL overrides the target if you run Cloady elsewhere.
Related MCP server: Coolify MCP Server
Tools
One per API operation. Arguments are the operation's path parameters, query parameters and body fields flattened into one object, so createVar takes workspaceSlug, appSlug, env, region, key, value and isSecret.
The token's scope (read / deploy / full) and your workspace role are enforced by the API on every call, exactly as they are for the dashboard and the SDKs.
Docs
Full reference at cloady.com/docs.
Distribution
This repository contains the source and build published as @cloady/mcp@0.18.0 on npm, plus directory packaging. Run npm install and npm start. The Cursor plugin uses the pinned npm release. MCPB bundles include production dependencies.
Privacy Policy
This local server forwards tool arguments to the Cloady API using your configured API token. See Cloady Privacy Policy for data handling and contact information. Use the minimum necessary token scope; write tools can change or delete resources.
The 0.18.0 desktop bundle adds tool titles and conservative read/write annotations to the 0.18.0 API implementation. The Cursor configuration uses the published npm 0.18.0 release.
Available Tools
160 toolsacceptInvitationAccept InvitationBDestructiveInspect
Accept a workspace invitation
Inputs: token (required).
addTicketMessageAdd Ticket MessageCDestructiveInspect
Add a message to a support ticket
Inputs: id (required), requestBody.
analyzeDeployAnalyze DeployADestructiveInspect
The AI reads the failed deploy's log, the failing containers' latest output, the names of the source's files, the compose file and the app's variables (never a secret's value), looks further with the read-only API tools when it needs to, and lists what went wrong. A problem's changes would fix it: a variable that isn't secret set to a value, a variable renamed (its value moves with it, secret or not), or new scale factors. Nothing is changed: apply them with createVar, updateVar and updateApp, then deploy again. Counts against the caller's 60 AI answers an hour.
Inputs: appSlug (required), deployId (required), workspaceSlug (required), env, +1 more.
askAiAsk AiADestructiveInspect
Public: without credentials a caller gets 7 answers a day per IP address. An API key or a signed-in session gets 60 an hour and answers about its own account, and can build: the AI writes files, uploads them and deploys them, which a read-scope key cannot. A key that isn't valid is refused rather than answered anonymously. Requests with deployment tools can take up to two hours; read-only and anonymous requests have a ten-minute deadline. Set the client timeout accordingly. deploy names a template, repository or image the answer suggests deploying. To carry the conversation on with Cloady support, open a ticket with createTicket: the AI answers it first.
Inputs: requestBody.
checkDnsCheck DnsARead-onlyInspect
The addresses a custom domain must point at and, with host, whether it already does and whether another app holds it. Public: no token needed.
Inputs: host.
checkDomainsCheck DomainsARead-onlyInspect
Checks a name across popular extensions, with what registering each costs on Cloady. q is a name (acme) or a domain (acme.dev): the name searched for comes first, with .com when no extension was typed, then the same name under other extensions, then free variants of it. Availability comes from each registry's RDAP server, or from DNS where an extension has none, so registerDomain's dry run has the final word, on premium names too. With exact, only the name searched for is checked. Public: no token needed.
Inputs: q (required), exact.
checkMailDomainsCheck Mail DomainsBRead-onlyInspect
Finds the domains the service sends from (Postfix's log and myorigin, or Stalwart's own domain list) and checks each in public DNS: SPF evaluated against the address the mail leaves from, DKIM keys for the selectors seen signing, DMARC policy and MX. Also reverse DNS of that address, the certificate offered after STARTTLS, and the address on Spamhaus, Barracuda, SpamCop and UCEPROTECT, and for Stalwart the DMARC aggregate reports it received. The address belongs to the node and is shared by every app on it. Runs the checks on every call.
Inputs: appSlug (required), serviceName (required), workspaceSlug (required), env, +3 more.
checkoutGitBranchCheckout Git BranchADestructiveInspect
Switch the working tree to a branch with git switch, so the name is never read as a path. A branch that exists only on the remote is checked out tracking it, and create makes a new branch at the current commit. Refuses when uncommitted changes would be overwritten; other uncommitted changes come along. Works only on a development app: any other app answers 403 read_only. Runs git in the app's running container and returns its output.
Inputs: appSlug (required), workspaceSlug (required), env, region, +1 more.
checkWorkspaceSlugCheck Workspace SlugARead-onlyInspect
Returns the slug that would actually be used; suffixed is true when the requested one was taken and a numeric suffix was added.
Inputs: slug (required).
cherryPickGitCommitCherry Pick Git CommitADestructiveInspect
Apply the given commit to the current branch as a new commit. Refused while another merge, rebase, revert or cherry-pick is in progress. If the cherry-pick fails, it is aborted and the call fails. Works only on a development app: any other app answers 403 read_only. Runs git in the app's running container and returns its output.
Inputs: appSlug (required), workspaceSlug (required), env, region, +1 more.
commitGitChangesCommit Git ChangesADestructiveInspect
Commit the given paths, staged or not, and nothing else: changes staged at other paths stay staged. Paths are literal, never patterns, and a deleted path commits its deletion. Fails if any of the paths has no change. Without paths, commits every change, untracked files included. While a merge is in progress, git can only commit the whole merge, so the staged index is committed and paths is not used. The commit stays in the app's copy of the repository, which Cloady can't push to the remote. Works only on a development app: any other app answers 403 read_only. Runs git in the app's running container and returns its output.
Inputs: appSlug (required), workspaceSlug (required), env, region, +1 more.
contactSupportContact SupportADestructiveInspect
Send a message to Cloady support without an account. Public: no token needed.
Inputs: requestBody.
createAlertCreate AlertCDestructiveInspect
p95 and errors exist only for the service the app's address routes to. A rule that fires emails members who keep incident emails on (when email) and posts to its channels. Answers 400 bad_rule when the rule does not fit the metric.
Inputs: appSlug (required), workspaceSlug (required), env, region, +1 more.
createAppDeployCreate App DeployBDestructiveInspect
Trigger a new deployment for an app
Inputs: appSlug (required), workspaceSlug (required), env, region, +1 more.
createChannelCreate ChannelCDestructiveInspect
Slack and webhook channels take url, PagerDuty takes routingKey. Needs the admin role.
Inputs: appSlug (required), workspaceSlug (required), env, region, +1 more.
createDnsRecordCreate Dns RecordADestructiveInspect
Adds a record to a domain registered through Cloady in this workspace, or under an application's cloady.io address. On a registered domain, A, AAAA, ALIAS and CNAME records on the domain itself and on * are Cloady's. Under an address, records go on a name below it, like mail or _verify, and ALIAS, CAA and NS aren't allowed; the first one also gives the address itself a CNAME to Cloady, because a name with records below it no longer matches the wildcard. Records reach the internet within the TTL; a record the registrar refuses, such as a CNAME beside other records on the same name, answers 400 with its reason. Needs the developer role.
Inputs: domain (required), workspaceSlug (required), requestBody.
createDomainCreate DomainCDestructiveInspect
Create a new domain for an app
Inputs: appSlug (required), workspaceSlug (required), env, region, +1 more.
createSshSessionCreate Ssh SessionBDestructiveInspect
Create a short-lived SSH session credential for a running container.
Inputs: appSlug (required), workspaceSlug (required), env, region, +1 more.
createTicketCreate TicketCDestructiveInspect
The AI answers the ticket first, and each new message from its author, until someone from the Cloady team replies. The team reads every ticket.
Inputs: requestBody.
createTokenCreate TokenBDestructiveInspect
Create a new API token for the current user
Inputs: requestBody.
createUploadCreate UploadADestructiveInspect
Send each file's path and content, or its path and the upload to take it from (fromUpload, as for a picture from generateImage). The response's uploadId goes into deployApp or inspectSource as source { type: "upload", uploadId }. A single .zip file is taken as the whole project. Up to 3000 files and 50 MB; an upload that no app uses within three hours is deleted.
Inputs: workspaceSlug (required), requestBody.
createVarCreate VarCDestructiveInspect
Create a new environment variable or credential
Inputs: appSlug (required), workspaceSlug (required), env, region, +1 more.
createWorkspaceCreate WorkspaceBDestructiveInspect
Create a workspace (requires full scope)
Inputs: requestBody.
createWorkspaceInvitationCreate Workspace InvitationCDestructiveInspect
Send workspace invitation
Inputs: workspaceSlug (required), requestBody.
declineInvitationDecline InvitationBDestructiveInspect
Decline a workspace invitation
Inputs: token (required).
deleteAlertDelete AlertCDestructiveInspect
Past incidents stay in the history.
Inputs: alertId (required), appSlug (required), workspaceSlug (required), env, +1 more.
deleteAppDelete AppADestructiveInspect
Delete an app and purge its data
Inputs: appSlug (required), workspaceSlug (required), env, region.
deleteChannelDelete ChannelCDestructiveInspect
Also removes it from every alert rule of the app that posts to it.
Inputs: appSlug (required), channelId (required), workspaceSlug (required), env, +1 more.
deleteDnsRecordDelete Dns RecordADestructiveInspect
Deletes a record from a domain registered through Cloady in this workspace, or from under an application's cloady.io address. Answers 409 for a record Cloady manages. Needs the developer role.
Inputs: domain (required), recordId (required), workspaceSlug (required).
deleteDomainDelete DomainCDestructiveInspect
Delete a domain from an app
Inputs: appSlug (required), domainId (required), workspaceSlug (required), env, +1 more.
deleteTemplateReviewDelete Template ReviewCDestructiveInspect
Delete your review of a template
Inputs: slug (required).
deleteVarDelete VarADestructiveInspect
Delete an environment variable or credential
Inputs: varId (required), appSlug (required), workspaceSlug (required), env, +1 more.
deleteWorkspaceDelete WorkspaceBDestructiveInspect
Delete a workspace (requires full scope)
Inputs: workspaceSlug (required).
deleteWorkspaceSsoDelete Workspace SsoCDestructiveInspect
Remove single sign-on from the workspace
Inputs: workspaceSlug (required).
deployAppDeploy AppCDestructiveInspect
Creates the app and starts its first deploy.
Inputs: workspaceSlug (required), requestBody.
disableTotpDisable TotpBDestructiveInspect
Turn off sign-in codes from an authenticator app
Inputs: no named parameters.
discardGitChangesDiscard Git ChangesADestructiveInspect
Discard every change at the given paths: edited and deleted files go back to the last commit, and new files are deleted, staged or not. Paths are literal, never patterns. Fails before changing anything if a path has no change, and afterwards, naming what is left, if any of those paths still shows one. The discarded work can't be recovered. Works only on a development app: any other app answers 403 read_only. Runs git in the app's running container and returns its output.
Inputs: appSlug (required), workspaceSlug (required), env, region, +1 more.
disconnectGithubIntegrationDisconnect Github IntegrationCDestructiveInspect
Disconnect GitHub integration from workspace
Inputs: workspaceSlug (required).
enableEngineInsightsEnable Engine InsightsADestructiveInspect
Turns on what streamEngineStats lists as off. Postgres: adds pg_stat_statements to shared_preload_libraries and restarts the service, then creates the extension in the postgres database on a second call, and logs statements slower than 250 ms with lock waits, through ALTER SYSTEM. MySQL and MariaDB: the statement history consumer and deadlock printing at runtime, and on MariaDB user statistics. Never resets any counter.
Inputs: appSlug (required), serviceName (required), workspaceSlug (required), env, +1 more.
enableTotpEnable TotpADestructiveInspect
Takes the key from startTotpSetup and a current code from the app. From then on every sign-in asks for a code from the app.
Inputs: requestBody.
endEngineSessionEnd Engine SessionADestructiveInspect
Cancels the statement a session is running (mode=cancel) or ends its connection (mode=terminate, the default): pg_cancel_backend or pg_terminate_backend, KILL QUERY or KILL, killOp on MongoDB, KILL QUERY on ClickHouse. sessionId comes from streamEngineSessions.
Inputs: appSlug (required), sessionId (required), serviceName (required), workspaceSlug (required), +3 more.
execCommandExec CommandCDestructiveInspect
Run a one-off shell command in a running container (kubernetes exec).
Inputs: appSlug (required), workspaceSlug (required), env, region, +1 more.
explainEngineStatementExplain Engine StatementCDestructiveInspect
Plans a statement from streamEngineStatements without running it: EXPLAIN (GENERIC_PLAN) in a read-only transaction on Postgres 16 and later, EXPLAIN FORMAT=JSON on the digest's sample text on MySQL. Flags a sequential scan with a filter on a table of 10,000 rows or more and suggests an index built from the plan's columns.
Inputs: appSlug (required), serviceName (required), workspaceSlug (required), env, +2 more.
flushServiceMailQueueFlush Service Mail QueueADestructiveInspect
Asks Postfix to attempt delivery now, for one queued message (postqueue -i) or the whole queue (postqueue -f), instead of waiting for its retry time. Requires the developer role.
Inputs: appSlug (required), serviceName (required), workspaceSlug (required), env, +2 more.
generateImageGenerate ImageADestructiveInspect
Draws one picture from a prompt and keeps it as a one-file upload. Ship it with a site by putting { path, fromUpload: uploadId } in createUpload; an upload that no app uses within three hours is deleted. At most 40 an hour per account.
Inputs: workspaceSlug (required), requestBody.
getAccountBillingGet Account BillingBRead-onlyInspect
Get account billing information including payment methods and invoices.
Inputs: no named parameters.
getAiStatusGet Ai StatusBRead-onlyInspect
Whether Ask AI is set up. Public: no token needed.
Inputs: no named parameters.
getAppRuntimesGet App RuntimesARead-onlyInspect
Returns what each compose service runs, read from its latest build log, its image's configuration and its start command, and the OpenTelemetry agent Cloady recommends loading into it, or why none. Agents exist for Node.js 18.19 and 20.6 or later, Python 3.10 or later, Java 8 or later and .NET 8 or later. Databases, caches, queues, mail servers, proxies, TCP services and functions aren't inspected. Reads public registries, so it can take a few seconds.
Inputs: appSlug (required), workspaceSlug (required), env, region.
getAppServicesGet App ServicesCRead-onlyInspect
List all services in an app instance
Inputs: appSlug (required), workspaceSlug (required), env, region.
getAppTracingGet App TracingBRead-onlyInspect
Returns the app's server monitoring mode, the OpenTelemetry variables each compose service gets while it is on, the agent Cloady loads into each service in auto mode and what it adds at start, and which services have sent spans in the last 7 days. In manual mode spans need an OpenTelemetry SDK or agent in the app's own code.
Inputs: appSlug (required), workspaceSlug (required), env, region.
getBrowserMonitorGet Browser MonitorCRead-onlyInspect
Returns the app's public browser key, the script URL and the hosts allowed to send beacons, from which the snippet is built, when the newest beacon arrived and the settings its snippet carries, the tag Cloady adds at the edge if it adds one, and LCP p75 and active sessions over the range once pages send beacons. Browser monitoring is on while the app's pages carry the snippet, whose own attributes set replay share, masking and the conversion goal, or while Cloady adds it at the edge, whose settings are the one thing stored: the app variable CLOADY_BROWSER_MONITORING.
Inputs: appSlug (required), workspaceSlug (required), env, range, +1 more.
getBrowserSessionReplayGet Browser Session ReplayARead-onlyInspect
Returns the session's recording as compressed rrweb segments, masked in the visitor's browser. Recordings are kept for 72 hours, apart from the app's other logs, so queryAppLogs cannot read them. A long session can return several megabytes. Needs the developer role, since recordings show what the app's visitors saw.
Inputs: appSlug (required), sessionId (required), workspaceSlug (required), env, +1 more.
getDbCredentialsGet Db CredentialsARead-onlyInspect
Read from the running pod's resolved environment at call time, so the container is the source of truth rather than the template. component is a compose service running a database.
Inputs: appSlug (required), component (required), workspaceSlug (required), env, +1 more.
getDbSchemaGet Db SchemaARead-onlyInspect
List a database component's schemas and tables
Inputs: appSlug (required), component (required), workspaceSlug (required), env, +2 more.
getGitDiffGet Git DiffBRead-onlyInspect
With no sha, diffs the working tree. path narrows it to one file. Large patches come back with truncated: true.
Inputs: appSlug (required), workspaceSlug (required), env, sha, +2 more.
getGitOverviewGet Git OverviewARead-onlyInspect
Read the working tree of a development app: branch, changes and recent commits. Reads the repository inside the running container by pod exec, so it is ground truth rather than the deploy record. Returns {ok:false, reason} when the app has no repo, no pod, or no git.
Inputs: appSlug (required), workspaceSlug (required), env, limit, +1 more.
getHealthGet HealthARead-onlyInspect
Check the control plane's database, registry and every ready region. Public: no token needed. Answers 503 when any check fails.
Inputs: component.
getInvitationGet InvitationBRead-onlyInspect
Get invitation details by token
Inputs: token (required).
getNotificationPreferencesGet Notification PreferencesARead-onlyInspect
Get notification preferences for the current user
Inputs: no named parameters.
getPricingGet PricingBRead-onlyInspect
Get public resource pricing and the free allowance
Inputs: no named parameters.
getPublicStatusGet Public StatusARead-onlyInspect
The data behind https://cloady.com/status/{workspaceSlug}/{appSlug}. Public: no token needed. env reads a preview or development app; production by default. Answers 404 when there is no such app.
Inputs: appSlug (required), workspaceSlug (required), env.
getSecurityStateGet Security StateBRead-onlyInspect
Read the account's sign-in settings
Inputs: no named parameters.
getSshSessionGet Ssh SessionBRead-onlyInspect
Get the SSH credential for a running container: the GET form of createSshSession.
Inputs: appSlug (required), component (required), workspaceSlug (required), env, +1 more.
getStatusPageGet Status PageBRead-onlyInspect
Returns the address of the app's public status page and what it shows: one component per compose service with its state, its uptime and 60 daily bars, and the incidents of the last 14 days. Availability is measured once a minute from replica readiness and, for the service the app's address routes to, the uptime check. Every app has the page, and anyone with the address can read it.
Inputs: appSlug (required), workspaceSlug (required), env, region.
getTicketGet TicketARead-onlyInspect
Get a single support ticket with all messages
Inputs: id (required).
getUserBillingStateGet User Billing StateBRead-onlyInspect
Get the account's shared free allowance and payment method status.
Inputs: no named parameters.
getVolumeKeysGet Volume KeysARead-onlyInspect
Get S3 and SFTP credentials for one volume or service filesystem. Derived, not stored, so they are stable and need no rotation step. volume is a name from listVolumes; kind selects a persistent volume (default) or a service filesystem.
Inputs: volume (required), appSlug (required), workspaceSlug (required), env, +2 more.
getWhoisGet WhoisARead-onlyInspect
What the domain's registry publishes over RDAP: registrar, dates, statuses, nameservers, DNSSEC and the registrant, which is usually redacted. For an extension without RDAP, only whether the domain has nameservers is known. Public: no token needed.
Inputs: domain (required).
getWorkspaceGet WorkspaceARead-onlyInspect
Get a workspace by slug
Inputs: workspaceSlug (required).
getWorkspaceBillingGet Workspace BillingBRead-onlyInspect
Get workspace billing info
Inputs: workspaceSlug (required).
getWorkspaceSsoGet Workspace SsoCRead-onlyInspect
redirectUri is what to register at the provider; txtValue is the TXT record the domain needs at _cloady.<domain> before it can be saved.
Inputs: workspaceSlug (required).
importProviderServiceImport Provider ServiceADestructiveInspect
Reads one service from the provider and returns what deployApp needs to recreate it: a source to pass to deployApp as it is, and the service's variables in values, secrets included. A service that runs an image comes back as an upload staged for it, deleted if no app uses it within three hours. The token is used for this call only and never stored, and nothing is deployed until deployApp is called.
Inputs: provider (required), workspaceSlug (required), requestBody.
importVarsImport VarsADestructiveInspect
Bulk-create environment variables, skipping keys already set
Inputs: appSlug (required), workspaceSlug (required), env, region, +1 more.
inspectPublicSourceInspect Public SourceADestructiveInspect
Read a public GitHub repository, or a template, and preview what it would deploy. Public: no token needed. Answers 429 when GitHub's rate limit, shared by every caller, runs out. Signed in, use inspectSource.
Inputs: requestBody.
inspectSourceInspect SourceCDestructiveInspect
Inspect a source and preview its template
Inputs: workspaceSlug (required), requestBody.
linkGithubIntegrationLink Github IntegrationCDestructiveInspect
Link GitHub installation to workspace
Inputs: workspaceSlug (required), requestBody.
listAlertsList AlertsARead-onlyInspect
Returns the app's alert rules with their state, the services they are firing on and when each last fired. Rules live in the app's own alerting tenant, evaluated once a minute. A production app gets two default rules the first time its alerts are read: down for 2 minutes, and more than 3 restarts within 15 minutes, both emailing members. With service, only rules that watch that compose service, and state for it alone.
Inputs: appSlug (required), workspaceSlug (required), env, region, +1 more.
listAppDomainsList App DomainsBRead-onlyInspect
List all domains for an app in a workspace
Inputs: appSlug (required), workspaceSlug (required), env, region.
listBackupsList BackupsBRead-onlyInspect
List an app's backups and its backup settings
Inputs: appSlug (required), workspaceSlug (required), env, region.
listBranchesList BranchesARead-onlyInspect
Fetched live from GitHub; empty for apps whose source is not git. current is the branch the app deploys from.
Inputs: appSlug (required), workspaceSlug (required), env, region.
listCertStatusesList Cert StatusesARead-onlyInspect
List TLS certificate statuses for app domains
Inputs: appSlug (required), workspaceSlug (required), env, region.
listChannelsList ChannelsARead-onlyInspect
Slack, webhook and PagerDuty destinations the app's alert rules can post to. Their URLs and keys are never returned.
Inputs: appSlug (required), workspaceSlug (required), env, region.
listDeploysList DeploysBRead-onlyInspect
List an app's deploys
Inputs: appSlug (required), workspaceSlug (required), env, region.
listDnsRecordsList Dns RecordsARead-onlyInspect
The DNS records of a domain registered through Cloady in this workspace, or of an application's own address under cloady.io (<app>-<hash>-<workspace>.cloady.io, as its endpoints show it). A registration starts with A and AAAA records for the domain and * pointing at Cloady; an address starts with none, since a wildcard serves it. Records with managed set are Cloady's: they keep the domain or address pointing at your applications and can't be changed or deleted. Answers 409 when a registered domain uses its own nameservers, whose records live there.
Inputs: domain (required), workspaceSlug (required).
listGithubInstallationsList Github InstallationsARead-onlyInspect
List the GitHub App installations your GitHub account can see.
Inputs: no named parameters.
listGithubReposList Github ReposCRead-onlyInspect
Search GitHub repositories
Inputs: workspaceSlug (required), q, limit, installationId.
listImportableServicesList Importable ServicesADestructiveInspect
Lists the projects and services the provider token can see, each marked importable or not, with the reason. The token is used for this call only and never stored. Import one with importProviderService.
Inputs: provider (required), workspaceSlug (required), requestBody.
listRegionsList RegionsARead-onlyInspect
List available regions
Inputs: no named parameters.
listTemplatesList TemplatesARead-onlyInspect
Search, filter, sort and page the template catalog. Public: no token needed. total counts every match, and categories counts the matches in each category with every other filter applied. Omit limit for every match.
Inputs: q, sort, limit, price, +7 more.
listTicketsList TicketsARead-onlyInspect
List support tickets for the current user
Inputs: no named parameters.
listTokensList TokensARead-onlyInspect
List the authenticated user's API tokens
Inputs: no named parameters.
listVarsList VarsBRead-onlyInspect
List environment variables and credentials for an app
Inputs: appSlug (required), workspaceSlug (required), env, region.
listVolumesList VolumesCRead-onlyInspect
List an app's volumes and service filesystems
Inputs: appSlug (required), workspaceSlug (required), env, region.
listWorkspaceDomainsList Workspace DomainsARead-onlyInspect
Every custom domain the workspace's applications serve, and every domain registered through Cloady, with its renewal details, whether or not an application serves it.
Inputs: workspaceSlug (required).
listWorkspaceIntegrationsList Workspace IntegrationsBRead-onlyInspect
List workspace integrations and provider status
Inputs: workspaceSlug (required).
listWorkspaceInvitationsList Workspace InvitationsBRead-onlyInspect
List pending workspace invitations
Inputs: workspaceSlug (required).
listWorkspaceMembersList Workspace MembersCRead-onlyInspect
List workspace members
Inputs: workspaceSlug (required).
listWorkspacesList WorkspacesARead-onlyInspect
List workspaces for the authenticated user
Inputs: no named parameters.
listWorkspaceVolumesList Workspace VolumesCRead-onlyInspect
List a workspace's volumes and service filesystems
Inputs: workspaceSlug (required), env, region.
lookupImageLookup ImageARead-onlyInspect
Look up a public Docker image and the one-service compose file that runs it. Public: no token needed. Reads Docker Hub, ghcr.io, quay.io, gcr.io, public.ecr.aws, mcr.microsoft.com, registry.gitlab.com and lscr.io only. image is null when the image is not found.
Inputs: ref (required).
mergeGitBranchMerge Git BranchADestructiveInspect
Merge the named branch into the current one, as a merge commit unless it fast-forwards. Refused while another merge, rebase, revert or cherry-pick is in progress. If the merge fails, it is aborted, the call fails, and the error carries git's report. Works only on a development app: any other app answers 403 read_only. Runs git in the app's running container and returns its output.
Inputs: appSlug (required), workspaceSlug (required), env, region, +1 more.
pullGitChangesPull Git ChangesADestructiveInspect
Fetch the current branch's upstream and fast-forward to it. Fails when the branches have diverged or uncommitted changes would be overwritten. A GitHub remote is read with the workspace's GitHub App installation; any other host is read without credentials. Works only on a development app: any other app answers 403 read_only. Runs git in the app's running container and returns its output.
Inputs: appSlug (required), workspaceSlug (required), env, region.
queryAppLogsQuery App LogsARead-onlyInspect
Runs a LogQL query over the app's own logs, kept for seven days, and returns Loki's answer unchanged: lines for a log query, series for a metric query. Streams: {container="<service>"} is each compose service's own output, with pod and a detected_level (error, critical, fatal, warn, info, debug, trace or unknown) to filter on as | detected_level=~"error|critical|fatal"; {container="_events"} holds the Kubernetes events about the app's objects as JSON (kind, name, reason, type, msg, count); {container="_access", service="<service>"} is the ingress access log of the service the app's address routes to, as Traefik's JSON (RequestMethod, RequestPath, DownstreamStatus, Duration in nanoseconds, request_User-Agent), with route, method and status as fields; and {container="_rum", kind="pageview"} with kinds vital, error, net, signal, custom and session holds browser monitoring, with page, session, device, browser, os and country as fields. Session recordings are kept apart: getBrowserSessionReplay reads them, with the developer role. A query the store refuses comes back with the store's own status and error. The path is the store's own, so a Grafana data source can point here too.
Inputs: query (required), appSlug (required), workspaceSlug (required), end, +6 more.
queryAppMetricsQuery App MetricsARead-onlyInspect
Runs a PromQL query at one instant against the app's own metrics, kept for 62 days, and returns Prometheus's answer unchanged. Only the app's series are visible, whatever the query selects. Every series carries namespace, the app's (getWorkspace returns each app's), and most carry container, the compose service, and pod. Resources: container_cpu_usage_seconds_total, container_spec_cpu_quota / container_spec_cpu_period (the CPU limit), container_memory_working_set_bytes, container_spec_memory_limit_bytes, container_fs_reads_bytes_total, container_fs_writes_bytes_total, container_oom_events_total, and container_network_receive_bytes_total / container_network_transmit_bytes_total, which carry only pod, so match them as pod=~"<service>-[a-z0-9]+-[a-z0-9]+". Replicas: kube_pod_container_status_ready, kube_pod_container_status_restarts_total, kube_pod_container_status_waiting_reason and kube_pod_container_status_last_terminated_reason (reason), and kube_deployment_spec_replicas / kube_deployment_status_replicas_available, whose deployment is the service. Volumes: kubelet_volume_stats_used_bytes and kubelet_volume_stats_capacity_bytes, whose persistentvolumeclaim is the compose volume (each service's volumes in getWorkspace). Requests to the service the app's address routes to: traefik_service_requests_total (code, method, protocol) and traefik_service_request_duration_seconds_bucket (le). Uptime checks are method="HEAD", so leave them out with method!="HEAD", and a scale-to-zero function reports as container="<service>-fn". Uptime: cloady:probe_success:serving (kind="auto" is the check of the app's address) and cloady:service_up:serving, each service's availability from 0 to 1. Spans, once the app sends OpenTelemetry traces: traces_spanmetrics_calls_total and traces_spanmetrics_latency_bucket (span_name, span_kind, status_code, http_status). RabbitMQ: rabbitmq_detailed_queue_messages_ready. Alert rules: ALERTS (alertname, alertstate, container, cloady_metric), whose alertstate="firing" samples are the app's incident history. queryAppMetricsRange runs a query over a range. A query the store refuses comes back with the store's own status and error. The path is the store's own, so a Grafana data source can point here too.
Inputs: query (required), appSlug (required), workspaceSlug (required), env, +2 more.
queryAppMetricsRangeQuery App Metrics RangeARead-onlyInspect
Runs a PromQL query at every step of a range against the app's own metrics, kept for 62 days, and returns Prometheus's answer unchanged: one matrix series per label set. Only the app's series are visible. The labels and series are queryAppMetrics'. A query the store refuses comes back with the store's own status and error. The path is the store's own, so a Grafana data source can point here too.
Inputs: end (required), step (required), query (required), start (required), +4 more.
queryWorkspaceMetricsQuery Workspace MetricsARead-onlyInspect
Runs a PromQL query at one instant across the metrics of every app in the workspace, or only those in env and region, and returns Prometheus's answer unchanged. Group by namespace to tell the apps apart. The labels and series are queryAppMetrics'. A query the store refuses comes back with the store's own status and error. The path is the store's own, so a Grafana data source can point here too.
Inputs: query (required), workspaceSlug (required), env, time, +1 more.
readEngineKeyspaceRead Engine KeyspaceBRead-onlyInspect
Samples up to 2,000 keys of database 0 within two seconds, without touching their LRU or LFU clocks where the server allows it, and groups them by the text before the first colon: share of sampled memory, keys, TTLs and the largest keys. Key names can carry data, so this needs the developer role.
Inputs: appSlug (required), serviceName (required), workspaceSlug (required), env, +1 more.
readEngineSlowLogRead Engine Slow LogARead-onlyInspect
Returns statements slower than the engine's own threshold across range, newest first: Postgres duration: log lines, MongoDB slow operation log lines, ClickHouse system.query_log, the performance_schema statement history on MySQL and MariaDB, and SLOWLOG (COMMANDLOG on Valkey) on a cache. The last two keep only recent entries. Needs the developer role, because statements and command arguments carry data.
Inputs: appSlug (required), serviceName (required), workspaceSlug (required), env, +2 more.
readEngineStorageRead Engine StorageARead-onlyInspect
Returns each database's size, the largest 100 tables or collections with rows, table and index bytes, dead tuples and vacuum state on Postgres and reclaimable space elsewhere, and the indexes nothing has used since the counters began. Names the schema, so it needs the developer role.
Inputs: appSlug (required), serviceName (required), workspaceSlug (required), env, +1 more.
readServiceDependenciesRead Service DependenciesARead-onlyInspect
Returns the calls observed in the range's traces between the service and other services, databases and hosts, with their rate, failure share and 95th-percentile duration. Without observed calls it falls back to the compose file: depends_on entries and environment values that name another service as a host. serviceName is a compose service.
Inputs: appSlug (required), serviceName (required), workspaceSlug (required), env, +2 more.
readServiceJobDetailsRead Service Job DetailsBRead-onlyInspect
Returns the newest job runs with their state, attempt, run time and error text, the jobs that schedules added within the range, the newest failure of each job type, and up to three failed or dead jobs per queue. Requires the developer role, because error texts can carry job data.
Inputs: appSlug (required), serviceName (required), workspaceSlug (required), env, +2 more.
readServiceJobsRead Service JobsARead-onlyInspect
Finds the job library the service uses and reads it: BullMQ, Sidekiq and Celery state in a Redis service of the same app, RabbitMQ queues, and Sidekiq and Celery job lines in the service's own logs. Returns finished and failed runs per step, each job type with its failure share, run-time p95 and newest outcomes, repeat and cron schedules, and each queue with its waiting jobs, rates, oldest job, consumers and dead letters. searched says where Monitor looked and what it found; nothing is invented when nothing is found. Works on a worker, a Redis or a RabbitMQ service. Failure texts need readServiceJobDetails.
Inputs: appSlug (required), serviceName (required), workspaceSlug (required), env, +2 more.
readServiceLogsRead Service LogsARead-onlyInspect
Returns the last 200 log lines of one container as {container, state, logs}; state is no-pod when nothing is running. serviceName is a compose service. Sending Accept: text/event-stream instead follows the log live as server-sent events, one bare data: frame per line, which never completes on its own.
Inputs: appSlug (required), serviceName (required), workspaceSlug (required), env, +1 more.
readServiceLogSettingsRead Service Log SettingsBRead-onlyInspect
Returns the settings that decide what the service's log holds, read from the running engine (PostgreSQL's log_* settings, MySQL's error log and deadlock settings, Redis's slowlog and memory policy) or, for the service the app's address routes to, from the ingress. Also returns what they mean for each category of the log, as the service's logFormat sorts it, and, for Redis, lines built from its memory and error counters, which Redis never logs. serviceName is a compose service.
Inputs: appSlug (required), serviceName (required), workspaceSlug (required), env, +1 more.
readServiceMailRead Service MailARead-onlyInspect
Reads a Postfix service's delivery log and queue: outbound attempts by outcome per step, time to delivery, inbound rejections and authentication failures, outcomes by recipient domain, bounce reasons with addresses masked, the queue's size by state and the retry settings. Postfix must log to standard output (maillog_file = /dev/stdout). Stalwart is read from its own Prometheus exporter and JMAP API once its admin turns the exporter on and the app holds an API key as the variable STALWART_API_KEY (and the exporter's login, if it has one, as STALWART_METRICS_AUTH, written user:secret); Mailpit and MailHog report what they caught. Nothing is invented for a server Monitor cannot read.
Inputs: appSlug (required), serviceName (required), workspaceSlug (required), env, +2 more.
readServiceMailQueueRead Service Mail QueueARead-onlyInspect
Lists up to 100 messages in a Postfix queue, or in Stalwart's through its API, with their sender, recipients, the remote server's last reply, when the server tries again and how many attempts it has made. Requires the developer role, because it shows addresses.
Inputs: appSlug (required), serviceName (required), workspaceSlug (required), env, +1 more.
readTraceRead TraceARead-onlyInspect
Returns the spans the workspace's apps sent in a trace, in tree order, with each span's service, timing, status, first exception and attributes. Spans from outside the workspace are left out. Answers 404 when no span of the trace belongs to the workspace, it was sampled out, or it is older than 7 days.
Inputs: traceId (required), workspaceSlug (required), around.
rebaseGitBranchRebase Git BranchADestructiveInspect
Replay the current branch's own commits on top of the named branch, rewriting them. Refused while another merge, rebase, revert or cherry-pick is in progress. If the rebase fails, it is aborted, the call fails, and the error carries git's report. Works only on a development app: any other app answers 403 read_only. Runs git in the app's running container and returns its output.
Inputs: appSlug (required), workspaceSlug (required), env, region, +1 more.
redeployAppRedeploy AppCDestructiveInspect
Redeploy an app (refresh code + roll pods)
Inputs: appSlug (required), workspaceSlug (required), env, region.
registerDomainRegister DomainADestructiveInspect
Registers a domain for its registry's minimum term, usually a year, charged to the workspace's card: the owner's account card, or the workspace's own when one is pinned. The registrant becomes the domain's legal owner, and the registry may email them to confirm the address. WHOIS privacy and auto-renew are on unless set to false. Without nameservers, Cloady points the domain and every subdomain at Cloady, so attaching any of them to an application with createDomain needs no DNS change. dryRun quotes the price and checks the name can be registered here without charging; premium names, orders over $100 and extensions whose registry needs more than a contact can't be. A card the bank wants to authenticate answers 402 payment_action_required with clientSecret, paymentIntentId and publishableKey in details: confirm it with Stripe.js, then repeat the request with paymentIntentId. If registration fails after the charge, the charge is refunded. Needs the developer role.
Inputs: workspaceSlug (required), requestBody.
restoreBackupRestore BackupADestructiveInspect
Overwrites the app's current volume contents with the snapshot. There is no undo.
Inputs: appSlug (required), backupId (required), workspaceSlug (required), env, +1 more.
retryServiceJobsRetry Service JobsADestructiveInspect
Moves one failed job, or every failed job of a BullMQ queue, back to the queue's waiting list through the bullmq library, so the app's workers run it again. BullMQ 5 or later only; Sidekiq, Celery and RabbitMQ have no retry here. Requires the developer role.
Inputs: appSlug (required), serviceName (required), workspaceSlug (required), env, +2 more.
revealVarReveal VarBRead-onlyInspect
Reveal the decrypted value of a secret variable
Inputs: varId (required), appSlug (required), workspaceSlug (required), env, +1 more.
revertGitCommitRevert Git CommitADestructiveInspect
Add a new commit that undoes the given commit. Refused while another merge, rebase, revert or cherry-pick is in progress. If the revert fails, it is aborted and the call fails. Works only on a development app: any other app answers 403 read_only. Runs git in the app's running container and returns its output.
Inputs: appSlug (required), workspaceSlug (required), env, region, +1 more.
reviewTemplateReview TemplateADestructiveInspect
Rate and review a template (one review per account; sending again replaces it).
Inputs: slug (required), requestBody.
revokeTokenRevoke TokenCDestructiveInspect
Revoke an API token
Inputs: id (required).
revokeWorkspaceInvitationRevoke Workspace InvitationCDestructiveInspect
Revoke workspace invitation
Inputs: invitationId (required), workspaceSlug (required).
rollbackDeployRollback DeployADestructiveInspect
Needs a running, build-backed app whose target image is still in the registry. Restarts every service in the instance, database included.
Inputs: appSlug (required), deployId (required), workspaceSlug (required), env, +1 more.
runDbQueryRun Db QueryBDestructiveInspect
Runs over a real protocol driver, not a shell, and executes whatever is sent — including writes and DDL. Redis and MongoDB take their own command syntax rather than SQL.
Inputs: appSlug (required), workspaceSlug (required), env, region, +1 more.
searchServiceTracesSearch Service TracesARead-onlyInspect
Returns a sample of the requests the service handled in the range, one per trace, with their method, route, status and duration, plus the range's request count and median and 95th-percentile duration. Filter on route, method and status (2xx to 5xx, or a code). Needs tracing on for the app and an OpenTelemetry SDK in the service; traces are kept for 7 days. serviceName is a compose service.
Inputs: appSlug (required), serviceName (required), workspaceSlug (required), env, +4 more.
setWorkspaceSsoSet Workspace SsoADestructiveInspect
Connect an OpenID Connect identity provider for single sign-on. Refuses a domain whose _cloady.<domain> TXT record doesn't carry the workspace's txtValue yet, so a saved connection is always live. Anyone the provider signs in with an email at the domain joins the workspace as a developer. Omit clientSecret to keep the stored one. Requires admin.
Inputs: workspaceSlug (required), requestBody.
stageGitFilesStage Git FilesADestructiveInspect
Add the current contents of the given paths to the index, ready for the next commit. Works only on a development app: any other app answers 403 read_only. Runs git in the app's running container and returns its output.
Inputs: appSlug (required), workspaceSlug (required), env, region, +1 more.
startCardSetupStart Card SetupADestructiveInspect
Create a SetupIntent for saving a card with the inline payment element. Returns a clientSecret that Stripe's payment element exchanges for a saved card in the browser. The secret alone cannot charge anything or read existing cards, and it is scoped to the caller's own Stripe customer.
Inputs: no named parameters.
startTotpSetupStart Totp SetupADestructiveInspect
Returns a new key and its otpauth:// link for a QR code that Google Authenticator or any authenticator app scans. Nothing is saved until enableTotp confirms a code from the app. Answers 409 totp_enabled while an app is already on.
Inputs: no named parameters.
streamActiveDeployStream Active DeployARead-onlyInspect
Read the app's in-flight deploy, or its latest when none is running. Returns one {ts, deploy} frame: the active deploy if one is running, otherwise the most recent, and deploy is null when the app has never deployed. Sending Accept: text/event-stream instead follows it live, a frame every two seconds, closing after one terminal frame.
Inputs: appSlug (required), workspaceSlug (required), env, region.
streamAppMetricsStream App MetricsARead-onlyInspect
Returns one metrics reading; network and requestsPerSec are null until a second sample exists, so they are null on a one-shot read. Sending Accept: text/event-stream instead follows usage live, a frame every five seconds, which never completes on its own.
Inputs: appSlug (required), workspaceSlug (required), env, region.
streamAppStatusStream App StatusARead-onlyInspect
Read an app's live status: per-service state, capacity waits, in-flight deploy. Returns one status frame. Sending Accept: text/event-stream instead follows the status live, a frame every five seconds, which never completes on its own.
Inputs: appSlug (required), workspaceSlug (required), env, region.
streamDeployLogsStream Deploy LogsARead-onlyInspect
Returns one {kind:"snapshot", log, status} frame — the whole log so far, not a delta: the stored log for a finished deploy, the live build pod's log for the in-flight one. Sending Accept: text/event-stream instead re-sends a growing snapshot every two seconds; a finished deploy sends one frame and closes, the in-flight one keeps the connection open after it ends, so close it yourself once a frame carries final: true.
Inputs: appSlug (required), deployId (required), workspaceSlug (required), env, +1 more.
streamEngineSessionsStream Engine SessionsBRead-onlyInspect
Returns connections grouped by client, each mapped to the compose service it comes from where its address is a pod of the app, and the sessions running or holding a transaction for five seconds or more, waiting on a lock or blocking another, with their query text. Needs the developer role. Sending Accept: text/event-stream instead follows it live, a frame every five seconds.
Inputs: appSlug (required), serviceName (required), workspaceSlug (required), env, +1 more.
streamEngineStatementsStream Engine StatementsARead-onlyInspect
Returns the statements with the most time, the most calls and the slowest means, with their normalized text: pg_stat_statements on Postgres, performance_schema digests on MySQL and MariaDB, system.query_log over range on ClickHouse, per-collection totals on MongoDB. Statement text can carry data, so this needs the developer role. A one-shot read gives cumulative values; sending Accept: text/event-stream instead follows it live, a frame every fifteen seconds with calls and time over the interval.
Inputs: appSlug (required), serviceName (required), workspaceSlug (required), env, +2 more.
streamEngineStatsStream Engine StatsARead-onlyInspect
Reads the engine behind a compose service (Postgres, MySQL, MariaDB, ClickHouse, MongoDB, Redis, Valkey or KeyDB) through its own protocol: throughput, latency, connections, cache hit ratio and memory, with the settings and opt-ins that shape them. Returns one frame of cumulative counters with every per-second value null. Sending Accept: text/event-stream instead follows it live, a frame every five seconds with rates over the interval, which never completes on its own.
Inputs: appSlug (required), serviceName (required), workspaceSlug (required), env, +1 more.
streamTicketMessagesStream Ticket MessagesARead-onlyInspect
Returns one frame. Sending Accept: text/event-stream instead follows the thread live, every 2.5 seconds, which stops only when the ticket disappears.
Inputs: id (required).
testChannelTest ChannelADestructiveInspect
Hands a test alert to the app's Alertmanager, which posts it to the channel within a minute and a resolve five minutes later. On PagerDuty this opens an incident, which pages whoever is on call.
Inputs: appSlug (required), channelId (required), workspaceSlug (required), env, +1 more.
transferAppTransfer AppCDestructiveInspect
Transfer an app to another workspace
Inputs: appSlug (required), workspaceSlug (required), env, region, +1 more.
transferWorkspaceOwnershipTransfer Workspace OwnershipDDestructiveInspect
Transfer workspace ownership
Inputs: workspaceSlug (required), requestBody.
unstageGitFilesUnstage Git FilesADestructiveInspect
Take the given paths out of the index; their changes stay in the working tree. Works only on a development app: any other app answers 403 read_only. Runs git in the app's running container and returns its output.
Inputs: appSlug (required), workspaceSlug (required), env, region, +1 more.
updateAlertUpdate AlertBDestructiveInspect
Changes the threshold, durations, notifications or the on/off switch. Turning a rule off silences it, so it stops notifying.
Inputs: alertId (required), appSlug (required), workspaceSlug (required), env, +2 more.
updateAppUpdate AppCDestructiveInspect
Update an app (name / status / version)
Inputs: appSlug (required), workspaceSlug (required), env, region, +1 more.
updateAppTracingUpdate App TracingADestructiveInspect
Turns OpenTelemetry tracing on or off for the app. manual and auto add the app variables OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_PROTOCOL, OTEL_EXPORTER_OTLP_COMPRESSION, OTEL_RESOURCE_ATTRIBUTES, OTEL_METRICS_EXPORTER and OTEL_LOGS_EXPORTER, which point an OpenTelemetry SDK at Cloady's trace store, and each service also gets OTEL_SERVICE_NAME. auto also writes CLOADY_SERVER_MONITORING, the agent for each service (web=node,worker=python), and Cloady loads that OpenTelemetry agent into the service when it starts, with no code change. agents sets the agent of each service it names, null removing it, and the other services keep the agents CLOADY_SERVER_MONITORING already lists (none unless the app is already in auto mode); without agents Cloady detects what each service runs and picks every agent itself. off deletes them all. The app is reconciled: turning it on or off restarts its running services once, and changing agents restarts only the services whose agent changed; a request that changes nothing restarts nothing. Answers 400 for a service the app doesn't have, and 502 when the variables were saved but the app couldn't be reconciled, which repeating a manual or auto request retries. Needs the developer role.
Inputs: appSlug (required), workspaceSlug (required), env, region, +1 more.
updateBackupsUpdate BackupsBDestructiveInspect
Turn managed backups on or off and set the daily window
Inputs: appSlug (required), workspaceSlug (required), env, region, +1 more.
updateBrowserMonitorUpdate Browser MonitorADestructiveInspect
Makes Cloady add the browser monitoring script tag before </head> of every HTML page the app's address and custom domains serve, with no code change or redeploy, or stop adding it with edge: null. The settings are kept in the app variable CLOADY_BROWSER_MONITORING and apply on the next page load; no service restarts. A page whose head already carries the script keeps its own. Answers 400 when the app has no web address, and 502 when the settings were saved but the app couldn't be reconciled, which repeating a request that sets edge retries. Needs the developer role.
Inputs: appSlug (required), workspaceSlug (required), env, region, +1 more.
updateChannelUpdate ChannelCDestructiveInspect
Change a notification channel
Inputs: appSlug (required), channelId (required), workspaceSlug (required), env, +2 more.
updateDnsRecordUpdate Dns RecordADestructiveInspect
Replaces a record's name, type, content, TTL and priority under the same rules as createDnsRecord. Answers 409 for a record Cloady manages. Needs the developer role.
Inputs: domain (required), recordId (required), workspaceSlug (required), requestBody.
updateDomainUpdate DomainCDestructiveInspect
Update a domain configuration
Inputs: appSlug (required), domainId (required), workspaceSlug (required), env, +2 more.
updateMeUpdate MeADestructiveInspect
Update your name, avatar, account card or password (requires full scope).
Inputs: requestBody.
updateNotificationPreferencesUpdate Notification PreferencesCDestructiveInspect
Update notification preferences for the current user
Inputs: requestBody.
updateTicketUpdate TicketBDestructiveInspect
Update ticket status or mark as read
Inputs: id (required), requestBody.
updateVarUpdate VarADestructiveInspect
Change a variable's value, whether it is secret, or its name. A new name keeps the value, so a secret can be renamed without sending it again; a name another variable has is refused.
Inputs: varId (required), appSlug (required), workspaceSlug (required), env, +2 more.
updateWorkspaceUpdate WorkspaceCDestructiveInspect
Update a workspace (requires full scope)
Inputs: workspaceSlug (required), requestBody.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 160 tools
The 160-tool surface covers many subdomains, and most tools have distinct scopes documented in detail, but several families are easy to confuse: getStatusPage vs getPublicStatus, queryAppMetrics vs streamAppMetrics vs queryAppMetricsRange vs queryWorkspaceMetrics, listWorkspaceDomains vs listAppDomains vs listDnsRecords, and createSshSession vs getSshSession. Descriptions usually resolve the ambiguity, so boundaries are mostly clear but not effortless.
Almost all names are camelCase verb-first (list..., get..., create..., update..., delete..., stream..., read..., query...). The convention is consistent across 160 tools, with only natural verb variety rather than style mixing.
160 tools is far beyond the 3-15 well-scoped range and even beyond the 25+ 'too many' threshold; the platform is broad, but this is an extreme surface for one MCP server. Each subdomain could be split into separate servers.
Coverage is unusually broad: workspace/app lifecycle, deploys, domains/DNS, variables, volumes/backups, billing, support, observability, git, database, mail, alerts, and integrations. Minor gaps remain, such as no obvious standalone getApp/listApps tool, but getWorkspace appears to expose app details and most workflows have a path.
Maintenance
Related MCP Connectors
Deploy and manage your apps, databases, storage, and scheduled jobs from your AI agent
Deploy apps from GitHub, read build/runtime logs, and manage your app's users from your AI agent.
Deploy and run apps in your own AWS, Google Cloud, Azure or DigitalOcean account from any AI agent.
Deploy and manage Jade Hosting projects from AI clients. Jade account and OAuth required.
Related MCP Servers
- AlicenseDqualityFmaintenanceProvides programmatic and CLI tools for managing Coolify deployments, allowing users to control applications, services, databases, and infrastructure through natural language or command line.1030 npm7Good Luck With That Public
- AlicenseBqualityDmaintenanceEnables AI assistants to interact with Coolify for complete infrastructure management including applications, databases, servers, deployments, and team operations. Provides 100% API coverage with 64 tools for managing the entire Coolify ecosystem through natural language.188 npm6MIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to manage cloud infrastructure through natural language by providing a unified interface to the Dokploy platform. Supports Docker containers, applications, databases, domains, monitoring, and deployment operations through conversational commands.50 npm1-

@vertracloud/mcpofficial
AlicenseBqualityBmaintenanceEnables AI assistants to operate Vertra Cloud resources through the public API: deploy and manage applications, view logs and metrics, create and restore snapshots, and administer databases and environment variables.139672 npm2MIT