# deployhq-mcp-server

Connects an AI coding client to DeployHQ through MCP, so it can inspect projects, read deployment logs, and start deployments.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 13
- Author: deployhq
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/deployhq/deployhq-mcp-server
- Updated: 2026-07-22
- HTML: https://affpapa.org/en/nevibecode/mcp/deployhq-mcp-server

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `DEPLOYHQ_EMAIL`, `DEPLOYHQ_API_KEY`, `DEPLOYHQ_ACCOUNT`, `LOG_LEVEL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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-server
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
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-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
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-server
```
Replace <…> with your own values

## When to use it
- 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
- 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>`.

## Similar
- [troubleshooting-astro-deployments](https://affpapa.org/en/nevibecode/skills/troubleshooting-astro-deployments.md) — skill · 622 installs
- [omni-version-manager](https://affpapa.org/en/nevibecode/skills/omni-version-manager.md) — skill · 975 installs
- [status](https://affpapa.org/en/nevibecode/commands/status.md) — command · 348 installs
- [vercel](https://affpapa.org/en/nevibecode/mcp/vercel.md) — MCP server · ★ 81
- [hummingbot-developer](https://affpapa.org/en/nevibecode/skills/hummingbot-developer.md) — skill · 356 installs
- [vercel-api](https://affpapa.org/en/nevibecode/skills/vercel-api.md) — skill · 5 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md