HydraDNS

io.github.hydradnsPublished by GitHub account hydradnsv0.1.0Updated Oct 24, 2026

Manage a self-hosted DNS firewall: block domains, create policies, read query logs and metrics.

Overview

AI-generated overview

Manage a self-hosted HydraDNS DNS firewall from an assistant: block domains, create policies, and read query logs and metrics.

What you can do
Block and manage domains on the DNS firewall, including toggling the engine on or off depending on role permissions (toggle_engine is admin-only). Create and manage blocking policies. Read query logs and metrics from the controlplane. The tool layer is scoped by MCP_ROLE: admin (default, every tool), operator (all mutating tools except toggle_engine), or reporter (read-only tools only).
When to use it
Useful when you run a self-hosted HydraDNS controlplane and want an assistant to inspect DNS query activity, adjust blocking policies, or block domains without using the CLI directly. Read-only use is possible with the reporter role.
Requirements
Runs locally over stdio, typically as the ghcr.io/hydradns/hydra-cli container via Docker. Needs HYDRA_API_URL pointing at the HydraDNS controlplane API and a HYDRA_TOKEN bearer token obtained via hydra login or the setup wizard. Inside a container, localhost refers to the container, not the host, so the API URL must be reachable from it. MCP_ROLE is optional.
Before you install
HYDRA_TOKEN is a secret that grants whatever access its account has; MCP_ROLE only narrows what the MCP tool layer will call, not what the token itself can do, so use a least-privilege token. The default admin role exposes every tool, including mutating ones and toggle_engine; choose operator or reporter to limit changes. Blocking domains and changing policies alters live firewall behavior.

Installation

In SourceWeft

  1. Open HydraDNS in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

This repository has no README.

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestSep 21, 2026

Score

35% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts