deployhq-mcp-server — Claude Code MCP server: install
Connects an AI coding client to DeployHQ through MCP, so it can inspect projects, read deployment logs, and start deployments.
claude mcp add --env DEPLOYHQ_EMAIL=<DEPLOYHQ_EMAIL> --env DEPLOYHQ_API_KEY=<DEPLOYHQ_API_KEY> --env DEPLOYHQ_ACCOUNT=<DEPLOYHQ_ACCOUNT> --env LOG_LEVEL=<LOG_LEVEL> --transport stdio deployhq-mcp-server -- npx -y deployhq-mcp-serverWhat deployhq-mcp-server does
deployhq-mcp-server connects the DeployHQ API to an MCP client over stdio. An agent can list projects and project servers, inspect deployment details, read logs, and create a deployment from one commit to another for a selected server or server group.
The server also exposes account-level SSH keys, environment variables, and configuration file templates. These resources can be listed, created, updated, or deleted where the API supports it. The package runs through npx; access is supplied with DEPLOYHQ_EMAIL, DEPLOYHQ_API_KEY, and DEPLOYHQ_ACCOUNT. Without those variables, it cannot connect to DeployHQ.
What it helps with
- list DeployHQ projects and deployment status
- inspect servers configured for a project
- read logs from a failed deployment
- start a deployment between two revisions
- manage global variables and config templates
Example prompts for the agent
- List my DeployHQ projects and show their deployment status.
- Read the deployment log for project
<project>and deployment<uuid>. - Create a deployment for
<project>on<parent_identifier>from<start_revision>to<end_revision>.
How to install deployhq-mcp-server
Platform CLI
claude mcp add --env DEPLOYHQ_EMAIL=<DEPLOYHQ_EMAIL> --env DEPLOYHQ_API_KEY=<DEPLOYHQ_API_KEY> --env DEPLOYHQ_ACCOUNT=<DEPLOYHQ_ACCOUNT> --env LOG_LEVEL=<LOG_LEVEL> --transport stdio deployhq-mcp-server -- npx -y deployhq-mcp-serverReplace <…> with your own values
Platform CLI
codex mcp add deployhq-mcp-server --env DEPLOYHQ_EMAIL=<DEPLOYHQ_EMAIL> --env DEPLOYHQ_API_KEY=<DEPLOYHQ_API_KEY> --env DEPLOYHQ_ACCOUNT=<DEPLOYHQ_ACCOUNT> --env LOG_LEVEL=<LOG_LEVEL> -- npx -y deployhq-mcp-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"deployhq-mcp-server": {
"command": "npx",
"args": [
"-y",
"deployhq-mcp-server"
],
"env": {
"DEPLOYHQ_EMAIL": "<DEPLOYHQ_EMAIL>",
"DEPLOYHQ_API_KEY": "<DEPLOYHQ_API_KEY>",
"DEPLOYHQ_ACCOUNT": "<DEPLOYHQ_ACCOUNT>",
"LOG_LEVEL": "<LOG_LEVEL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"deployhq-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"deployhq-mcp-server"
],
"env": {
"DEPLOYHQ_EMAIL": "<DEPLOYHQ_EMAIL>",
"DEPLOYHQ_API_KEY": "<DEPLOYHQ_API_KEY>",
"DEPLOYHQ_ACCOUNT": "<DEPLOYHQ_ACCOUNT>",
"LOG_LEVEL": "<LOG_LEVEL>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e DEPLOYHQ_EMAIL=<DEPLOYHQ_EMAIL> -e DEPLOYHQ_API_KEY=<DEPLOYHQ_API_KEY> -e DEPLOYHQ_ACCOUNT=<DEPLOYHQ_ACCOUNT> -e LOG_LEVEL=<LOG_LEVEL> deployhq-mcp-server npx -y deployhq-mcp-serverReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about deployhq-mcp-server
How do I install deployhq-mcp-server in Claude Code?
Run `claude mcp add deployhq-mcp-server -e DEPLOYHQ_EMAIL=<DEPLOYHQ_EMAIL> -e DEPLOYHQ_API_KEY=<DEPLOYHQ_API_KEY> -e DEPLOYHQ_ACCOUNT=<DEPLOYHQ_ACCOUNT> -- npx -y deployhq-mcp-server`.
What does deployhq-mcp-server do?
It gives an MCP client access to DeployHQ projects, servers, deployments, logs, SSH keys, global environment variables, and config file templates.
What credentials are required?
Set DEPLOYHQ_EMAIL, DEPLOYHQ_API_KEY, and DEPLOYHQ_ACCOUNT as environment variables before connecting the server.
