Let Claude Code and Cursor deploy to your VPS
DeployOS is a desktop VPS manager with a built-in MCP server. Your AI assistant can see your servers and apps, read logs, run a diagnostic and - only if you switch it on - deploy, roll back, restart or scale, all through your own SSH connection. Nothing gets installed on your server.
What your AI assistant can do on your VPS
26 MCP tools in total. Everything that only reads is available the moment you turn AI assistant access on; everything that changes something is its own switch, off by default.
Inspect
List servers, apps and deployments, read app or proxy logs, check live CPU, RAM and disk, and see p50/p95/p99 request latency. Env vars show names only, never values.
Diagnose
Run the 9-step Doctor against a named app: DNS, ports, reverse proxy, container, network, route, health check, TLS and logs. Ask "why is my app down?" and get an answer.
Deploy and roll back
Deploy the latest commit through the same health-checked pipeline as the Deploy button, or roll back to a previous deployment. Instant if its image is still cached.
Operate
Restart or scale an app, set a single env var, deploy a one-click template, take a database backup, or manage cron jobs. Each one is a separate toggle.
You decide what the AI is allowed to touch
Giving an agent access to a server is a risk decision, so DeployOS splits it up instead of offering one big on/off switch.
Read access is separate from write access
Turning on AI assistant access does not grant write access to anything. Deploy, rollback, restart, scale, database queries and teardown are each off until you enable them in Settings.
Secrets stay unread
The assistant can check that DATABASE_URL is set. It cannot read what it is set to.
Risk labels your client can show
Every tool carries standard MCP annotations (read-only, destructive, idempotent), so clients like Claude Code can show accurate risk before calling one.
Clear refusals
Calling a tool you haven't enabled returns a plain "not enabled - turn it on in Settings" message rather than failing in a confusing way.
Set up in three steps
No account, token or separate credential. The MCP server reads the same servers and SSH keys already in DeployOS, from your OS keychain. The binary ships next to the app.
{
"mcpServers": {
"deployos": {
"command": "/Applications/DeployOS.app/Contents/MacOS/mcp_server"
}
}
}1. Turn it on
Open Settings, then AI assistant access, and switch it on. DeployOS shows the exact binary path for your machine.
2. Paste the config
Add the server to Cursor's or Claude Code's MCP config (example below; Settings fills in your real path).
3. Restart and ask
Restart your assistant, then try "list my DeployOS apps" or "run Doctor on my-app."
Local by design
The MCP server talks to your assistant over local stdio on your own machine, and to your VPS over SSH. There is no DeployOS cloud in the middle, so nothing about your servers, apps or keys is sent to us. It is as private as running a command in your terminal and pasting the output into a chat, except automated. It works with Claude Code, Cursor and other MCP-compatible assistants.
Questions
What is an MCP server for VPS management?
MCP (Model Context Protocol) is the standard way AI assistants call tools. An MCP server for VPS management exposes actions like list apps, read logs, deploy and roll back as typed tools, so an assistant such as Claude Code or Cursor can operate a server instead of only writing code for it.
Can Claude Code deploy to my own VPS?
Yes. Turn on AI assistant access in DeployOS, add the local MCP server to Claude Code, and enable the deploy tool. Claude Code then deploys through DeployOS's normal pipeline: build, publish the route, and health check.
Is it safe to give an AI assistant access to my server?
Read access and each write action are separate switches and all write actions are off by default. Secrets are never returned, only variable names, and everything runs locally over your existing SSH connection. Enable only what you need, and keep destructive tools like teardown and database queries off unless you want them.
Do I need to install anything on my server?
No. DeployOS connects over SSH and bootstraps Docker, a reverse proxy and a firewall itself. There is no agent or DeployOS control panel left running on the server.
Which VPS providers work?
Any provider that gives you SSH access to a Linux server: Hetzner, DigitalOcean, Vultr, Contabo, Linode, OVH, AWS, Hostinger and others.
Keep reading
Free plan for one server, Solo $79, Pro $149 - one-time, includes a year of updates.