Skip to content
Back to search

cnamio

MarketplaceWorks with Claude CodeGitHub

Cnamio for coding agents: custom domains for your SaaS users.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/cnamio--agent-kit/badge.svg)](/listings/cnamio--agent-kit)

HTML

<a href="/listings/cnamio--agent-kit"><img src="/api/listings/cnamio--agent-kit/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 18 lines
  1. {
  2. "name": "cnamio",
  3. "owner": {
  4. "name": "Cnamio",
  5. "email": "contato@cnamio.com",
  6. "url": "https://cnamio.com"
  7. },
  8. "description": "Cnamio for coding agents: custom domains for your SaaS users.",
  9. "plugins": [
  10. {
  11. "name": "cnamio",
  12. "source": "./claude-plugin",
  13. "description": "The Cnamio integration skill plus its remote MCP server: detect a domain's DNS provider, create or list the records, confirm propagation, verify the webhook.",
  14. "category": "development",
  15. "tags": ["custom-domains", "dns", "saas", "mcp"]
  16. }
  17. ]
  18. }
README.md · README · 172 lines
  1. <a href="https://cnamio.com"><img src="https://cnamio.com/brand/cnamio-app-icon-128.png" alt="Cnamio" width="64" height="64"></a>
  2. # Cnamio agent kit
  3. Everything a coding agent needs to add **"connect your own domain"** to a SaaS with [Cnamio](https://cnamio.com/?utm_source=agent-kit&utm_medium=agent):
  4. an integration skill, a Claude Code plugin, MCP configuration for the common agents, a paste-ready `AGENTS.md` block
  5. and three runnable examples (Next.js, Express, FastAPI) that work without an account.
  6. **What Cnamio does.** Your user types their domain (`shop.customer.com`). Cnamio finds where its DNS is hosted, creates
  7. the records your app needs with an API token the user gives (used once, never stored) or returns the exact records to
  8. copy, confirms them on the domain's authoritative nameservers and sends your backend a signed `domain.added` webhook.
  9. Existing DNS records are never changed or deleted. Cnamio handles DNS only: your hosting serves the domain and its
  10. certificate.
  11. **No account needed to start.** `POST https://api.cnamio.com/v1/agent/sandbox` (or the MCP tool `start_sandbox`)
  12. returns a 30-minute session of a test application: any domain connects, nothing real is touched. The free account is
  13. created by email, by the developer or by their agent (`start_signup`, with the developer's email and their agreement
  14. to the [Terms](https://cnamio.com/terms) and [Privacy Policy](https://cnamio.com/privacy)), at
  15. https://cnamio.com/?utm_source=agent-kit&utm_medium=agent#start.
  16. The one-line prompt:
  17. ```text
  18. Add custom domains for my users with Cnamio: read and follow https://cnamio.com/agent-onboarding/SKILL.md. If I don't have a Cnamio account yet, start in the sandbox right away and ask me before signing me up for a free account with my email.
  19. ```
  20. ## Three ways to use Cnamio from an agent
  21. ### 1. The remote MCP server
  22. `https://api.cnamio.com/mcp` (Streamable HTTP), listed in the official MCP Registry as `com.cnamio/domains`.
  23. Without credentials: `get_integration_guide`, `start_sandbox`, `start_signup`, and the domain tools with a
  24. `sandboxToken`. With the application's credentials (HTTP Basic `applicationId:secret`): `check_domain`,
  25. `connect_domain`, `connect_domain_automatic`, `get_connection_status`, `recheck_propagation`, `list_connections`,
  26. `create_share_link`, `revoke_share_link`.
  27. Start without credentials (every snippet below works as is). Add the `Authorization` header only once the developer has
  28. an application, and keep that configuration out of version control: it carries the secret.
  29. **Claude Code**: the plugin in this repository (skill plus MCP server):
  30. ```text
  31. /plugin marketplace add cnamio/agent-kit
  32. /plugin install cnamio@cnamio
  33. ```
  34. or the server alone:
  35. ```bash
  36. claude mcp add --transport http cnamio "https://api.cnamio.com/mcp?utm_source=agent-kit"
  37. # with credentials:
  38. claude mcp add --transport http cnamio "https://api.cnamio.com/mcp?utm_source=agent-kit" --header "Authorization: Basic <base64 of applicationId:secret>"
  39. ```
  40. **Cursor** (`~/.cursor/mcp.json` or `.cursor/mcp.json`), or
  41. [add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=cnamio&config=eyJ1cmwiOiJodHRwczovL2FwaS5jbmFtaW8uY29tL21jcD91dG1fc291cmNlPWFnZW50LWtpdCJ9):
  42. ```json
  43. {
  44. "mcpServers": {
  45. "cnamio": {
  46. "url": "https://api.cnamio.com/mcp?utm_source=agent-kit"
  47. }
  48. }
  49. }
  50. ```
  51. With credentials, add `"headers": { "Authorization": "Basic <base64 of applicationId:secret>" }`.
  52. **OpenAI Codex** (`~/.codex/config.toml`, or `codex mcp add cnamio --url "https://api.cnamio.com/mcp?utm_source=agent-kit"`):
  53. ```toml
  54. [mcp_servers.cnamio]
  55. url = "https://api.cnamio.com/mcp?utm_source=agent-kit"
  56. # with credentials, the full header value ("Basic <base64>") in an environment variable of yours:
  57. # env_http_headers = { "Authorization" = "CNAMIO_AUTHORIZATION" }
  58. ```
  59. **VS Code / GitHub Copilot** (`.vscode/mcp.json`; the password prompt keeps the secret out of the file):
  60. ```json
  61. {
  62. "inputs": [
  63. { "type": "promptString", "id": "cnamio-auth", "description": "Cnamio Authorization header (Basic <base64 of applicationId:secret>), empty for the sandbox", "password": true }
  64. ],
  65. "servers": {
  66. "cnamio": {
  67. "type": "http",
  68. "url": "https://api.cnamio.com/mcp?utm_source=agent-kit",
  69. "headers": { "Authorization": "${input:cnamio-auth}" }
  70. }
  71. }
  72. }
  73. ```
  74. **Windsurf / Devin Desktop** (`~/.config/devin/mcp_config.json`; older Windsurf: `~/.codeium/windsurf/mcp_config.json` with `serverUrl`):
  75. ```json
  76. {
  77. "mcpServers": {
  78. "cnamio": {
  79. "url": "https://api.cnamio.com/mcp?utm_source=agent-kit",
  80. "transport": "http"
  81. }
  82. }
  83. }
  84. ```
  85. An empty `Authorization` header (or `Basic` with nothing after it) is treated as no credentials.
  86. ### 2. The REST API
  87. Base `https://api.cnamio.com`. Your server exchanges the application id and secret for a 60-minute session token
  88. (`POST /token`) and calls `POST /checkdomain`, `POST /connect` (records to copy), `POST /connect/automatic` (with the
  89. user's provider token) and `GET /connect/{jobId}/status`; the management API (`/v1/manage/…`, HTTP Basic) sets the
  90. webhook. Everything is in the [OpenAPI 3.1 file](https://cnamio.com/openapi.json) and the
  91. [docs](https://cnamio.com/docs.md); agents can read [llms.txt](https://cnamio.com/llms.txt) or the whole documentation
  92. in [one file](https://cnamio.com/llms-full.txt).
  93. ```bash
  94. curl -s -X POST https://api.cnamio.com/v1/agent/sandbox # a sandbox session: no account, nothing real touched
  95. ```
  96. ### 3. The server SDK (one file)
  97. One file, no dependencies, for Node.js 18+ and Python 3.9+. There is no package to install yet: save the file into the
  98. project and commit it.
  99. ```bash
  100. curl -fsS https://cnamio.com/sdk/cnamio.mjs -o lib/cnamio.mjs && curl -fsS https://cnamio.com/sdk/cnamio.d.mts -o lib/cnamio.d.mts
  101. curl -fsS https://cnamio.com/sdk/cnamio.py -o app/cnamio.py
  102. ```
  103. ```js
  104. import { Cnamio, recordsForUser, verifyWebhook } from './lib/cnamio.mjs';
  105. const cnamio = new Cnamio(); // reads CNAMIO_APPLICATION_ID and CNAMIO_SECRET
  106. const records = recordsForUser({ target: 'customers.yourapp.com', userId, ownershipKey: process.env.CNAMIO_OWNERSHIP_KEY });
  107. const check = await cnamio.checkDomain('shop.customer.com', records);
  108. const job = await cnamio.connect('shop.customer.com', records, { userId });
  109. ```
  110. ## What is in this repository
  111. | Path | What it is |
  112. | --- | --- |
  113. | [`skills/cnamio/SKILL.md`](skills/cnamio/SKILL.md) | The integration skill ([Agent Skills](https://agentskills.io) format). `npx skills add cnamio/agent-kit` installs it for Claude Code, Cursor, Codex and others |
  114. | [`claude-plugin/`](claude-plugin/) | The Claude Code plugin (the skill plus the MCP server), the folder submitted to the Claude plugin directory |
  115. | [`.claude-plugin/marketplace.json`](.claude-plugin/marketplace.json), [`.mcp.json`](.mcp.json) | The marketplace that lists the plugin, and a project MCP configuration for this repository |
  116. | [`snippets/AGENTS.md`](snippets/AGENTS.md) | A block to paste into a project's `AGENTS.md`, `CLAUDE.md` or editor rules |
  117. | [`examples/nextjs`](examples/nextjs), [`examples/express`](examples/express), [`examples/fastapi`](examples/fastapi) | "Add custom domains to my SaaS": `npm run dev` (or `uvicorn`) runs on the sandbox without an account, then real credentials via the environment. Each has tests and a smoke script |
  118. | `context7.json`, `glama.json` | Listing metadata for Context7 and Glama |
  119. | [`submissions/`](submissions/) | The exact content prepared for each directory, with the sources of their formats |
  120. ## What the plugin and the examples send, and where
  121. - The MCP server and the examples talk only to `https://api.cnamio.com` (and download the SDK file from
  122. `https://cnamio.com/sdk/`). The MCP URLs carry `?utm_source=<channel>` so Cnamio can count, per day and in
  123. aggregate, which listing an agent came from; no address, user agent or email is kept with that count.
  124. - What reaches Cnamio is what a connection needs: the domain, the DNS records, your own user id (echoed back in jobs
  125. and webhooks), and, for automatic setup, the user's DNS provider token, used for that one call and never stored.
  126. - `start_signup` sends the developer's email (and optionally their name and company) only after they agreed to the
  127. Terms and the Privacy Policy; the account exists only once they open the emailed link.
  128. - The sandbox reads and writes no real DNS. Data handling: https://cnamio.com/security and https://cnamio.com/privacy.
  129. ## Rules for agents
  130. - The secret stays on the server: never in client code, never committed, never pasted into a chat. Never invent it.
  131. - Never ask for, store or log a DNS provider password; a provider API token goes straight to `connect_automatic`.
  132. - The `domain.added` webhook, verified over the raw body, is the only signal that a domain is connected.
  133. - Cnamio never deletes or overwrites existing DNS records; a conflict comes back as `409` with the reasons.
  134. Questions: contato@cnamio.com. MIT license.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.