Skip to main content
Glama

DNS-Einträge anzeigen

get_dns_records
Read-only

DNS-Zone-Records einer Domain live von Plesk abrufen. Das ist die Zone bei turbopress: Sie gilt im Internet nur, wenn die Nameserver der Domain bei turbopress liegen (dns1–4.turbopress.de). Liegen sie woanders, steht vor der Liste eine ausdrückliche Warnung mit den Nameservern — dann nicht aus dieser Zone auf Mail- oder Webseiten-Auflösung der Domain schließen, und Änderungen an DNS-Einträgen werden dort abgelehnt (beim Anbieter der Nameserver eintragen). In diesem Fall stehen vor der Zonenliste die Werte, die der Kunde beim Anbieter der Nameserver eintragen muss (A/AAAA für @ und www mit dem aktuellen Stand je Eintrag) — diese dem Kunden nennen, nicht die Zone. Nach dem Eintragen get_dns_records erneut aufrufen, um zu prüfen, ob es greift. Jede Zeile beginnt mit der Kennung des Eintrags — genau die Zahl, die delete_dns_record als record_id erwartet. Die Kennungen sind nicht stabil: Sie werden neu vergeben, wenn ein Eintrag angelegt oder gelöscht wird, und gehören deshalb unmittelbar vor einem Löschen oder Ändern frisch abgerufen. Jeder Eintrag trägt "herkunft": "turbopress" heißt, dass die Plesk-DNS-Vorlage genau diesen Eintrag erzeugt (oder er zu den Sonderfällen von turbopress gehört), "eigen" heißt, dass er vom turbopress-Standard abweicht (von Hand angelegt oder geändert, oder er gehört zu einem anderen Paket derselben Zone; z. B. MX auf Google oder ein SPF mit include). SRV- und CAA-Einträge werden in lesbaren Feldern ausgegeben; die Zusatzangabe "opt" steht dahinter und wird für update_dns_record als alt.opt unverändert übernommen (MX: Priorität, SRV: "Priorität Gewicht Port", CAA: "Flag Art"). Einträge mit einem Platzhalter als Wert sowie SRV- oder CAA-Einträge ohne lesbare Teile lassen sich mit update_dns_record nicht bearbeiten — dann nur nach Zustimmung des Kunden delete_dns_record und add_dns_record verwenden. Am Ende steht, wenn lesbar, die Zonen-TTL (Vorgabewert der Gültigkeitsdauer) in Sekunden. Sie ist nur Information: Die Einträge tragen meist eine eigene TTL, und die TTL lässt sich über dieses Werkzeug-Set nicht ändern — wünscht der Kunde vor einem Umzug eine kürzere TTL, verweise ihn an den Support.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "domain": "<domain>"
    },
    "name": "get_dns_records"
  }
}

Input Schema

NameRequiredDescriptionDefault
domainYesDie Domain, z. B. example.com

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
  2. First observed

TDQS

A4.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare read-only, non-destructive, non-open-world, so the safety profile is covered; the description goes well beyond this with volatile record IDs, the 'herkunft' provenance semantics, the 'opt' field round-trip requirement for update_dns_record, and the explicit limitation that TTL cannot be changed via this tool set. What it does not cover is scale (how many records/pagination, ordering), which matters for a live zone listing.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose is front-loaded in sentence one, and nearly every subsequent sentence carries information the caller genuinely needs given there is no output schema. However, it is delivered as one dense unbroken block of ~350 words mixing zone semantics, ID volatility, field encoding, and TTL caveats, with no headings or bullets, which makes the operational rules (re-fetch before delete, 'opt' pass-through) easy to miss.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no output schema, the description takes on the full burden of explaining the return value and does so thoroughly: line format, record ID position, 'herkunft' values, SRV/CAA readable fields plus 'opt', uneditable placeholder entries, and the trailing zone TTL. It also covers the adverse case (foreign nameservers) and what to tell the customer, which is exactly the context an agent needs before acting on this output.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Only one parameter exists and schema coverage is 100% with an inline example, so the schema carries the semantics; the description adds no parameter-level detail but does imply the live-fetch scope of the domain argument. With a single well-documented parameter this is close to the ceiling, though nothing extra is contributed.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The opening sentence names a specific verb and resource ('DNS-Zone-Records einer Domain live von Plesk abrufen') and the rest of the text makes clear what the returned list looks like and how it differs from a plain zone dump. It is unmistakably distinguishable from the write-side siblings add/delete/update_dns_record, which are each named with their specific relationship to this output.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicit conditions are given for when this tool's output is authoritative (nameservers at dns1–4.turbopress.de) and when it is not, including what to do instead (tell the customer the values to enter at their nameserver provider, do not infer mail/web resolution from the zone). It also states a procedural rule: re-fetch immediately before delete/update because record IDs are reassigned, and re-fetch after changes to verify.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources