Manage a self-hosted DNS firewall: block domains, create policies, read query logs and metrics.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add hydradns --env HYDRA_API_URL='<HYDRA_API_URL>' --env HYDRA_TOKEN='<HYDRA_TOKEN>' -- docker run -i --rm -e HYDRA_API_URL -e HYDRA_TOKEN ghcr.io/hydradns/hydra-cli:0.1.0~/.codex/config.toml
[mcp_servers.hydradns]
command = "docker"
args = ["run", "-i", "--rm", "-e", "HYDRA_API_URL", "-e", "HYDRA_TOKEN", "ghcr.io/hydradns/hydra-cli:0.1.0"]
env = { HYDRA_API_URL = "<HYDRA_API_URL>", HYDRA_TOKEN = "<HYDRA_TOKEN>" }
# codex mcp add hydradns --env HYDRA_API_URL='<HYDRA_API_URL>' --env HYDRA_TOKEN='<HYDRA_TOKEN>' -- docker run -i --rm -e HYDRA_API_URL -e HYDRA_TOKEN ghcr.io/hydradns/hydra-cli:0.1.0~/.cursor/mcp.json
{
"mcpServers": {
"hydradns": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"HYDRA_API_URL",
"-e",
"HYDRA_TOKEN",
"ghcr.io/hydradns/hydra-cli:0.1.0"
],
"env": {
"HYDRA_API_URL": "<HYDRA_API_URL>",
"HYDRA_TOKEN": "<HYDRA_TOKEN>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"hydradns": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"HYDRA_API_URL",
"-e",
"HYDRA_TOKEN",
"ghcr.io/hydradns/hydra-cli:0.1.0"
],
"env": {
"HYDRA_API_URL": "<HYDRA_API_URL>",
"HYDRA_TOKEN": "<HYDRA_TOKEN>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"hydradns": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"HYDRA_API_URL",
"-e",
"HYDRA_TOKEN",
"ghcr.io/hydradns/hydra-cli:0.1.0"
],
"env": {
"HYDRA_API_URL": "<HYDRA_API_URL>",
"HYDRA_TOKEN": "<HYDRA_TOKEN>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"hydradns": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"HYDRA_API_URL",
"-e",
"HYDRA_TOKEN",
"ghcr.io/hydradns/hydra-cli:0.1.0"
],
"env": {
"HYDRA_API_URL": "<HYDRA_API_URL>",
"HYDRA_TOKEN": "<HYDRA_TOKEN>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"hydradns": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"HYDRA_API_URL",
"-e",
"HYDRA_TOKEN",
"ghcr.io/hydradns/hydra-cli:0.1.0"
],
"env": {
"HYDRA_API_URL": "<HYDRA_API_URL>",
"HYDRA_TOKEN": "<HYDRA_TOKEN>"
}
}
}
}Environment variables
HYDRA_API_URLHYDRA_TOKEN
Replace the placeholders with your own credentials and keep them out of version control.