Add DNS record

Add one record to the DNS zone of a domain, beside those of the same name and type.

WWriteIdempotentbetaNeeds service_domain

Tool

manitu_domain_dns_record_addon https://mcp.manitu.de/mcp

POST

/v1/domain/dns/record/addon 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

Adds one record to the DNS zone of a domain at manitu, beside the records of the same name and type ("add this TXT for the certificate check", "a second MX"). host is relative to the domain ("@" the domain itself); a value as in a zone file, a TXT the text itself; a name in a value without a final dot is relative to the domain. A value that is there already changes nothing (changed false). To replace the records of a name use manitu_domain_dns_record_set. Tell the customer what is added and wait for an explicit yes - web site and e-mail of the domain depend on the zone. The NS records of the domain itself are manitu's, and a CNAME stands alone (cname_not_alone). Refused with a conflict when manitu does not hold the zone (zone_not_primary_at_manitu), the domain is not active (zone_not_editable) or the zone changed since zone_revision (zone_changed). Every change counts the serial up and answers the new zone_revision - pass that one with the next change. A new serial after your own change is expected, not a change by someone else.

Arguments

namestringrequired

The domain name, with international characters or in ASCII.

min length 1max length 253

hoststringrequired

The name of the record, relative to the domain: "@" for the domain itself, "www" for www.<domain>, "*.dev" for a wildcard - with international characters or in ASCII.

min length 1max length 253

typestringrequired

The record type.

One of A AAAA CAA CNAME MX NS SRV TXT

zone_revisionstring

Optional: zone_revision from manitu_domain_dns_zone_get or from the answer of your last change - refused with zone_changed if the zone changed since.

pattern ^[0-9a-f]{64}$

valuestringrequired

The value as in a zone file - A "192.0.2.1", MX "10 mail", SRV "10 5 5060 sip", CAA "0 issue \"letsencrypt.org\"" - but TXT the text itself, without quotes. A name in it without a final dot is relative to the domain ("mail" is mail.<domain>): end an outside name with a dot ("mail.example.com.").

min length 1max length 4096

ttlinteger

How long resolvers may keep it, in seconds. Left out: the zone's default.

min 60max 604800

Result structuredContent, checked against the schema

namestringrequired

The domain, with international characters.

hoststringrequired

The name of the record, relative to the domain, in ASCII; "@" for the domain itself.

typestringrequired

One of A AAAA CAA CNAME MX NS SRV TXT

changedbooleanrequired

false: it was so already - nothing was stored.

ttlinteger | nullrequired

The TTL of the records now, in seconds; null: the zone's default.

value_listarray of stringrequired

The values of this host and type now, as stored - empty when there are none left.

zone_revisionstringrequired

The revision of the zone now.

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

hoststringrequired

The name of the record, relative to the domain: "@" for the domain itself, "www" for www.<domain>, "*.dev" for a wildcard - with international characters or in ASCII.

min length 1max length 253

typestringrequired

The record type.

One of A AAAA CAA CNAME MX NS SRV TXT

zone_revisionstring

Optional: zone_revision from manitu_domain_dns_zone_get or from the answer of your last change - refused with zone_changed if the zone changed since.

pattern ^[0-9a-f]{64}$

valuestringrequired

min length 1max length 4096

ttlinteger

How long resolvers may keep it, in seconds. Left out: the zone's default.

min 60max 604800

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

namestringrequired

The domain, with international characters.

hoststringrequired

The name of the record, relative to the domain, in ASCII; "@" for the domain itself.

typestringrequired

One of A AAAA CAA CNAME MX NS SRV TXT

changedbooleanrequired

false: it was so already - nothing was stored.

ttlinteger | nullrequired

The TTL of the records now, in seconds; null: the zone's default.

value_listarray of stringrequired

The values of this host and type now, as stored - empty when there are none left.

zone_revisionstringrequired

The revision of the zone now.

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_record_add",
    "arguments": {
      "name": "example.com",
      "host": "string",
      "type": "A",
      "value": "string"
    }
  }
}

Result

{
  "structuredContent": {
    "name": "example.com",
    "host": "string",
    "type": "A",
    "changed": true,
    "ttl": 1,
    "value_list": [
      "string"
    ],
    "zone_revision": "string"
  },
  "content": [
    {
      "type": "text",
      "text": "… the same answer as text …"
    }
  ],
  "isError": false
}

POST/v1/domain/dns/record/add

Request

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

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

<?php

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

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

Response 200

{
  "status": {
    "type": "success",
    "code": 200
  },
  "meta": {},
  "data": {
    "name": "example.com",
    "host": "string",
    "type": "A",
    "changed": true,
    "ttl": 1,
    "value_list": [
      "string"
    ],
    "zone_revision": "string"
  }
}

Add DNS record

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