Show DNS zone of a domain

The DNS zone of one domain at manitu, as BIND zone file text (raw or compiled).

RReadIdempotentbetaNeeds service_domain

Tool

manitu_domain_dns_zone_geton https://mcp.manitu.de/mcp

POST

/v1/domain/dns/zone/geton https://api.manitu.de

Try it

Annotations as tools/list sends them

readOnlyHint truedestructiveHint falseidempotentHint trueopenWorldHint false

Description for the model

Returns the DNS zone of a domain at manitu, by its name, as BIND zone file text - all records (A, AAAA, MX, TXT, CNAME, ...) in one piece, for answering what DNS says about a name or mail, or for checking a record. Only for a zone manitu holds as primary (dns.zone "primary" in manitu_domain_get); otherwise refused with a conflict (zone_not_primary_at_manitu) - the DNS records are kept elsewhere then. format raw (default) is the zone file as kept, with relative names ("www" means www.<domain>, "@" the domain itself); compiled is what the name server serves, every name absolute. Read-only - nothing is changed. To change the zone, read it with format raw and pass zone_data and zone_revision to manitu_domain_dns_zone_set.

Arguments

namestringrequired

The domain name, with international characters or in ASCII.

min length 1max length 253

formatstring

raw (default): the zone file as it is kept - relative names, $TTL, comments. compiled: as the name server serves it - every name absolute, every TTL written out.

One of raw compiled

Result structuredContent, checked against the schema

namestringrequired

The domain, with international characters.

formatstringrequired

One of raw compiled

zone_datastringrequired

The zone, as BIND zone file text.

zone_revisionstring | nullrequired

The version of the zone read (raw only, else null) - manitu_domain_dns_zone_set asks it back.

Authentication

One of X-API-Key, Authorization: Bearer … - never more than one in a request. More

Request body JSON; unknown fields are refused

namestringrequired

The domain name, with international characters or in ASCII.

min length 1max length 253

formatstring

raw (default): the zone file as it is kept - relative names, $TTL, comments. compiled: as the name server serves it - every name absolute, every TTL written out.

One of raw compiled

Response in `data`; the rest of the body as on every call

namestringrequired

The domain, with international characters.

formatstringrequired

One of raw compiled

zone_datastringrequired

The zone, as BIND zone file text.

zone_revisionstring | nullrequired

The version of the zone read (raw only, else null) - manitu_domain_dns_zone_set asks it back.

Statuses

200Success.400The request does not match the declared input schema.401No credential was presented, or it was not recognised.403The credential is not permitted to use this operation.500The server failed. Nothing about the request was wrong. Whether a change took effect is not known - check before trying it again.503The channel this operation forwards through is unavailable.

MCPtools/call

Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "manitu_domain_dns_zone_get",
    "arguments": {
      "name": "example.com"
    }
  }
}

Result

{
  "structuredContent": {
    "name": "example.com",
    "format": "raw",
    "zone_data": "string",
    "zone_revision": "string"
  },
  "content": [
    {
      "type": "text",
      "text": "… the same answer as text …"
    }
  ],
  "isError": false
}

POST/v1/domain/dns/zone/get

Request

curl -X POST 'https://api.manitu.de/v1/domain/dns/zone/get' \
  -H 'X-API-Key: $API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "example.com"
  }'

const response = await fetch('https://api.manitu.de/v1/domain/dns/zone/get', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.API_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "example.com"
  }),
});
const answer = await response.json();

<?php

$curl = curl_init('https://api.manitu.de/v1/domain/dns/zone/get');

curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_HTTPHEADER     => [
        'X-API-Key: ' . getenv('API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS     => '{"name":"example.com"}',
    CURLOPT_RETURNTRANSFER => true,
]);

$answer = json_decode(curl_exec($curl), true);

import os

import requests

response = requests.request(
    "POST",
    "https://api.manitu.de/v1/domain/dns/zone/get",
    headers={"X-API-Key": os.environ["API_KEY"]},
    json={
        "name": "example.com",
    },
)
answer = response.json()

Response 200

{
  "status": {
    "type": "success",
    "code": 200
  },
  "meta": {},
  "data": {
    "name": "example.com",
    "format": "raw",
    "zone_data": "string",
    "zone_revision": "string"
  }
}

Show DNS zone of a domain

Annotations as tools/list sends them

Description for the model

Arguments

Result structuredContent, checked against the schema

Authentication

Request body JSON; unknown fields are refused

Response in data; the rest of the body as on every call

Statuses

Response in `data`; the rest of the body as on every call