Black Friday: add funds and get 2x credit, up to $50 free ($25 → $50, $50 → $100). Use it for anything: domains, hosting, email. Code: BLACKFRIDAY2026 Get 2x credit →

Give your AI one key. It handles your domains.

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.

  1. 1

    Create a key

    Open Dashboard → API keys, choose what the key may do and copy it.

  2. 2

    Give it to your AI

    Paste the prompt below into Claude, ChatGPT or Cursor together with your key.

  3. 3

    Ask in plain words

    "Point blog.example.com to 203.0.113.10 and turn on SSL."

Prompt for your AI assistant

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.

Connect Claude Code, Cursor or any MCP client

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 Code
$ 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.

Setup for each client and all tools →

Command line

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.

nameocean
$ curl -fsSL https://nameocean.net/install.sh | sh
$ nameocean login
$ nameocean dns add example.com A @ 203.0.113.10

Install options and all commands →

Webhooks

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.

Events, payloads and signature verification →

Email

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.

Email API guide →

Authentication

Send your key in the Authorization header of every request. Responses are JSON. The limit is 120 requests per minute.

curl
$ 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}

Key permissions (scopes)

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:readEmail and account credit
domains:readList domains, check availability and price
domains:writeChange auto-renew, lock and nameservers; read the transfer code
dns:readList DNS zones and records
dns:writeCreate zones; add, change and delete records
ssl:readCertificate status
ssl:writeIssue certificates, change auto-renew
servers:readApp servers, their ports and domains
servers:writeOpen and close ports, bind and unbind domains
email:readMail domains, mailboxes, aliases, forwarding and its log
email:writeAdd and delete mailboxes, aliases and lists; set passwords; turn forwarding on and off
email:sendSend email from your mailboxes (POST /email/send)
monitors:readUptime monitors, their status and incidents
monitors:writeAdd, change, pause and delete uptime monitors
webhooks:readWebhook endpoints and their deliveries
webhooks:writeAdd, change and delete webhook endpoints, send tests, resend deliveries
billing:writeRegister 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.

Endpoints

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.

Domains

GET/domains/check?name=example.comAvailability and price
GET/whois/{name}WHOIS/RDAP data of any domain: registrar, dates, status, nameservers
GET/domainsList your domains
POST/domainsRegister 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}/renewRenew one year (within 60 days of expiry)
GET/domains/{name}/auth-codeTransfer code

DNS

GET/dnsList DNS zones
POST/dnsCreate a zone for a domain registered elsewhere {"name"}
GET/dns/{zone}/recordsList records
POST/dns/{zone}/recordsAdd 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 · applyChange the whole zone from a YAML or JSON file · DNS as code →

SSL

GET/ssl/{zone}Status, expiry date and download link
POST/ssl/{zone}Issue a free wildcard certificate
PATCH/ssl/{zone}Auto renew {"auto_renew"}

App servers

{server} is the server id or its default domain, such as 3f9a1c2e.nameocean.org.

GET/serversYour servers with SSH, git remote, ports and domains
GET/servers/{server}One server
GET/servers/{server}/portsOpen ports
POST/servers/{server}/portsOpen a TCP or UDP port {"port", "protocol"}
DELETE/servers/{server}/ports/{id}Close a port
GET/servers/{server}/domainsBound domains and their status
POST/servers/{server}/domainsBind a domain or subdomain with HTTPS {"domain"}
DELETE/servers/{server}/domains/{id}Unbind a domain
POST/servers/{server}/deploysAfter git push: restart the apps and record the deploy
GET/servers/{server}/logsApp logs · all server endpoints →

Example: new domain with HTTPS

bash
# 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.