DeployHQ MCP Server

A Model Context Protocol (MCP) server for DeployHQ that enables AI assistants like Claude Desktop and Claude Code to interact with your DeployHQ deployments.

🚀 Features

• Full DeployHQ API Integration: Access projects, servers, and deployments
• Easy Installation: Use directly with npx - no installation required
• Works with Claude Desktop & Claude Code: stdio transport for both MCP clients
• Secure: Credentials via environment variables, never stored
• Type-Safe: Built with TypeScript and Zod validation
• Multiple Transports: stdio (primary), SSE, and HTTP (optional for hosting)
• Production-Ready: Comprehensive error handling and logging

📋 Available Tools

The MCP server provides 18 tools for AI assistants:

Tool	Description	Parameters
list_projects	List all projects	None
get_project	Get project details	permalink
list_servers	List project servers	project
list_deployments	List deployments with pagination	project, page?, server_uuid?
get_deployment	Get deployment details	project, uuid
get_deployment_log	Get deployment log output	project, uuid
create_deployment	Create new deployment	project, parent_identifier, start_revision, end_revision, + optional params
list_ssh_keys	List all SSH public keys	None
create_ssh_key	Create a new SSH key pair	title, key_type?
list_global_environment_variables	List all global environment variables	None
create_global_environment_variable	Create a global environment variable	name, value, locked?, build_pipeline?
update_global_environment_variable	Update a global environment variable	id, name?, value?, locked?, build_pipeline?
delete_global_environment_variable	Delete a global environment variable	id
list_global_config_files	List all global config file templates	None
get_global_config_file	Get a global config file with body	id
create_global_config_file	Create a global config file template	path, body, description?, build?
update_global_config_file	Update a global config file template	id, path?, body?, description?, build?
delete_global_config_file	Delete a global config file template	id

list_projects

List all projects in your DeployHQ account.

Returns: Array of projects with repository information and deployment status.

get_project

Get detailed information about a specific project.

Parameters:

• permalink (string): Project permalink or identifier

list_servers

List all servers configured for a project.

Parameters:

• project (string): Project permalink

list_deployments

List deployments for a project with pagination support.

Parameters:

• project (string): Project permalink
• page (number, optional): Page number for pagination
• server_uuid (string, optional): Filter by server UUID

get_deployment

Get detailed information about a specific deployment.

Parameters:

• project (string): Project permalink
• uuid (string): Deployment UUID

get_deployment_log

Get the deployment log for a specific deployment. Useful for debugging failed deployments.

Parameters:

• project (string): Project permalink
• uuid (string): Deployment UUID

Returns: Complete deployment log as text

create_deployment

Create a new deployment for a project.

Parameters:

• project (string): Project permalink
• parent_identifier (string): Server or server group UUID
• start_revision (string): Starting commit hash
• end_revision (string): Ending commit hash
• branch (string, optional): Branch to deploy from
• mode (string, optional): "queue" or "preview"
• copy_config_files (boolean, optional): Copy config files
• run_build_commands (boolean, optional): Run build command

... View full README on GitHub