deSEC MCP by usefulapi is an MCP server published by io.usefulapi, hosted at desec.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 7 tools, including desec_list_domains, desec_get_domain, desec_export_zonefile, desec_list_rrsets, desec_get_rrset.
Read deSEC domains, DNSSEC keys, zone files and RRsets; create or replace one DNS record set.
4,157 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
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/.
| Parameter | 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). |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
{
"name": "desec_list_domains",
"title": "List domains",
"description": "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/.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "List domains",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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}/.
| Parameter | Type | Description |
|---|---|---|
| domain * | string | Domain name in this deSEC account, e.g. example.com (see desec_list_domains). |
{
"name": "desec_get_domain",
"title": "Get domain",
"description": "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}/.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "Get domain",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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/.
| Parameter | Type | Description |
|---|---|---|
| domain * | string | Domain name in this deSEC account, e.g. example.com (see desec_list_domains). |
{
"name": "desec_export_zonefile",
"title": "Export zonefile",
"description": "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/.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "Export zonefile",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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/.
| Parameter | 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. |
{
"name": "desec_list_rrsets",
"title": "List RRsets",
"description": "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/.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "List RRsets",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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}/.
| Parameter | 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. |
{
"name": "desec_get_rrset",
"title": "Get RRset",
"description": "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}/.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Get RRset",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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/.
| Parameter | 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. |
{
"name": "desec_create_rrset",
"title": "Create RRset",
"description": "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/.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Create RRset",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}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.
| Parameter | 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. |
{
"name": "desec_replace_rrset",
"title": "Replace RRset",
"description": "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.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Replace RRset",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Tools for deSEC, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Show me every DNS record currently set for the domain acme-example.com."; "Which domains do I have in my account, and when was each last changed?"; "What are the MX records for acme-example.com right now?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes deSEC data. Free plan: 50 tool calls per month. Run desec_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run desec_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run desec_upgrade without a plan: it returns both plans, each with a payment link for the user to open. desec_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.