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.
28 Tools
Full coverage of the Deployado API — apps, databases, deployments, env vars, and more.
Secure
Uses your API token — same authentication as the CLI and REST API.
Any Project
Configure once, use from every project. Works globally across your workspace.
Prerequisites
- Node.js 20+ — Required to run the MCP server
- Deployado account — Sign in if you don't have one
- API Token — Generate one from Settings → API Tokens
- MCP-compatible client — Claude Code, Cursor, Windsurf, or any other MCP client
Installation
Install from npm
$ npm install -g deployado-mcp
Or install from source
$ git clone https://github.com/rbaezam/deployado-mcp.git
$ cd deployado-mcp
$ npm install && npm run build
Configuration
Add the MCP server to your AI client's configuration. Here are examples for the most popular clients.
Claude Code
Add to your ~/.claude.json:
{
"mcpServers": {
"deployado": {
"command": "npx",
"args": ["-y", "deployado-mcp"],
"env": {
"DEPLOYADO_API_TOKEN": "your-token-here"
}
}
}
}Cursor / Windsurf
Add to your MCP settings (Settings → MCP Servers):
{
"mcpServers": {
"deployado": {
"command": "npx",
"args": ["-y", "deployado-mcp"],
"env": {
"DEPLOYADO_API_TOKEN": "your-token-here"
}
}
}
}Environment Variables
| Variable | Required | Description |
|---|---|---|
DEPLOYADO_API_TOKEN |
Yes | Your API token from Settings → API Tokens |
DEPLOYADO_BASE_URL |
No | API base URL (default: https://deployado.com) |
Available Tools
The MCP server exposes 28 tools organized by resource type. Your AI assistant can use any of these to interact with your Deployado infrastructure.
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
deployado_deploy
Trigger a new deployment
deployado_rollback
Rollback to a previous release
deployado_list_releases
View release version history
deployado_get_logs
Fetch container logs
Deployments
Monitor deployment status and history
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 all environment variables
deployado_set_env
Set or update environment variables
deployado_delete_env
Delete an environment variable
Databases
Manage PostgreSQL databases
deployado_list_databases
List all databases
deployado_get_database
Get database details and connection info
deployado_create_database
Create a new PostgreSQL database
deployado_delete_database
Delete a database
deployado_connect_database
Connect an app to a database
deployado_disconnect_database
Disconnect an app from a database
Servers & Projects
View infrastructure and project information
deployado_list_servers
List servers with status and resource metrics
deployado_get_server
Get detailed server information
deployado_list_projects
List all projects
deployado_get_project
Get project details
Exec, Blueprints & Account
Remote execution, stack deployment, and account info
deployado_exec
Run a command inside a running container
deployado_validate_blueprint
Validate a blueprint YAML without deploying
deployado_deploy_blueprint
Deploy an entire stack from a blueprint
deployado_whoami
Show current account and token info
Usage Examples
Once configured, you can ask your AI assistant to perform any Deployado operation using natural language.
Deploy your apps
"Deploy my app to production"
Uses deployado_deploy
Check deployment status
"What's the status of my latest deployment?"
Uses deployado_current_deployment
View logs
"Show me the last 50 lines of logs for my app"
Uses deployado_get_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_database + deployado_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.