The NameOcean API lets any program, or any AI assistant, do what you do in the dashboard: search and register domains, change nameservers, edit DNS records, issue SSL certificates, open ports and bind domains to your servers.
Open Dashboard → API keys, choose what the key may do and copy it.
Paste the prompt below into Claude, ChatGPT or Cursor together with your key.
"Point blog.example.com to 203.0.113.10 and turn on SSL."
You can manage my domains with the NameOcean API. Read https://nameocean.net/llms.txt for how it works. My API key is: [paste your key here]. Always ask me before anything that costs money.
Give each tool its own key with only the permissions it needs. Delete a key in the dashboard if it leaks; the others keep working.
NameOcean runs a remote MCP server. Add it once and your AI can manage DNS, SSL, servers, ports and domain bindings. You sign in in the browser; no API key to paste and nothing to install.
$ claude mcp add --transport http nameocean https://nameocean.net/mcp
Claude Desktop and claude.ai: Settings → Connectors → Add custom connector, URL https://nameocean.net/mcp.
Cursor, VS Code, OpenCode and others: add an HTTP MCP server with the same URL.
Clients without OAuth can send Authorization: Bearer <API key>.
API keys and app connections need two-step login on your account. Turn it on
The MCP server cannot register or renew domains or add credit, and creates a paid server only after you agree to the price. Disconnect apps any time in Dashboard → Connected apps.
The nameocean CLI does the same from your terminal and scripts, and nameocean mcp install connects Claude Code, Cursor, OpenCode and VS Code for you.
$ curl -fsSL https://nameocean.net/install.sh | sh $ nameocean login $ nameocean dns add example.com A @ 203.0.113.10
Get a signed POST when a domain is registered or about to expire, a DNS record changes or a certificate is issued, instead of polling the API.
Send transactional email from your own domain with delivery events, create mailboxes, aliases and mailing lists, turn on free forwarding for domains registered here, and receive incoming mail at your endpoint as JSON.
Send your key in the Authorization header of every request. Responses are JSON. The limit is 120 requests per minute.
$ curl https://nameocean.net/api/v1/account \ -H "Authorization: Bearer $NAMEOCEAN_API_KEY" {"email": "you@example.com", "credit": "42.00", "currency": "USD", "domains": 3, "dns_zones": 3}
Create as many keys as you need in Dashboard → API keys, each with only the permissions its tool needs, an optional expiry date and an optional list of allowed IPs. A key is shown once; NameOcean keeps only its fingerprint.
A key can also be limited to some of your domains. It then works only on the endpoints of those domains (DNS, SSL, the domain's settings, its email and forwarding), sees only them in GET /dns, and gets 403 domain_not_allowed anywhere else, including servers, billing and your other domains. Use one for CI jobs and tools such as certbot, octoDNS or DNSControl.
account:read | Email and account credit |
domains:read | List domains, check availability and price |
domains:write | Change auto-renew, lock and nameservers; read the transfer code |
dns:read | List DNS zones and records |
dns:write | Create zones; add, change and delete records |
ssl:read | Certificate status |
ssl:write | Issue certificates, change auto-renew |
servers:read | App servers, their ports and domains |
servers:write | Open and close ports, bind and unbind domains |
email:read | Mail domains, mailboxes, aliases, forwarding and its log |
email:write | Add and delete mailboxes, aliases and lists; set passwords; turn forwarding on and off |
email:send | Send email from your mailboxes (POST /email/send) |
monitors:read | Uptime monitors, their status and incidents |
monitors:write | Add, change, pause and delete uptime monitors |
webhooks:read | Webhook endpoints and their deliveries |
webhooks:write | Add, change and delete webhook endpoints, send tests, resend deliveries |
billing:write | Register and renew domains (spends account credit) |
GET needs <area>:read, other methods <area>:write. Registering and renewing a domain also need billing:write; binding a domain to a server also needs dns:write. A call without the scope answers 403 with required_scopes. The same rules apply to the MCP server when it is used with a key.
Base URL: https://nameocean.net/api/v1/
The API reference has every field, error code and a curl example per endpoint; openapi.json imports into Postman or Insomnia.
| GET | /domains/check?name=example.com | Availability and price |
| GET | /whois/{name} | WHOIS/RDAP data of any domain: registrar, dates, status, nameservers |
| GET | /domains | List your domains |
| POST | /domains | Register a domain, paid from your balance {"name", "years"} |
| GET | /domains/{name} | Details, nameservers, SSL status |
| PATCH | /domains/{name} | Auto renew and transfer lock {"auto_renew", "locked"} |
| PUT | /domains/{name}/nameservers | {"nameservers": [...]} or "nameocean" |
| POST | /domains/{name}/renew | Renew one year (within 60 days of expiry) |
| GET | /domains/{name}/auth-code | Transfer code |
| GET | /dns | List DNS zones |
| POST | /dns | Create a zone for a domain registered elsewhere {"name"} |
| GET | /dns/{zone}/records | List records |
| POST | /dns/{zone}/records | Add a record: A, AAAA, CNAME, MX, TXT, SRV, PTR, CAA, REDIRECT |
| PATCH | /dns/{zone}/records/{type}/{id} | Change a record |
| DELETE | /dns/{zone}/records/{type}/{id} | Delete a record |
| POST | /dns/{zone}/plan · apply | Change the whole zone from a YAML or JSON file · DNS as code → |
| GET | /ssl/{zone} | Status, expiry date and download link |
| POST | /ssl/{zone} | Issue a free wildcard certificate |
| PATCH | /ssl/{zone} | Auto renew {"auto_renew"} |
{server} is the server id or its default domain, such as 3f9a1c2e.nameocean.org.
| GET | /servers | Your servers with SSH, git remote, ports and domains |
| GET | /servers/{server} | One server |
| GET | /servers/{server}/ports | Open ports |
| POST | /servers/{server}/ports | Open a TCP or UDP port {"port", "protocol"} |
| DELETE | /servers/{server}/ports/{id} | Close a port |
| GET | /servers/{server}/domains | Bound domains and their status |
| POST | /servers/{server}/domains | Bind a domain or subdomain with HTTPS {"domain"} |
| DELETE | /servers/{server}/domains/{id} | Unbind a domain |
| POST | /servers/{server}/deploys | After git push: restart the apps and record the deploy |
| GET | /servers/{server}/logs | App logs · all server endpoints → |
# 1. Check the price curl "https://nameocean.net/api/v1/domains/check?name=kahvebot.com" -H "Authorization: Bearer $KEY" # 2. Register (charges your balance) curl -X POST https://nameocean.net/api/v1/domains -H "Authorization: Bearer $KEY" \ -H "Content-Type: application/json" -d '{"name": "kahvebot.com", "years": 1}' # 3. Point it to your server curl -X POST https://nameocean.net/api/v1/dns/kahvebot.com/records -H "Authorization: Bearer $KEY" \ -H "Content-Type: application/json" -d '{"type": "A", "hostname": "@", "ip": "203.0.113.10", "ttl": "5m"}' # 4. Free wildcard SSL curl -X POST https://nameocean.net/api/v1/ssl/kahvebot.com -H "Authorization: Bearer $KEY"
The full reference for AI agents, with every field and record type, is at nameocean.net/llms.txt. GET /api/v1/ also describes itself.