Développeurs → Journal des modifications

Journal des modifications

Les nouveautés de l'API REST, des webhooks, de la CLI nameocean et du serveur MCP. Les entrées sont rédigées en anglais, comme l'API.

RSS

APICLI

Quickstart and guides

  • Quickstart: an API key, a domain check, a DNS record and a webhook in five minutes.
  • Guide: wildcard Let's Encrypt certificates with DNS-01 and a certbot hook for NameOcean DNS (/developers/guides/letsencrypt-dns-01/nameocean-hook.sh).
  • Guides: receive email in your app as signed JSON, and deploy a Flask, Django, Node.js or Next.js app with git push.

Documentation →

MCP

MCP setup for every client, and this changelog

  • /developers/mcp/: setup for Claude Code, Claude, Cursor, VS Code and OpenCode, and every tool with whether it reads, writes or deletes.
  • This changelog, with RSS at /changelog/rss.xml.

Documentation →

APICLIMCP

DNS as code

  • Keep a zone in one YAML or JSON file: GET /dns/{zone}/export, POST /dns/{zone}/plan and POST /dns/{zone}/apply. Apply runs in one transaction and refuses a zone that changed since the plan.
  • CLI v0.5.0: nameocean dns export, dns plan (--detailed-exitcode for CI) and dns apply.
  • MCP: export_dns_zone, plan_dns_zone, apply_dns_zone.
  • JSON Schema for editors at https://nameocean.net/schemas/dns-zone.json.

Documentation →

APICLIMCPWebhooks

App Server API and nameocean deploy

  • Create servers (the first call returns the price, the second needs confirm: true), start, stop and restart them, back up and restore.
  • Inside an App Server: list and restart apps, read logs, set env variables, add SSH keys, record deploys.
  • CLI v0.4.0: nameocean deploy pushes the current branch to the server and restarts the apps; nameocean servers covers the rest.
  • Events server.created, started, stopped, restarted, restore.started and deployed.

Documentation →

APICLIMCPWebhooks

Send transactional email

  • POST /email/send from a mailbox or alias of a domain on NameOcean email hosting, with attachments, headers, metadata and scheduled sending. New scope email:send.
  • Delivery status per recipient (GET /email/sent), suppression lists, and the events email.delivered, delayed, bounced and suppressed.
  • CLI v0.3.0: nameocean email send, sent and suppressions. MCP: send_email, list_sent_email.

Documentation →

APICLIMCPWebhooks

Email hosting and forwarding API

  • Mailboxes, aliases and mailing lists over REST (/email/domains/...), with a DNS check for MX, SPF, DKIM and DMARC. Scopes email:read and email:write.
  • Free forwarding for domains registered at NameOcean: aliases, targets, the message log and inbound webhooks that POST incoming mail to your endpoint as signed JSON.
  • CLI v0.2.0: nameocean email. 16 MCP tools.

Documentation →

APIMCPWebhooks

Webhooks

  • Signed POSTs to your HTTPS endpoint when a domain is registered, renewed or about to expire, a DNS record changes, or a certificate is issued, renewed or about to expire.
  • Manage endpoints at /webhooks, in Dashboard → Webhooks or over MCP; send a test event and see every delivery. Failed deliveries are retried for about a day.

Documentation →

APIMCP

Scoped API keys, OpenAPI and the activity log

  • Several API keys per account, each with scopes, an optional expiry date and an IP allow list. A call without the scope answers 403 with required_scopes.
  • OpenAPI 3.1 at /api/v1/openapi.json and a reference at /developers/api/. Errors carry a stable code; every answer has X-RateLimit-* headers; writes accept an Idempotency-Key.
  • Activity log of everything done through the API, the CLI and MCP: Dashboard → Activity, GET /audit and the list_activity MCP tool.

Documentation →

CLI

The nameocean CLI

  • Install with Homebrew (brew install nameocean/tap/nameocean), curl -fsSL https://nameocean.net/install.sh | sh, or a ready binary for macOS, Linux and Windows on Intel and ARM.
  • nameocean login signs in through the browser; servers, ports, domains, DNS and SSL commands, all with --json. nameocean mcp install connects Claude Code, Cursor and OpenCode.

Documentation →