MCP server for Hatchbox Rails hosting — env var inspection, deploys, and process monitoring.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add hatchbox --env HATCHBOX_API_KEY='<HATCHBOX_API_KEY>' --env HATCHBOX_ACCOUNT_ID='<HATCHBOX_ACCOUNT_ID>' --env HATCHBOX_APP_ID='<HATCHBOX_APP_ID>' --env HATCHBOX_DEPLOY_KEY='<HATCHBOX_DEPLOY_KEY>' -- npx -y hatchbox-mcp-server~/.codex/config.toml
[mcp_servers.hatchbox]
command = "npx"
args = ["-y", "hatchbox-mcp-server"]
env = { HATCHBOX_API_KEY = "<HATCHBOX_API_KEY>", HATCHBOX_ACCOUNT_ID = "<HATCHBOX_ACCOUNT_ID>", HATCHBOX_APP_ID = "<HATCHBOX_APP_ID>", HATCHBOX_DEPLOY_KEY = "<HATCHBOX_DEPLOY_KEY>" }
# codex mcp add hatchbox --env HATCHBOX_API_KEY='<HATCHBOX_API_KEY>' --env HATCHBOX_ACCOUNT_ID='<HATCHBOX_ACCOUNT_ID>' --env HATCHBOX_APP_ID='<HATCHBOX_APP_ID>' --env HATCHBOX_DEPLOY_KEY='<HATCHBOX_DEPLOY_KEY>' -- npx -y hatchbox-mcp-server~/.cursor/mcp.json
{
"mcpServers": {
"hatchbox": {
"command": "npx",
"args": [
"-y",
"hatchbox-mcp-server"
],
"env": {
"HATCHBOX_API_KEY": "<HATCHBOX_API_KEY>",
"HATCHBOX_ACCOUNT_ID": "<HATCHBOX_ACCOUNT_ID>",
"HATCHBOX_APP_ID": "<HATCHBOX_APP_ID>",
"HATCHBOX_DEPLOY_KEY": "<HATCHBOX_DEPLOY_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"hatchbox": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"hatchbox-mcp-server"
],
"env": {
"HATCHBOX_API_KEY": "<HATCHBOX_API_KEY>",
"HATCHBOX_ACCOUNT_ID": "<HATCHBOX_ACCOUNT_ID>",
"HATCHBOX_APP_ID": "<HATCHBOX_APP_ID>",
"HATCHBOX_DEPLOY_KEY": "<HATCHBOX_DEPLOY_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"hatchbox": {
"command": "npx",
"args": [
"-y",
"hatchbox-mcp-server"
],
"env": {
"HATCHBOX_API_KEY": "<HATCHBOX_API_KEY>",
"HATCHBOX_ACCOUNT_ID": "<HATCHBOX_ACCOUNT_ID>",
"HATCHBOX_APP_ID": "<HATCHBOX_APP_ID>",
"HATCHBOX_DEPLOY_KEY": "<HATCHBOX_DEPLOY_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"hatchbox": {
"command": "npx",
"args": [
"-y",
"hatchbox-mcp-server"
],
"env": {
"HATCHBOX_API_KEY": "<HATCHBOX_API_KEY>",
"HATCHBOX_ACCOUNT_ID": "<HATCHBOX_ACCOUNT_ID>",
"HATCHBOX_APP_ID": "<HATCHBOX_APP_ID>",
"HATCHBOX_DEPLOY_KEY": "<HATCHBOX_DEPLOY_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"hatchbox": {
"command": "npx",
"args": [
"-y",
"hatchbox-mcp-server"
],
"env": {
"HATCHBOX_API_KEY": "<HATCHBOX_API_KEY>",
"HATCHBOX_ACCOUNT_ID": "<HATCHBOX_ACCOUNT_ID>",
"HATCHBOX_APP_ID": "<HATCHBOX_APP_ID>",
"HATCHBOX_DEPLOY_KEY": "<HATCHBOX_DEPLOY_KEY>"
}
}
}
}Environment variables
HATCHBOX_API_KEYHATCHBOX_ACCOUNT_IDHATCHBOX_APP_IDHATCHBOX_DEPLOY_KEY
Replace the placeholders with your own credentials and keep them out of version control.