# Cnamio

> Cnamio is an MCP server for cloud and infrastructure. Custom domain connection API that sets up DNS records for your users' domains. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Contact sales
- **Platforms:** API, Web
- **Website:** https://cnamio.com
- **MCP Registry name:** com.cnamio/domains
- **Categories:** [cloud and infrastructure](https://ai-powered.com/categories/cloud-and-infrastructure)
- **Listing updated:** 2026-11-18

## About

The README-free product page describes Cnamio as a way for apps to let their users attach their own domains. It detects the DNS provider behind a domain, then either creates the required records with the user's API token or shows the exact records to copy for providers it does not automate. Cnamio waits until the records are live on the domain's authoritative nameservers and then sends a signed webhook to the developer's backend.

The integration is handled through a short script embed, a server-side session token endpoint and a webhook. Cnamio never edits or deletes existing DNS records, and it ties each connection to the user with a per-user TXT record so one account cannot claim another's domain.

The service is aimed at SaaS products, online stores, booking pages and apps built or deployed by AI coding agents. Access is by request through the vendor, with pricing agreed in writing, and it does not issue TLS certificates or serve traffic.

## Features

- **Automatic DNS record creation:** Creates the requested records through the user's own API token for Cloudflare, Hostinger and Amazon Route 53.
- **Guided setup for other providers:** Shows the exact record type, name, value and TTL to copy for any other DNS provider.
- **Propagation checks:** Polls the domain's authoritative nameservers for up to 72 hours before reporting the domain as connected.
- **Signed webhooks:** Sends a domain.added event to the developer's backend, signed with an HMAC SHA-256 header and timestamp.
- **Non-destructive record handling:** Reads existing records first and never changes or deletes them, leaving conflicts to the user.
- **MCP server and SDKs:** Exposes domain checks and connections as tools for AI agents, with one-file Node.js and Python SDKs.

## Good for

- Letting customers publish a store or booking page on their own domain
- Adding custom domain support to an app built by a coding agent
- Guiding non-technical users through CNAME setup at providers like GoDaddy or Registro.br
- Receiving a webhook when a customer's domain is live to trigger certificate setup

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http domains https://api.cnamio.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.cnamio.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "domains": {
      "url": "https://api.cnamio.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "domains": {
      "type": "http",
      "url": "https://api.cnamio.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "domains": {
      "serverUrl": "https://api.cnamio.com/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://api.cnamio.com/mcp
```

Enter a Name (for example "Cnamio"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "domains": {
      "type": "http",
      "url": "https://api.cnamio.com/mcp"
    }
  }
}
```

## Tools

4 of 9 tools say they're read-only. 5 of 9 tools say they can delete or change data. From the server's own tool annotations; not verified by us.

- `get_integration_guide` (says read-only): 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.
- `check_domain` (says read-only): 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.
- `connect_domain` (says it can change data): 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.
- `connect_domain_automatic` (says it can change data): 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.
- `get_connection_status` (says read-only): Status of a connection: pending, in_progress, completed (connected) or failed (72 hours without propagation). A connected domain keeps being monitored (read-only): health is healthy, degraded (an optional record is gone, or the zone cannot be read) or broken (a required record is gone), with missing_records listing what is gone.
- `recheck_propagation` (says it can change data): Asks Cnamio to check the domain's authoritative nameservers again now (at most once every 5 minutes per connection; 429 before that). Only for connections still in progress: one that is already completed or failed answers 409 and nothing is checked.
- `list_connections` (says read-only): Recent connections of the application, newest first, optionally for one domain, status or monitoring health (use health: "broken" to find connected domains whose records disappeared). Needs the application credentials (not a session token).
- `create_share_link` (says it can change data): Creates a link (url) that the person who manages the DNS (an agency, the IT team) opens to connect these domains with these records, without the application secret. Bound to the domains and records given; single-use per domain by default (maxUses), expires in 7 days by default (expiresInDays, at most 30). The url holds a token shown only in this answer: hand it to the person, never log it. Connect
- `revoke_share_link` (says it can change data): Ends a shareable link now: it hands out nothing more. Connections already started go on.

## FAQ

### Which DNS providers connect automatically?

The site says Cloudflare, Hostinger and Amazon Route 53 are automatic, using a provider API token or access key from the user.

### Does Cnamio store provider tokens?

The site says tokens are used for a single request to read the zone and create records, and are not stored or logged.

### Does Cnamio issue TLS certificates?

No. The site says Cnamio handles DNS only, and the developer's hosting issues certificates after the webhook.

### How is it charged?

There is no public price list. The site says fees are agreed in writing based on the number of connected domains per month.

### How much does Cnamio cost?

Cnamio does not publish prices. Contact the company for a quote.

### How do I add Cnamio to Claude Code?

Run this command in your terminal: claude mcp add --transport http domains https://api.cnamio.com/mcp

### What are the best alternatives to Cnamio?

The closest alternatives to Cnamio are CustomDomain™, SaaS Custom Domains, DoDomain, Apexly and Nymwell.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 19 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [CustomDomain™](https://ai-powered.com/mcp/customdomaintm): CustomDomain™ is an MCP server for cloud and infrastructure.
- [SaaS Custom Domains](https://ai-powered.com/mcp/saas-custom-domains): SaaS Custom Domains is a paid MCP server for cloud and infrastructure.
- [DoDomain](https://ai-powered.com/mcp/dodomain): DoDomain is a freemium MCP server for developer tools.
- [Apexly](https://ai-powered.com/mcp/apexly): Apexly is an MCP server for developer tools.
- [Nymwell](https://ai-powered.com/mcp/nymwell): Nymwell is a freemium MCP server for cloud and infrastructure.
- [DNSai](https://ai-powered.com/mcp/dnsai): DNSai is a paid MCP server for security.
- [webprompter.ai — Static Sites & Custom Domains for Coding Agents](https://ai-powered.com/mcp/webprompter-ai-static-sites-and-custom-domains-for-coding-ag): webprompter.ai — Static Sites & Custom Domains for Coding Agents is a freemium MCP server for developer tools.
- [Infomaniak MCP (unofficial)](https://ai-powered.com/mcp/infomaniak-mcp-unofficial): Infomaniak MCP (unofficial) is an open-source MCP server for cloud and infrastructure.

---
Source: https://ai-powered.com/mcp/cnamio
