Connect your users' custom domains: detect the DNS provider, create records, confirm propagation.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Basic base64(applicationId:secret) for the domain tools; get_integration_guide works without it. Credentials: [email protected]
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.
Read-only. Finds where a domain's DNS is hosted and how it can be connected: provider, setupType, connectMethods (api_token when the records can be created with the user's provider token), nameservers, recordState for a single CNAME, and conflicts with records already published.
Records your product needs. host is relative to the zone; placeholders {DOMAIN}, {SUBDOMAIN}, {SLD}, {TLD}; @ is the apex (no CNAME at the apex).
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http domains https://api.cnamio.com/mcp
Headers
Authorization (optional, not in the config above): Basic base64(applicationId:secret) for the domain tools; get_integration_guide works without it. Credentials: [email protected]Read-only. Finds where a domain's DNS is hosted and how it can be connected: provider, setupType, connectMethods (api_token when the records can be created with the user's provider token), nameservers, recordState for a single CNAME, and conflicts with records already published.
| Argument | Type | Description |
|---|---|---|
| domain* | string | |
| dnsRecords* | array | Records your product needs. host is relative to the zone; placeholders {DOMAIN}, {SUBDOMAIN}, {SLD}, {TLD}; @ is the apex (no CNAME at the apex). |
| checkConflicts | boolean |
{
"type": "object",
"required": [
"domain",
"dnsRecords"
],
"properties": {
"domain": {
"type": "string",
"examples": [
"links.mybrand.com"
]
},
"dnsRecords": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"host",
"value"
],
"properties": {
"ttl": {
"type": "integer"
},
"host": {
"type": "string",
"examples": [
"{SUBDOMAIN}"
]
},
"type": {
"enum": [
"A",
"AAAA",
"CNAME",
"TXT",
"MX",
"CAA"
],
"type": "string"
},
"value": {
"type": "string",
"examples": [
"custom.yourapp.com"
]
},
"optional": {
"type": "boolean"
},
"priority": {
"type": "integer"
}
}
},
"maxItems": 20,
"minItems": 1,
"description": "Records your product needs. host is relative to the zone; placeholders {DOMAIN}, {SUBDOMAIN}, {SLD}, {TLD}; @ is the apex (no CNAME at the apex)."
},
"checkConflicts": {
"type": "boolean",
"default": true
}
},
"additionalProperties": false
}Starts a manual connection: returns the exact records the domain owner must create at their DNS provider and starts watching propagation on the authoritative nameservers (up to 72 hours). Does not change DNS. Follow it with get_connection_status.
| Argument | Type | Description |
|---|---|---|
| domain* | string | |
| userId | string | Your user id, echoed in webhooks. |
| dnsRecords* | array | Records your product needs. host is relative to the zone; placeholders {DOMAIN}, {SUBDOMAIN}, {SLD}, {TLD}; @ is the apex (no CNAME at the apex). |
{
"type": "object",
"required": [
"domain",
"dnsRecords"
],
"properties": {
"domain": {
"type": "string"
},
"userId": {
"type": "string",
"description": "Your user id, echoed in webhooks."
},
"dnsRecords": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"host",
"value"
],
"properties": {
"ttl": {
"type": "integer"
},
"host": {
"type": "string",
"examples": [
"{SUBDOMAIN}"
]
},
"type": {
"enum": [
"A",
"AAAA",
"CNAME",
"TXT",
"MX",
"CAA"
],
"type": "string"
},
"value": {
"type": "string",
"examples": [
"custom.yourapp.com"
]
},
"optional": {
"type": "boolean"
},
"priority": {
"type": "integer"
}
}
},
"maxItems": 20,
"minItems": 1,
"description": "Records your product needs. host is relative to the zone; placeholders {DOMAIN}, {SUBDOMAIN}, {SLD}, {TLD}; @ is the apex (no CNAME at the apex)."
}
},
"additionalProperties": false
}Creates the records at the domain's DNS provider with an API token the domain owner provides (only when check_domain returned connectMethods containing api_token). The token is used during this call only and is never stored; existing records are never changed or deleted (a conflict returns 409 with the reasons). Never ask for or use DNS provider passwords.
| Argument | Type | Description |
|---|---|---|
| domain* | string | |
| userId | string | |
| dnsRecords* | array | Records your product needs. host is relative to the zone; placeholders {DOMAIN}, {SUBDOMAIN}, {SLD}, {TLD}; @ is the apex (no CNAME at the apex). |
| providerToken* | string | The domain owner's API token for their DNS provider. |
{
"type": "object",
"required": [
"domain",
"dnsRecords",
"providerToken"
],
"properties": {
"domain": {
"type": "string"
},
"userId": {
"type": "string"
},
"dnsRecords": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"host",
"value"
],
"properties": {
"ttl": {
"type": "integer"
},
"host": {
"type": "string",
"examples": [
"{SUBDOMAIN}"
]
},
"type": {
"enum": [
"A",
"AAAA",
"CNAME",
"TXT",
"MX",
"CAA"
],
"type": "string"
},
"value": {
"type": "string",
"examples": [
"custom.yourapp.com"
]
},
"optional": {
"type": "boolean"
},
"priority": {
"type": "integer"
}
}
},
"maxItems": 20,
"minItems": 1,
"description": "Records your product needs. host is relative to the zone; placeholders {DOMAIN}, {SUBDOMAIN}, {SLD}, {TLD}; @ is the apex (no CNAME at the apex)."
},
"providerToken": {
"type": "string",
"description": "The domain owner's API token for their DNS provider."
}
},
"additionalProperties": false
}Status of a connection: pending, in_progress, completed (connected) or failed (72 hours without propagation).
| Argument | Type | Description |
|---|---|---|
| jobId* | string | job_id returned by connect_domain or connect_domain_automatic |
{
"type": "object",
"required": [
"jobId"
],
"properties": {
"jobId": {
"type": "string",
"pattern": "^job_[0-9a-f-]{36}$",
"description": "job_id returned by connect_domain or connect_domain_automatic"
}
},
"additionalProperties": false
}Returns the step-by-step guide to add custom domain connection to a project with Cnamio: records, environment variables, server session route, browser connect window, headless API and webhook verification (Node.js and Python). Start here when integrating Cnamio into code.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Recent connections of the application, newest first, optionally for one domain or status. Needs the application credentials (not a session token).
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| domain | string | |
| status | string |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
},
"domain": {
"type": "string"
},
"status": {
"enum": [
"pending",
"in_progress",
"completed",
"failed"
],
"type": "string"
}
},
"additionalProperties": false
}Asks Cnamio to check the domain's authoritative nameservers again now (at most once every 5 minutes per connection).
| Argument | Type | Description |
|---|---|---|
| jobId* | string | job_id returned by connect_domain or connect_domain_automatic |
{
"type": "object",
"required": [
"jobId"
],
"properties": {
"jobId": {
"type": "string",
"pattern": "^job_[0-9a-f-]{36}$",
"description": "job_id returned by connect_domain or connect_domain_automatic"
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 18, 2026.