RunCloud MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.23.4Updated Nov 7, 2026

Read RunCloud servers, web apps, databases and logs; deploy, restart services, renew SSL.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableCloud & InfrastructureDeveloper ToolsSecurity & Monitoring

Overview

AI-generated overview

Hosted RunCloud MCP server that lets an assistant inspect servers, web apps, domains, SSL, databases and logs, and run deploys, service restarts and SSL…

What you can do
  • List and inspect servers: details, stats, hardware, latest health, activity logs, services and system users
  • Browse web applications: settings, activity logs, domains, DNS setup, SSL certificate and SSL method
  • Review Git and atomic deployment configuration, projects and deployment history
  • List databases and database users, cron jobs, supervisor jobs and their live status
  • Check firewall rules, Fail2Ban blocked IPs, backups and backup snapshots
  • Act on the server: start, restart or reload a service, force Git or atomic deploys, run a cron job, reload a supervisor, renew or install Let's Encrypt SSL
When to use it
Useful when you manage RunCloud-hosted servers and sites and want to ask questions about server health, hosted sites, SSL expiry or deployments from a chat client, or trigger routine operations like a service restart, deploy or certificate renewal without opening the RunCloud dashboard.
Requirements
Remote MCP endpoint; no local install. Connect with only the server URL and sign in through OAuth with your own RunCloud credentials; the README says not to add an Authorization header or API key to the client config. A free plan allows 50 tool calls per month; paid plans are available.
Before you install
Several tools change live systems: service restarts briefly interrupt the service and its sites, Git and atomic deploys change the live site's files, cron jobs run their command on the server, and SSL tools re-issue certificates and reload the web server. Confirm before write actions. The service is a paid third-party proxy: usage is metered, upgrades return Stripe payment links, and your RunCloud credentials are entered on the provider's login page.

Installation

In SourceWeft

  1. Open RunCloud MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fruncloud/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "runcloud-by-usefulapi": {
      "type": "http",
      "url": "https://runcloud.usefulapi.io/mcp"
    }
  }
}

README

RunCloud MCP by usefulapi

Use RunCloud from Claude, Cursor, or any MCP client — servers, web apps, domains, SSL, databases, cron jobs and logs, plus deploys, service restarts and SSL renewal. Hosted, no local install: connect with your own RunCloud credentials.

Live endpoint: https://runcloud.usefulapi.io/mcp · Homepage: https://usefulapi.io/runcloud

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://runcloud.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http runcloud https://runcloud.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "runcloud": {      "url": "https://runcloud.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your RunCloud credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/runcloud/

Tools

ToolTypeWhat it does
runcloud_pingreadCheck API connection
runcloud_list_serversreadList servers
runcloud_get_serverreadGet server
runcloud_get_server_statsreadGet server counts
runcloud_get_server_hardwarereadGet server hardware info
runcloud_get_server_healthreadGet latest server health
runcloud_list_server_logsreadList server activity logs
runcloud_list_servicesreadList server services
runcloud_list_system_usersreadList system users
runcloud_list_webappsreadList web applications
runcloud_get_webappreadGet web application
runcloud_get_webapp_settingsreadGet web application settings
runcloud_list_webapp_logsreadList web application activity logs
runcloud_list_domainsreadList domain names
runcloud_get_domain_dnsreadGet domain DNS setup instructions
runcloud_get_webapp_sslreadGet web application SSL
runcloud_get_ssl_methodreadCheck SSL method and AutoSSL status
runcloud_get_git_deploymentreadGet Git deployment
runcloud_list_databasesreadList databases
runcloud_list_database_usersreadList database users
runcloud_list_cronjobsreadList cron jobs
runcloud_list_supervisorsreadList supervisor jobs
runcloud_get_supervisor_statusreadGet supervisor job status
runcloud_list_firewall_rulesreadList firewall rules
runcloud_list_blocked_ipsreadList Fail2Ban blocked IPs
runcloud_list_backupsreadList backups
runcloud_list_backup_snapshotsreadList backup snapshots
runcloud_list_atomic_projectsreadList atomic deployment projects
runcloud_list_atomic_deploymentsreadList atomic deployments
runcloud_control_servicewriteStart, restart or reload a service
runcloud_deploy_gitwriteForce a Git deployment
runcloud_force_deploy_atomicwriteForce an atomic deployment
runcloud_run_cronjobwriteRun a cron job now
runcloud_reload_supervisorwriteReload a supervisor job
runcloud_renew_sslwriteRenew a Let's Encrypt certificate
runcloud_install_letsencrypt_sslwriteIssue a Let's Encrypt certificate
runcloud_usage_statusmetaUsage status (free-tier meter)
runcloud_request_featuremetaRequest a missing feature
runcloud_upgrademetaUpgrade to Pro or Pro+
runcloud_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with runcloud_upgrade (it returns a Stripe Checkout link). Cancel any time with runcloud_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running runcloud_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT © usefulapi. Not affiliated with or endorsed by RunCloud.

Source: servers/runcloud/README.md at commit 4046075

Tools

36

runcloud_ping

Check API connection

Check that the API key works: RunCloud answers with a message ('pong'). GET /ping.

Takes no parameters.

runcloud_list_servers

List servers

List the servers connected to the workspace: id, name, provider, IP address, OS, stack, online/connected state, agent and PHP CLI version, auto-update settings and tags. GET /servers.

Parameterspageper_page

runcloud_get_server

Get server

One server by id: provider, IP, OS and version, stack, online state, agent version, update settings, tags. GET /servers/{id}.

Parametersserver_idrequired

runcloud_get_server_stats

Get server counts

How many web applications, databases, cron jobs and supervisor jobs a server has, and its country. GET /servers/{id}/stats.

Parametersserver_idrequired

runcloud_get_server_hardware

Get server hardware info

Kernel version, CPU model and cores, memory and disk totals/free, load average and uptime of a server. GET /servers/{id}/hardwareinfo.

Parametersserver_idrequired

runcloud_get_server_health

Get latest server health

The latest health sample of a server: total/available/used memory and disk space (MB) and load average. GET /servers/{id}/health/latest.

Parametersserver_idrequired

runcloud_list_server_logs

List server activity logs

The server's activity log (what was changed in RunCloud and when), newest first. GET /servers/{id}/logs.

Parameterspageper_pageserver_idrequired

runcloud_list_services

List server services

The services on a server (nginx, php-fpm, mariadb, redis, supervisor...) with real name, running state, CPU, memory and version. The realName is what runcloud_control_service needs. GET /servers/{id}/services.

Parametersserver_idrequired

runcloud_list_system_users

List system users

The system (Linux) users on a server: id, username, whether deletable. Deployment keys and passwords are never returned. GET /servers/{id}/users.

Parameterspageper_pageserver_idrequired

runcloud_list_webapps

List web applications

List the web applications on a server: id, name, root/public path, PHP version, stack, type (wordpress, custom...), default flag, alias. Deployment webhook keys are not returned. GET /servers/{id}/webapps.

Parameterspagesearchper_pageserver_idrequired

runcloud_get_webapp

Get web application

One web application by id (path, PHP version, stack, type, default flag). GET /servers/{id}/webapps/{webapp}.

Parametersserver_idrequiredwebapp_idrequired

runcloud_get_webapp_settings

Get web application settings

PHP and FPM/Nginx settings of a web application (disabled functions, timezone, memory and upload limits, process manager...). GET /servers/{id}/webapps/{webapp}/settings.

Parametersserver_idrequiredwebapp_idrequired

runcloud_list_webapp_logs

List web application activity logs

The activity log of a web application (settings changes, PHP version changes, deployments), newest first. GET /servers/{id}/webapps/{webapp}/log.

Parameterspageper_pageserver_idrequiredwebapp_idrequired

runcloud_list_domains

List domain names

The domain names of a web application: id, name, type (primary/alias), www, redirection, wildcard, DNS integration, status. GET /servers/{id}/webapps/{webapp}/domains.

Parameterspageper_pageserver_idrequiredwebapp_idrequired

runcloud_get_domain_dns

Get domain DNS setup instructions

The DNS records (A, CNAME...) a domain name needs to point at the server. GET /servers/{id}/webapps/{webapp}/domains/{domain}/dns.

Parametersdomain_idrequiredserver_idrequiredwebapp_idrequired

runcloud_get_webapp_ssl

Get web application SSL

The web application's SSL certificate (basic / web-app-level SSL): provider, validity, HTTPS settings. Private keys are never returned. GET /servers/{id}/webapps/{webapp}/ssl.

Parametersserver_idrequiredwebapp_idrequired

runcloud_get_ssl_method

Check SSL method and AutoSSL status

Whether the web application uses basic (one certificate for the app) or advanced (one per domain) SSL, and its AutoSSL status. Advanced SSL is a Business/Enterprise feature. GET /servers/{id}/webapps/{webapp}/ssl/advanced.

Parametersserver_idrequiredwebapp_idrequired

runcloud_get_git_deployment

Get Git deployment

The Git deployment configured on a web application: provider, branch, repository URL, auto-deploy flag, deployment script and whether it is an atomic deployment. The deployment webhook keys are not returned. The id of the result is the git_id for runcloud_deploy_git. GET /servers/{id}/webapps/{webapp}/git.

Parametersserver_idrequiredwebapp_idrequired

runcloud_list_databases

List databases

The databases on a server: id, name, collation. No credentials. GET /servers/{id}/databases.

Parameterspageper_pageserver_idrequired

runcloud_list_database_users

List database users

The database users on a server (id, username). Passwords are never returned. GET /servers/{id}/databaseusers.

Parameterspageper_pageserver_idrequired

runcloud_list_cronjobs

List cron jobs

The cron jobs of a server: id, label, user, schedule, command, enabled flag. The id is what runcloud_run_cronjob needs. GET /servers/{id}/cronjobs.

Parameterspageper_pageserver_idrequired

runcloud_list_supervisors

List supervisor jobs

The supervisor (background worker) jobs of a server: id, label, user, process count, auto start/restart, directory, command. GET /servers/{id}/supervisors.

Parameterspageper_pageserver_idrequired

runcloud_get_supervisor_status

Get supervisor job status

The live status (RUNNING, FATAL, BACKOFF...), pid and uptime of every supervisor process, by job label. GET /servers/{id}/supervisors/status.

Parametersserver_idrequired

runcloud_list_firewall_rules

List firewall rules

The firewall rules of a server: type (global/rich), port, protocol, IP address, action. GET /servers/{id}/security/firewalls.

Parameterspageper_pageserver_idrequired

runcloud_list_blocked_ips

List Fail2Ban blocked IPs

The IP addresses Fail2Ban currently blocks on a server. GET /servers/{id}/security/fail2ban/blockedip.

Parametersserver_idrequired

runcloud_list_backups

List backups

The backup instances of the workspace: label, what they cover (web app / database), storage, type, frequency, size, status. Filter by server, storage, status or name. GET /backups.

Parameterspagesearchstatusstorageper_pageserver_id

runcloud_list_backup_snapshots

List backup snapshots

The snapshots of one backup instance: run date, status, type and size. GET /backups/{id}/snapshots.

Parameterspageper_pagebackup_idrequired

runcloud_list_atomic_projects

List atomic deployment projects

The atomic Git deployment projects of the workspace: name, provider, repository, branch, auto-deploy, success/failure counts and the latest deployment. Webhook keys are not returned. GET /atomic.

Parameterspageper_page

runcloud_list_atomic_deployments

List atomic deployments

The deployments of an atomic project: commit hash, branch, message, committer, release name, status (DEPLOYING, COMPLETED, FAILED), start and end time. GET /atomic/{project}/deployments.

Parameterspageper_pageproject_idrequired

runcloud_control_service

Start, restart or reload a service

WRITE: run systemctl start, restart or reload on one service of a server (for example nginx-rc or php81rc-fpm). A restart briefly interrupts that service and the sites behind it. 'stop' is deliberately not offered. Get the realName from runcloud_list_services. PATCH /servers/{id}/services.

Parametersactionrequiredreal_namerequiredserver_idrequired

runcloud_deploy_git

Force a Git deployment

WRITE: force a Git deployment of a web application now: RunCloud pulls the configured branch and runs the deployment script, which changes the live site's files. Get git_id from runcloud_get_git_deployment (its id). PUT /servers/{id}/webapps/{webapp}/git/{git}/script.

Parametersgit_idrequiredserver_idrequiredwebapp_idrequired

runcloud_force_deploy_atomic

Force an atomic deployment

WRITE: start an atomic deployment of a project now (builds a new release and switches the live symlink when it succeeds). PUT /atomic/{project}/forcedeploy.

Parametersproject_idrequired

runcloud_run_cronjob

Run a cron job now

WRITE: force-run one cron job of a server once, right now, outside its schedule. The job's command runs on the server with its configured user. Get the id from runcloud_list_cronjobs. POST /servers/{id}/cronjobs/{job}/run.

Parametersserver_idrequiredcronjob_idrequired

runcloud_reload_supervisor

Reload a supervisor job

WRITE: reload one supervisor job so its worker processes restart (running processes are interrupted). Get the id from runcloud_list_supervisors. POST /servers/{id}/supervisors/{job}/reload.

Parametersserver_idrequiredsupervisor_idrequired

runcloud_renew_ssl

Renew a Let's Encrypt certificate

WRITE: redeploy (renew) the Let's Encrypt certificate of a web application, which re-issues it and reloads the web server. Let's Encrypt certificates only. For basic SSL pass the ssl_id from runcloud_get_webapp_ssl; for advanced (per-domain) SSL, which requires advanced SSL mode (check runcloud_get_ssl_method), also pass domain_id. PUT /servers/{id}/webapps/{webapp}/ssl/{ssl} or /domains/{domain}/ssl/{ssl}.

Parametersssl_idrequireddomain_idserver_idrequiredwebapp_idrequired

runcloud_install_letsencrypt_ssl

Issue a Let's Encrypt certificate

WRITE: issue and install a free Let's Encrypt certificate for a web application (basic SSL) or for one domain of it (advanced SSL, pass domain_id; this requires advanced SSL mode, see runcloud_get_ssl_method). The web server is reloaded; the domain's DNS must already point at the server. Custom certificates are not supported here. POST /servers/{id}/webapps/{webapp}/ssl or /domains/{domain}/ssl.

Parametersdomain_idserver_idrequiredwebapp_idrequiredenable_hstsrequiredenable_httprequiredenvironmentexternal_apiauthorization_methodrequired

Version history

19
  1. v1.23.4LatestNov 7, 2026
  2. v1.22.3Nov 5, 2026
  3. v1.22.2Nov 5, 2026
  4. v1.22.1Nov 4, 2026
  5. v1.22.0Nov 3, 2026
  6. v1.21.1Nov 3, 2026
  7. v1.20.0Nov 1, 2026
  8. v1.18.0Oct 31, 2026
  9. v1.17.0Oct 31, 2026
  10. v1.16.2Oct 30, 2026
  11. v1.16.0Oct 30, 2026
  12. v1.11.0Oct 26, 2026
  13. v1.8.3Oct 25, 2026
  14. v1.8.0Oct 25, 2026
  15. v1.7.0Oct 24, 2026
  16. v1.4.0Oct 23, 2026
  17. v1.3.4Oct 22, 2026
  18. v1.3.3Oct 21, 2026
  19. v1.0.0Oct 12, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations

Ably MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for Ably realtime messaging: inspect channel history, presence and occupancy, publish messages, and review app usage and configuration.

Streamable HTTPWeb executable
Cloud & Infrastructure15 toolsNov 7, 2026

Woffu MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant look up Woffu company users, employment contracts, departments and offices.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

White Label Loyalty MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for White Label Loyalty: browse rewards, read a customer's points wallet and tier progress, and buy rewards with points.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

Weekdone MCP by usefulapi

io.usefulapiOfficial publisher

Hosted Weekdone connector that lets an assistant read weekly reports, teams, objectives and KPIs, and add report items, comments and KPI values.

Streamable HTTPWeb executable
Data & Analytics15 toolsNov 7, 2026

WebinarKit MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant list WebinarKit webinars, their dates, series, meetings and white-label sub-accounts.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026