Set name servers of a domain

Delegate a domain to manitu's name servers or to 2 to 4 of the customer's own.

WWriteIdempotentbetaNeeds service_domain

Tool

manitu_domain_dns_nameserver_seton https://mcp.manitu.de/mcp

POST

/v1/domain/dns/nameserver/seton https://api.manitu.de

Try it

Changes the account. Agents say what will happen and wait for an explicit yes before calling it.

Annotations as tools/list sends them

readOnlyHint falsedestructiveHint falseidempotentHint trueopenWorldHint false

Description for the model

Sets the name servers of a domain at manitu: type custom with 2 to 4 of the customer's own (nameserver_list), or type manitu to go back to manitu's. With custom name servers the DNS zone at manitu is no longer used - the customer's servers must already serve the domain (checked: each answers on port 53, and the delegation is right; refusals name the name server by index: hostname_invalid, manitu_nameserver, unreachable, duplicate, delegation_invalid). Tell the customer what changes and wait for an explicit yes - web site and e-mail depend on it, and it takes hours to reach every resolver. handled in the answer: automatic (set now) or manual (manitu's support does it - tell the customer it may take a while). Refused with a conflict when manitu's are set already (nameserver_already_manitu).

Arguments

namestringrequired

The domain name, with international characters or in ASCII.

min length 1max length 253

typestringrequired

manitu: back to manitu's name servers. custom: the customer's own, in nameserver_list.

One of manitu custom

nameserver_listarray of string

For custom only: the host names of the name servers, e.g. ns1.example.com.

min items 2max items 4

Result structuredContent, checked against the schema

namestringrequired

The domain, with international characters.

typestringrequired

One of manitu custom

nameserver_listarray of stringrequired

The name servers asked for.

handledstringrequired

automatic: set at the registry now. manual: manitu's support was asked to set it.

One of automatic manual

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

typestringrequired

manitu: back to manitu's name servers. custom: the customer's own, in nameserver_list.

One of manitu custom

nameserver_listarray of string

For custom only: the host names of the name servers, e.g. ns1.example.com.

min items 2max items 4

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

namestringrequired

The domain, with international characters.

typestringrequired

One of manitu custom

nameserver_listarray of stringrequired

The name servers asked for.

handledstringrequired

automatic: set at the registry now. manual: manitu's support was asked to set it.

One of automatic manual

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_nameserver_set",
    "arguments": {
      "name": "example.com",
      "type": "manitu"
    }
  }
}

Result

{
  "structuredContent": {
    "name": "example.com",
    "type": "manitu",
    "nameserver_list": [
      "string"
    ],
    "handled": "automatic"
  },
  "content": [
    {
      "type": "text",
      "text": "… the same answer as text …"
    }
  ],
  "isError": false
}

POST/v1/domain/dns/nameserver/set

Request

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

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

<?php

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

curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_HTTPHEADER     => [
        'X-API-Key: ' . getenv('API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS     => '{"name":"example.com","type":"manitu"}',
    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/nameserver/set",
    headers={"X-API-Key": os.environ["API_KEY"]},
    json={
        "name": "example.com",
        "type": "manitu",
    },
)
answer = response.json()

Response 200

{
  "status": {
    "type": "success",
    "code": 200
  },
  "meta": {},
  "data": {
    "name": "example.com",
    "type": "manitu",
    "nameserver_list": [
      "string"
    ],
    "handled": "automatic"
  }
}

Set name servers 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