Search / io.github.hydradns/hydra-mcp
HydraDNS
L0· runs locallyManage a self-hosted DNS firewall: block domains, create policies, read query logs and metrics.
v0.1.0 · active · repository · website · descriptor JSON · versions
Search / io.github.hydradns/hydra-mcp
L0· runs locallyManage a self-hosted DNS firewall: block domains, create policies, read query logs and metrics.
v0.1.0 · active · repository · website · descriptor JSON · versions
{
"mcpServers": {
"hydra-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"HYDRA_API_URL",
"-e",
"HYDRA_TOKEN",
"-e",
"MCP_ROLE",
"ghcr.io/hydradns/hydra-cli:0.1.0",
"mcp"
],
"env": {
"HYDRA_API_URL": "http://host.docker.internal:8080",
"HYDRA_TOKEN": "${HYDRA_TOKEN}",
"MCP_ROLE": "admin"
}
}
}
}claude mcp add hydra-mcp -e "HYDRA_API_URL=http://host.docker.internal:8080" -e "HYDRA_TOKEN=${HYDRA_TOKEN}" -e "MCP_ROLE=admin" -- docker run -i --rm -e HYDRA_API_URL -e HYDRA_TOKEN -e MCP_ROLE ghcr.io/hydradns/hydra-cli:0.1.0 mcp[mcp_servers.hydra-mcp]
command = "docker"
args = ["run", "-i", "--rm", "-e", "HYDRA_API_URL", "-e", "HYDRA_TOKEN", "-e", "MCP_ROLE", "ghcr.io/hydradns/hydra-cli:0.1.0", "mcp"]
env = { "HYDRA_API_URL" = "http://host.docker.internal:8080", "HYDRA_TOKEN" = "${HYDRA_TOKEN}", "MCP_ROLE" = "admin" }
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"hydra-mcp": {
"type": "local",
"command": [
"docker",
"run",
"-i",
"--rm",
"-e",
"HYDRA_API_URL",
"-e",
"HYDRA_TOKEN",
"-e",
"MCP_ROLE",
"ghcr.io/hydradns/hydra-cli:0.1.0",
"mcp"
],
"enabled": true,
"environment": {
"HYDRA_API_URL": "http://host.docker.internal:8080",
"HYDRA_TOKEN": "{env:HYDRA_TOKEN}",
"MCP_ROLE": "admin"
}
}
}
}{
"mcpServers": {
"hydra-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"HYDRA_API_URL",
"-e",
"HYDRA_TOKEN",
"-e",
"MCP_ROLE",
"ghcr.io/hydradns/hydra-cli:0.1.0",
"mcp"
],
"env": {
"HYDRA_API_URL": "http://host.docker.internal:8080",
"HYDRA_TOKEN": "${HYDRA_TOKEN}",
"MCP_ROLE": "admin"
}
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=hydra-mcp&config=eyJjb21tYW5kIjoiZG9ja2VyIiwiYXJncyI6WyJydW4iLCItaSIsIi0tcm0iLCItZSIsIkhZRFJBX0FQSV9VUkwiLCItZSIsIkhZRFJBX1RPS0VOIiwiLWUiLCJNQ1BfUk9MRSIsImdoY3IuaW8vaHlkcmFkbnMvaHlkcmEtY2xpOjAuMS4wIiwibWNwIl0sImVudiI6eyJIWURSQV9BUElfVVJMIjoiaHR0cDovL2hvc3QuZG9ja2VyLmludGVybmFsOjgwODAiLCJIWURSQV9UT0tFTiI6IiR7SFlEUkFfVE9LRU59IiwiTUNQX1JPTEUiOiJhZG1pbiJ9fQ%3D%3D"
}{
"servers": {
"hydra-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"HYDRA_API_URL",
"-e",
"HYDRA_TOKEN",
"-e",
"MCP_ROLE",
"ghcr.io/hydradns/hydra-cli:0.1.0",
"mcp"
],
"env": {
"HYDRA_API_URL": "http://host.docker.internal:8080",
"HYDRA_TOKEN": "${HYDRA_TOKEN}",
"MCP_ROLE": "admin"
}
}
}
}{
"mcpServers": {
"hydra-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"HYDRA_API_URL",
"-e",
"HYDRA_TOKEN",
"-e",
"MCP_ROLE",
"ghcr.io/hydradns/hydra-cli:0.1.0",
"mcp"
],
"env": {
"HYDRA_API_URL": "http://host.docker.internal:8080",
"HYDRA_TOKEN": "${HYDRA_TOKEN}",
"MCP_ROLE": "admin"
}
}
}
}extensions:
"hydra-mcp":
enabled: true
name: "hydra-mcp"
type: stdio
cmd: "docker"
args:
- "run"
- "-i"
- "--rm"
- "-e"
- "HYDRA_API_URL"
- "-e"
- "HYDRA_TOKEN"
- "-e"
- "MCP_ROLE"
- "ghcr.io/hydradns/hydra-cli:0.1.0"
- "mcp"
envs:
"HYDRA_API_URL": "http://host.docker.internal:8080"
"HYDRA_TOKEN": "${HYDRA_TOKEN}"
"MCP_ROLE": "admin"
timeout: 300
Placeholders to fill from your own secret store: ${HYDRA_TOKEN}. The registry never accepts secret values.
This is a local package: the command runs on your machine.
Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.
protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)auth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)stability.changes, stability.rug_pulltool list unknowndeps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI packageNo tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo +website ~liveness-unmeasured +updated-29d-ago -unpinned-packages(1)
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
| package | registry | version | runtime | secrets |
|---|---|---|---|---|
ghcr.io/hydradns/hydra-cli:0.1.0 | oci | unpinned | docker | HYDRA_TOKEN |
No tools observed. Local packages are never executed by the registry.
Schemas: list_tools.
{
"name": "io.github.hydradns/hydra-mcp",
"_meta": {
"io.modelcontextprotocol.registry/publisher-provided": {
"tool": "manual",
"version": "0.1.0"
}
},
"title": "HydraDNS",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"version": "0.1.0",
"packages": [
{
"transport": {
"type": "stdio"
},
"identifier": "ghcr.io/hydradns/hydra-cli:0.1.0",
"runtimeHint": "docker",
"registryType": "oci",
"packageArguments": [
{
"type": "positional",
"value": "mcp",
"valueHint": "mcp"
}
],
"environmentVariables": [
{
"name": "HYDRA_API_URL",
"default": "http://host.docker.internal:8080",
"isRequired": true,
"description": "Base URL of the HydraDNS controlplane API. Inside a container, 'localhost' means the container itself, not the host running the controlplane. On Docker Desktop (Mac/Windows) the default below resolves automatically. On plain Docker Engine (Linux) either run the container with --add-host=host.docker.internal:host-gateway, or use --network host with http://localhost:8080 instead. Full instructions: docs/mcp.md in the repo, 'Running it -> As the container image'."
},
{
"name": "HYDRA_TOKEN",
"isSecret": true,
"isRequired": true,
"description": "Bearer token for the HydraDNS API, obtained via `hydra login` or the setup wizard. Grants whatever access the token's account has; MCP_ROLE narrows what the MCP tool layer will call, not what the token itself can do against the API directly."
},
{
"name": "MCP_ROLE",
"default": "admin",
"description": "Permission scope for this MCP session: admin (default, every tool), operator (every mutating tool except toggle_engine), or reporter (read-only tools only). Any unrecognized value safe-defaults to reporter."
}
]
}
],
"repository": {
"url": "https://github.com/hydradns/hydradns",
"source": "github",
"subfolder": "apps/cli"
},
"websiteUrl": "https://github.com/hydradns/hydradns",
"description": "Manage a self-hosted DNS firewall: block domains, create policies, read query logs and metrics."
}