vito-mcp

MCP server wrapping the full VitoDeploy REST API — manage projects, servers, sites, databases, services, workers, SSL, DNS, and more through any MCP-compatible agent.

108 tools covering every endpoint in the VitoDeploy OpenAPI spec.

Install

One-liner (env vars, non-interactive)

curl -fsSL https://raw.githubusercontent.com/xerxes-on/vito-mcp/main/install.sh | VITO_API_TOKEN=xxx VITO_AGENT=1 sh

VITO_AGENT: 1=Claude Code, 2=Codex, 3=Cursor, 4=Windsurf, 5=Generic

Interactive

curl -fsSL https://raw.githubusercontent.com/xerxes-on/vito-mcp/main/install.sh -o install.sh
sh install.sh

Clones, builds, and interactively configures your MCP client.

Manual

git clone https://github.com/xerxes-on/vito-mcp.git
cd vito-mcp
npm install && npm run build
./install.sh   # or configure manually below

Requires Node.js 22+.

Configure manually

Generate a Vito API token in your VitoDeploy panel: Settings → API Keys → Create.

Claude Code

claude mcp add -s user vito \
  --env VITO_API_TOKEN=<your-token> \
  -- node /path/to/vito-mcp/dist/index.js

Codex

codex mcp add vito \
  --env VITO_API_TOKEN=<your-token> \
  -- node /path/to/vito-mcp/dist/index.js

Cursor

{
  "mcpServers": {
    "vito": {
      "command": "node",
      "args": ["/path/to/vito-mcp/dist/index.js"],
      "env": {
        "VITO_API_TOKEN": "<your-token>"
      }
    }
  }
}

Windsurf / Generic MCP Client

{
  "mcpServers": {
    "vito": {
      "command": "node",
      "args": ["/path/to/vito-mcp/dist/index.js"],
      "env": {
        "VITO_API_TOKEN": "<your-token>"
      }
    }
  }
}

Global install

npm install -g .
vito-mcp   # starts on stdio (requires VITO_API_TOKEN in env)

Environment Variables

Variable	Default	Description
VITO_API_TOKEN	(required)	Sanctum API token from VitoDeploy panel
VITO_BASE_URL	https://mindep.celion.io	VitoDeploy panel URL
VITO_TIMEOUT_SECONDS	30	HTTP request timeout in seconds

Tools

Projects & Servers

list_projects create_project get_project update_project delete_project list_servers create_server get_server delete_server reboot_server upgrade_server

Sites & Deployments

list_sites create_site get_site delete_site deploy_site update_site_aliases update_web_directory get_deployment_script update_deployment_script get_site_env update_site_env list_deployments create_deployment get_deployment

Services

list_services get_service uninstall_service start_service stop_service restart_service reload_service enable_service disable_service

Databases & Users

list_databases create_database get_database delete_database list_database_users create_database_user get_database_user link_database_user delete_database_user

Workers (Supervisor)

list_workers create_worker get_worker delete_worker

Cron Jobs

list_cron_jobs create_cron_job get_cron_job delete_cron_job list_site_cron_jobs create_site_cron_job get_site_cron_job delete_site_cron_job

Firewall & SSL

list_firewall_rules create_firewall_rule get_firewall_rule delete_firewall_rule list_ssl_certificates create_ssl_certificate get_ssl_certificate delete_ssl_certificate

Workflows

list_workflows get_workflow delete_workflow list_workflow_runs run_workflow get_workflow_run get_workflow_run_logs

Domains & DNS

list_domains add_domain get_domain remove_domain get_available_domains list_dns_records create_dns_record get_dns_record update_dns_record delete_dns_record sync_dns_records list_dns_providers create_dns_provider get_dns_provider update_dns_provider delete_dns_provider

Providers

list_server_providers create_server_provider get_server_provider update_server_provider delete_server_provider get_server_provider_regions get_server_provider_plans list_storage_providers create_storage_provider get_storage_provider update_storage_provider delete_storage_provider list_source_controls create_source_control get_source_control update_source_control delete_source_control

Convenience

Tool	Description
deploy_by_domain(domain)	Find site by domain substring and trigger deploy. Case-insensitive.
find_site_by_domain(domain)	Same lookup without deploying.
restart_php_fpm_by_site(domain)	Find site → find PHP services → restart all.
find_services_by_type(project_id, server_id, type)	Find services by type (php, nginx, redis, etc.).

License

MIT