deSEC MCP by usefulapi

Working · 2.4 s

io.usefulapi/desecv1.8.0 Domain verified

Read deSEC domains, DNSSEC keys, zone files and RRsets; create or replace one DNS record set.

Cloud & DevOps

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://desec.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

desec_create_rrset Destructive

WRITE: create ONE new RRset (a set of DNS records of one type at one name) in a domain. It goes live in DNS immediately and a wrong record can take a site or mail offline. Fails if an RRset with this subname and type already exists (use desec_replace_rrset for that) or if a CNAME would conflict with other records. Never touches the apex NS or DNSSEC records and cannot delete anything. Subject to deSEC's write limits (15/min, 300/day per domain). POST /domains/{name}/rrsets/.

ttlinteger, required

TTL in seconds, at most 86400. Not below the domain's minimum_ttl (usually 3600): deSEC rejects lower values.

typestring, required

Record type (uppercase). DNSSEC types and SOA are managed by deSEC and cannot be written.

domainstring, required

Domain name in this deSEC account, e.g. example.com (see desec_list_domains).

recordsarray, required

Record contents in zone-file format, at least one (an empty list would delete the RRset and is refused). Names need a trailing dot ("10 mx.example.com."), TXT needs quotes ("\"v=spf1 -all\"").

subnamestring

Subname relative to the domain: "www", "_443._tcp.www", "*" for a wildcard. Empty or "@" = the zone apex. Never the full name.

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

Try it

Call this server's tools from your browser. Nothing to install.

https://desec.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

desec_create_rrset Destructive

ttlinteger, required

TTL in seconds, at most 86400. Not below the domain's minimum_ttl (usually 3600): deSEC rejects lower values.

typestring, required

Record type (uppercase). DNSSEC types and SOA are managed by deSEC and cannot be written.

domainstring, required

Domain name in this deSEC account, e.g. example.com (see desec_list_domains).

recordsarray, required

Record contents in zone-file format, at least one (an empty list would delete the RRset and is refused). Names need a trailing dot ("10 mx.example.com."), TXT needs quotes ("\"v=spf1 -all\"").

subnamestring

Subname relative to the domain: "www", "_443._tcp.www", "*" for a wildcard. Empty or "@" = the zone apex. Never the full name.

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

Tools (7)

desec_create_rrset

destructive

Argument	Type	Description
ttl*	integer	TTL in seconds, at most 86400. Not below the domain's minimum_ttl (usually 3600): deSEC rejects lower values.
type*	string	Record type (uppercase). DNSSEC types and SOA are managed by deSEC and cannot be written.
domain*	string	Domain name in this deSEC account, e.g. example.com (see desec_list_domains).
records*	array	Record contents in zone-file format, at least one (an empty list would delete the RRset and is refused). Names need a trailing dot ("10 mx.example.com."), TXT needs quotes ("\"v=spf1 -all\"").
subname	string	Subname relative to the domain: "www", "_443._tcp.www", "*" for a wildcard. Empty or "@" = the zone apex. Never the full name.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "domain",
    "type",
    "ttl",
    "records"
  ],
  "properties": {
    "ttl": {
      "type": "integer",
      "maximum": 86400,
      "minimum": 1,
      "description": "TTL in seconds, at most 86400. Not below the domain's minimum_ttl (usually 3600): deSEC rejects lower values."
    },
    "type": {
      "enum": [
        "A",
        "AAAA",
        "CAA",
        "CNAME",
        "HTTPS",
        "LOC",
        "MX",
        "NAPTR",
        "NS",
        "OPENPGPKEY",
        "PTR",
        "SMIMEA",
        "SPF",
        "SRV",
        "SSHFP",
        "SVCB",
        "TLSA",
        "TXT",
        "URI"
      ],
      "type": "string",
      "description": "Record type (uppercase). DNSSEC types and SOA are managed by deSEC and cannot be written."
    },
    "domain": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Domain name in this deSEC account, e.g. example.com (see desec_list_domains)."
    },
    "records": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 4000,
        "minLength": 1
      },
      "maxItems": 100,
      "minItems": 1,
      "description": "Record contents in zone-file format, at least one (an empty list would delete the RRset and is refused). Names need a trailing dot (\"10 mx.example.com.\"), TXT needs quotes (\"\\\"v=spf1 -all\\\"\")."
    },
    "subname": {
      "type": "string",
      "maxLength": 178,
      "description": "Subname relative to the domain: \"www\", \"_443._tcp.www\", \"*\" for a wildcard. Empty or \"@\" = the zone apex. Never the full name."
    }
  }
}

desec_export_zonefile

The whole zone as a plain-text BIND-format zonefile (all RRsets except DNSSEC types). Handy as a backup before changing records. Counts as an expensive deSEC operation (300/min). GET /domains/{name}/zonefile/.

read-only

Argument	Type	Description
domain*	string	Domain name in this deSEC account, e.g. example.com (see desec_list_domains).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "domain"
  ],
  "properties": {
    "domain": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Domain name in this deSEC account, e.g. example.com (see desec_list_domains)."
    }
  }
}

desec_get_domain

One domain with its DNSSEC key material: the DNSKEY and the DS records to publish at the registrar for the chain of trust, plus minimum TTL and publication times. GET /domains/{name}/.

read-only

Argument	Type	Description
domain*	string	Domain name in this deSEC account, e.g. example.com (see desec_list_domains).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "domain"
  ],
  "properties": {
    "domain": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Domain name in this deSEC account, e.g. example.com (see desec_list_domains)."
    }
  }
}

desec_get_rrset

One RRset by subname and type, e.g. the A records of "www" or the MX records of the apex. GET /domains/{name}/rrsets/{subname}/{type}/.

read-only

Argument	Type	Description
type*	string	Record type, e.g. A, AAAA, CNAME, MX, TXT, CAA, SRV, TLSA.
domain*	string	Domain name in this deSEC account, e.g. example.com (see desec_list_domains).
subname	string	Subname relative to the domain: "www", "_443._tcp.www", "*" for a wildcard. Empty or "@" = the zone apex. Never the full name.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "domain",
    "type"
  ],
  "properties": {
    "type": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,20}$",
      "description": "Record type, e.g. A, AAAA, CNAME, MX, TXT, CAA, SRV, TLSA."
    },
    "domain": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Domain name in this deSEC account, e.g. example.com (see desec_list_domains)."
    },
    "subname": {
      "type": "string",
      "maxLength": 178,
      "description": "Subname relative to the domain: \"www\", \"_443._tcp.www\", \"*\" for a wildcard. Empty or \"@\" = the zone apex. Never the full name."
    }
  }
}

desec_list_domains

List the DNS domains (zones) in this deSEC account, newest first, with creation and last-published times and minimum TTL. DNSSEC keys are omitted here (see desec_get_domain). Use owns_qname to find which of your domains is responsible for a DNS name (for example before adding a record for www.dev.example.net). Up to 500 per page. GET /domains/.

read-only

Argument	Type	Description
cursor	string	Opaque cursor from a previous reply's next_cursor. Omit for the first page.
owns_qname	string	Only the domain that is authoritative for this DNS name (the longest matching zone you own).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "cursor": {
      "type": "string",
      "maxLength": 500,
      "description": "Opaque cursor from a previous reply's next_cursor. Omit for the first page."
    },
    "owns_qname": {
      "type": "string",
      "maxLength": 253,
      "minLength": 1,
      "description": "Only the domain that is authoritative for this DNS name (the longest matching zone you own)."
    }
  }
}

desec_list_rrsets

List the DNS records of a domain as RRsets (all records of one name and type, sharing one TTL), newest first. Filter by type and/or subname. Up to 500 per page. GET /domains/{name}/rrsets/.

read-only

Argument	Type	Description
type	string	Only RRsets of this type, e.g. A, MX, TXT.
cursor	string	Opaque cursor from a previous reply's next_cursor. Omit for the first page.
domain*	string	Domain name in this deSEC account, e.g. example.com (see desec_list_domains).
subname	string	Only RRsets at this subname ("" or "@" = the zone apex). Omit to include every subname.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "domain"
  ],
  "properties": {
    "type": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]{1,20}$",
      "description": "Only RRsets of this type, e.g. A, MX, TXT."
    },
    "cursor": {
      "type": "string",
      "maxLength": 500,
      "description": "Opaque cursor from a previous reply's next_cursor. Omit for the first page."
    },
    "domain": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Domain name in this deSEC account, e.g. example.com (see desec_list_domains)."
    },
    "subname": {
      "type": "string",
      "maxLength": 178,
      "description": "Only RRsets at this subname (\"\" or \"@\" = the zone apex). Omit to include every subname."
    }
  }
}

desec_replace_rrset

WRITE (overwrites): set ONE RRset to exactly the given TTL and records, creating it if it does not exist and REPLACING all its current records if it does. It goes live in DNS immediately; a wrong value can take a site or mail offline. The previous RRset is read first and returned as `previous` so the change can be undone with another call. An empty record list is refused (this tool never deletes), and the apex NS and DNSSEC records cannot be changed. Subject to deSEC's write limits (15/min, 300/day per domain). PUT /domains/{name}/rrsets/ with a one-element array.

destructive

Argument	Type	Description
ttl*	integer	TTL in seconds, at most 86400. Not below the domain's minimum_ttl (usually 3600): deSEC rejects lower values.
type*	string	Record type (uppercase). DNSSEC types and SOA are managed by deSEC and cannot be written.
domain*	string	Domain name in this deSEC account, e.g. example.com (see desec_list_domains).
records*	array	Record contents in zone-file format, at least one (an empty list would delete the RRset and is refused). Names need a trailing dot ("10 mx.example.com."), TXT needs quotes ("\"v=spf1 -all\"").
subname	string	Subname relative to the domain: "www", "_443._tcp.www", "*" for a wildcard. Empty or "@" = the zone apex. Never the full name.