Cloady
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| API_BASE_URL | No | Overrides the target API endpoint if you run Cloady elsewhere. | |
| BEARER_TOKEN_CLOADY | Yes | Your Cloady API token, created in the dashboard under Account → API tokens. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| getMeA | Get the authenticated user |
| updateMeA | Update your name, avatar, account card or password (requires full scope). |
| listRegionsA | List available regions |
| getHealthA | Check the control plane's database, registry and every ready region. Public: no token needed. Answers 503 when any check fails. |
| getAiStatusB | Whether Ask AI is set up. Public: no token needed. |
| askAiA | 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 |
| inspectPublicSourceA | 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. |
| lookupImageA | 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. |
| checkDnsA | The addresses a custom domain must point at and, with |
| checkDomainsA | Checks a name across popular extensions, with what registering each costs on Cloady. |
| getWhoisA | 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. |
| contactSupportA | Send a message to Cloady support without an account. Public: no token needed. |
| listGithubInstallationsA | List the GitHub App installations your GitHub account can see. |
| listWorkspacesA | List workspaces for the authenticated user |
| createWorkspaceB | Create a workspace (requires full scope) |
| getWorkspaceA | Get a workspace by slug |
| deleteWorkspaceB | Delete a workspace (requires full scope) |
| updateWorkspaceC | Update a workspace (requires full scope) |
| inspectSourceC | Inspect a source and preview its template |
| listImportableServicesA | 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. |
| importProviderServiceA | Reads one service from the provider and returns what deployApp needs to recreate it: a |
| createUploadA | 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. |
| generateImageA | 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. |
| deployAppC | Creates the app and starts its first deploy. |
| deleteAppA | Delete an app and purge its data |
| updateAppC | Update an app (name / status / version) |
| redeployAppC | Redeploy an app (refresh code + roll pods) |
| getSshSessionB | Get the SSH credential for a running container: the GET form of createSshSession. |
| createSshSessionB | Create a short-lived SSH session credential for a running container. |
| execCommandC | Run a one-off shell command in a running container (kubernetes exec). |
| listBackupsB | List an app's backups and its backup settings |
| updateBackupsB | Turn managed backups on or off and set the daily window |
| restoreBackupA | Overwrites the app's current volume contents with the snapshot. There is no undo. |
| listBranchesA | Fetched live from GitHub; empty for apps whose source is not git. |
| rollbackDeployA | Needs a running, build-backed app whose target image is still in the registry. Restarts every service in the instance, database included. |
| analyzeDeployA | 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 |
| getVolumeKeysA | Get S3 and SFTP credentials for one volume or service filesystem. Derived, not stored, so they are stable and need no rotation step. |
| getDbCredentialsA | Read from the running pod's resolved environment at call time, so the container is the source of truth rather than the template. |
| getDbSchemaA | List a database component's schemas and tables |
| runDbQueryB | 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. |
| getGitOverviewA | 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 |
| discardGitChangesA | 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 |
| commitGitChangesA | 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 |
| checkoutGitBranchA | Switch the working tree to a branch with |
| stageGitFilesA | 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 |
| unstageGitFilesA | 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 |
| mergeGitBranchA | 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 |
| rebaseGitBranchA | 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 |
| revertGitCommitA | 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 |
| cherryPickGitCommitA | 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 |
| pullGitChangesA | 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 |
| getGitDiffB | With no |
| streamAppStatusA | Read an app's live status: per-service state, capacity waits, in-flight deploy. Returns one status frame. Sending |
| streamAppMetricsA | Returns one metrics reading; |
| streamActiveDeployA | Read the app's in-flight deploy, or its latest when none is running. Returns one |
| streamDeployLogsA | Returns one |
| listDeploysB | List an app's deploys |
| listVarsB | List environment variables and credentials for an app |
| createVarC | Create a new environment variable or credential |
| importVarsA | Bulk-create environment variables, skipping keys already set |
| deleteVarA | Delete an environment variable or credential |
| updateVarA | 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. |
| revealVarB | Reveal the decrypted value of a secret variable |
| listAppDomainsB | List all domains for an app in a workspace |
| createDomainC | Create a new domain for an app |
| deleteDomainC | Delete a domain from an app |
| updateDomainC | Update a domain configuration |
| listCertStatusesA | List TLS certificate statuses for app domains |
| readServiceLogsA | Returns the last 200 log lines of one container as |
| getAppServicesC | List all services in an app instance |
| createAppDeployB | Trigger a new deployment for an app |
| listVolumesC | List an app's volumes and service filesystems |
| transferAppC | Transfer an app to another workspace |
| getWorkspaceBillingB | Get workspace billing info |
| listWorkspaceMembersC | List workspace members |
| listWorkspaceInvitationsB | List pending workspace invitations |
| createWorkspaceInvitationC | Send workspace invitation |
| revokeWorkspaceInvitationC | Revoke workspace invitation |
| transferWorkspaceOwnershipD | Transfer workspace ownership |
| listWorkspaceDomainsA | 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. |
| listDnsRecordsA | The DNS records of a domain registered through Cloady in this workspace, or of an application's own address under cloady.io ( |
| createDnsRecordA | 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 |
| updateDnsRecordA | 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. |
| deleteDnsRecordA | 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. |
| registerDomainA | 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 |
| listWorkspaceVolumesC | List a workspace's volumes and service filesystems |
| listWorkspaceIntegrationsB | List workspace integrations and provider status |
| getWorkspaceSsoC |
|
| setWorkspaceSsoA | Connect an OpenID Connect identity provider for single sign-on. Refuses a domain whose |
| deleteWorkspaceSsoC | Remove single sign-on from the workspace |
| linkGithubIntegrationC | Link GitHub installation to workspace |
| disconnectGithubIntegrationC | Disconnect GitHub integration from workspace |
| listGithubReposC | Search GitHub repositories |
| listTokensA | List the authenticated user's API tokens |
| createTokenB | Create a new API token for the current user |
| revokeTokenC | Revoke an API token |
| getAccountBillingB | Get account billing information including payment methods and invoices. |
| startCardSetupA | Create a SetupIntent for saving a card with the inline payment element. Returns a |
| getUserBillingStateB | Get the account's shared free allowance and payment method status. |
| getNotificationPreferencesA | Get notification preferences for the current user |
| updateNotificationPreferencesC | Update notification preferences for the current user |
| getSecurityStateB | Read the account's sign-in settings |
| listTicketsA | List support tickets for the current user |
| createTicketC | 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. |
| getTicketA | Get a single support ticket with all messages |
| updateTicketB | Update ticket status or mark as read |
| addTicketMessageC | Add a message to a support ticket |
| enableTotpA | 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. |
| startTotpSetupA | 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 |
| disableTotpB | Turn off sign-in codes from an authenticator app |
| streamTicketMessagesA | Returns one frame. Sending |
| checkWorkspaceSlugA | Returns the slug that would actually be used; |
| listTemplatesA | Search, filter, sort and page the template catalog. Public: no token needed. |
| reviewTemplateA | Rate and review a template (one review per account; sending again replaces it). |
| deleteTemplateReviewC | Delete your review of a template |
| getPricingB | Get public resource pricing and the free allowance |
| getInvitationB | Get invitation details by token |
| acceptInvitationB | Accept a workspace invitation |
| declineInvitationB | Decline a workspace invitation |
| queryAppMetricsA | 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 |
| queryAppMetricsRangeA | 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 |
| queryAppLogsA | 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: |
| queryWorkspaceMetricsA | Runs a PromQL query at one instant across the metrics of every app in the workspace, or only those in |
| getBrowserMonitorC | 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. |
| updateBrowserMonitorA | Makes Cloady add the browser monitoring script tag before |
| getBrowserSessionReplayA | 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. |
| getAppTracingB | 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 |
| updateAppTracingA | Turns OpenTelemetry tracing on or off for the app. |
| getAppRuntimesA | 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. |
| searchServiceTracesA | 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 |
| readServiceDependenciesA | 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. |
| readTraceA | 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. |
| readServiceLogSettingsB | 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 |
| streamEngineStatsA | 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 |
| streamEngineStatementsA | 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 |
| streamEngineSessionsB | 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 |
| endEngineSessionA | Cancels the statement a session is running ( |
| readEngineStorageA | 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. |
| readEngineKeyspaceB | 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. |
| readEngineSlowLogA | Returns statements slower than the engine's own threshold across |
| explainEngineStatementC | 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. |
| enableEngineInsightsA | 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 |
| readServiceJobsA | 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. |
| readServiceJobDetailsB | 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. |
| retryServiceJobsA | 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. |
| readServiceMailA | 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 ( |
| readServiceMailQueueA | 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. |
| flushServiceMailQueueA | Asks Postfix to attempt delivery now, for one queued message ( |
| checkMailDomainsB | 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. |
| listAlertsA | 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 |
| createAlertC | 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 |
| deleteAlertC | Past incidents stay in the history. |
| updateAlertB | Changes the threshold, durations, notifications or the on/off switch. Turning a rule off silences it, so it stops notifying. |
| listChannelsA | Slack, webhook and PagerDuty destinations the app's alert rules can post to. Their URLs and keys are never returned. |
| createChannelC | Slack and webhook channels take |
| deleteChannelC | Also removes it from every alert rule of the app that posts to it. |
| updateChannelC | Change a notification channel |
| testChannelA | 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. |
| getStatusPageB | 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. |
| getPublicStatusA | The data behind https://cloady.com/status/{workspaceSlug}/{appSlug}. Public: no token needed. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
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.