Deployado MCP Server

Connect your AI coding assistant to Deployado. Deploy, manage apps, view logs, and more — directly from Claude Code, Cursor, or any MCP-compatible client.

Overview

The Deployado MCP (Model Context Protocol) server allows AI assistants to interact with your Deployado infrastructure. Instead of switching between your editor and the dashboard, your AI assistant can deploy apps, check logs, manage databases, and more — all within your coding workflow.

It is published on npm as deployado-mcp and runs locally over stdio: your MCP client starts it with npx, so there is nothing to install globally.

58 Tools

Apps, deployments, builds, env vars, databases, domains, cron jobs, services, backups, and diagnostics.

Safe by default

Read-only tools are annotated as read-only and destructive ones (delete, remove, restore, …) as destructive, so your MCP client can ask for confirmation first.

Any Project

Configure once, use from every project. Works globally across your workspace.

Prerequisites

Node.js 22+ — Required to run the MCP server
Deployado account — Sign up if you don't have one
API Token — Generate one from https://deployado.com/settings/api-tokens
MCP-compatible client — Claude Code, Claude Desktop, Cursor, Windsurf, or any other MCP client

Note: The MCP server authenticates with an API token passed in DEPLOYADO_API_TOKEN. This is separate from the CLI: logging in with deployado auth login does not configure the MCP server.

Installation

Claude Code

Terminal

$ claude mcp add deployado --env DEPLOYADO_API_TOKEN=<your-token> -- npx -y deployado-mcp

Add --scope user (right after claude mcp add) to make it available in every project instead of only the current one. Run claude mcp list to confirm it is connected.

Claude Desktop / Cursor / Windsurf / other clients

Add this to your client's MCP configuration file (for example claude_desktop_config.json in Claude Desktop or ~/.cursor/mcp.json in Cursor), then restart the client:

mcpServers (JSON)

{
  "mcpServers": {
    "deployado": {
      "command": "npx",
      "args": ["-y", "deployado-mcp"],
      "env": {
        "DEPLOYADO_API_TOKEN": "your-token-here"
      }
    }
  }
}

Environment Variables

Variable	Required	Description
`DEPLOYADO_API_TOKEN`	Yes	API token created at https://deployado.com/settings/api-tokens
`DEPLOYADO_BASE_URL`	No	API base URL (default: https://deployado.com)

Optional: global install

If you prefer not to use npx, install the package globally and use deployado-mcp as the command (with no args) in your client configuration:

Terminal

$ npm install -g deployado-mcp

Available Tools

The MCP server exposes 58 tools organized by resource type. Your AI assistant can use any of these to interact with your Deployado infrastructure.

Account

Verify which account and token the server is using


                      deployado_whoami

Show the current account, user, and API token info

Apps

Manage your applications


                      deployado_list_apps

List all apps, optionally filtered by project


                      deployado_get_app

Get detailed info about an app


                      deployado_create_app

Create a new app in a project


                      deployado_update_app

Update app configuration


                      deployado_delete_app

Permanently delete an app with its deployments, releases, and env vars

Releases & builds

Inspect builds and find out why one failed


                      deployado_list_releases

List releases with version history and build status


                      deployado_get_release

Get a release's build status, commit info, and error details


                      deployado_get_build_logs

Fetch the build logs for a release


                      deployado_release_logs

Fetch the docker build transcript for a release, in progress or finished

Deployments

Deploy, roll back, and monitor rollouts


                      deployado_deploy

Trigger a new deployment; returns a release_id while the build runs


                      deployado_rollback

Roll back an app to a previous release


                      deployado_list_deployments

List recent deployments for an app


                      deployado_get_deployment

Get deployment details with phases and errors


                      deployado_current_deployment

Get the currently active deployment

Environment variables

Manage app configuration


                      deployado_list_env

List an app's environment variables (secrets may be masked)


                      deployado_set_env

Set or update environment variables (merged with existing)


                      deployado_delete_env

Delete an environment variable

Servers

View your infrastructure


                      deployado_list_servers

List servers with status and resource metrics


                      deployado_get_server

Get server details: agent version, OS, architecture, Docker version

Projects

Organize apps into projects


                      deployado_list_projects

List all projects


                      deployado_get_project

Get project details


                      deployado_create_project

Create a new project


                      deployado_update_project

Update a project's name, description, or settings


                      deployado_delete_project

Delete a project and all its apps

Databases

Manage PostgreSQL databases


                      deployado_list_databases

List managed PostgreSQL databases


                      deployado_get_database

Get database details and connection info


                      deployado_create_database

Create a new PostgreSQL database


                      deployado_delete_database

Permanently delete a database and all its data


                      deployado_connect_database

Connect an app to a database (injects the connection URL as an env var)


                      deployado_disconnect_database

Disconnect an app from a database

Exec

Run commands inside your containers


                      deployado_exec

Run a command inside an app's running container (60s timeout)

Blueprints

Deploy whole stacks from YAML


                      deployado_validate_blueprint

Validate a blueprint YAML without deploying


                      deployado_deploy_blueprint

Deploy an entire stack from inline YAML or a GitHub repository

Domains

Custom domains and DNS verification


                      deployado_list_domains

List an app's domains, including its subdomain


                      deployado_add_domain

Add a custom domain to an app


                      deployado_remove_domain

Remove a custom domain from an app


                      deployado_set_primary_domain

Set an app's primary domain


                      deployado_verify_domains

Verify DNS for all of an app's domains

Cron jobs

Scheduled tasks per app


                      deployado_list_cron_jobs

List an app's cron jobs


                      deployado_create_cron_job

Create a cron job


                      deployado_update_cron_job

Update a cron job


                      deployado_delete_cron_job

Delete a cron job


                      deployado_run_cron_job

Run a cron job immediately

Services

Marketplace services (caches, monitoring, and more)


                      deployado_list_service_templates

Browse marketplace service templates


                      deployado_list_services

List installed services


                      deployado_get_service

Get details of an installed service


                      deployado_install_service

Install a service from a template


                      deployado_start_service

Start a stopped service


                      deployado_stop_service

Stop a running service


                      deployado_restart_service

Restart a service

Backups

Database backups stored in S3


                      deployado_list_backup_targets

List backup targets


                      deployado_create_backup_target

Create a backup target


                      deployado_get_backup_target

Get a backup target and its recent runs


                      deployado_run_backup

Trigger a backup now


                      deployado_restore_backup

Restore a database from a backup run (overwrites the database)

Diagnostics

Find out what's wrong with an app


                      deployado_doctor

Run the diagnostic checklist: deployment, build, server, instances, HTTP probe, env, placement


                      deployado_get_logs

Fetch recent runtime logs from an app's container (not build logs)

Prompts & Resources

Prompt


                  deployado_status

Full overview of your infrastructure: apps, servers, and databases

Resource


                  deployado://apps

JSON summary of all apps with their IDs, names, and projects

Resource


                  deployado://servers

JSON overview of all servers with status and resource metrics

Usage Examples

Once configured, you can ask your AI assistant to perform any Deployado operation using natural language.

Diagnose a broken app

"My app is returning 502s. What's wrong?"

Uses deployado_doctordeployado_get_logs

Deploy your app

"Deploy my app to production"

Uses deployado_deploy

Find out why a build failed

"The last deploy failed. Show me the build output."

Uses deployado_list_releasesdeployado_release_logs

Set environment variables

"Set DATABASE_URL and SECRET_KEY_BASE for my app"

Uses deployado_set_env

Run a database migration

"Run 'mix ecto.migrate' inside my app container"

Uses deployado_exec

Create a database and connect it

"Create a PostgreSQL database and connect it to my app"

Uses deployado_create_databasedeployado_connect_database

Tip: The AI assistant will automatically discover and use the right tools. Just describe what you want to do in natural language — no need to remember tool names.

Need Help?

If you run into any issues, we're here to help.

Contact Support