get_profile
Retrieve the full configuration of a specific NextDNS profile, including security settings, privacy settings, parental controls, allowlist, denylist, rewrites, and operational settings. Use this to inspect the complete state of a profile.
update_privacy
Update the privacy and ad-blocking configuration for a NextDNS profile. Manage blocklists (e.g., "nextdns-recommended", "oisd"), native tracker blocking for platforms (e.g., "apple", "samsung", "huawei", "windows", "xiaomi", "alexa", "roku", "sonos"), and toggle disguised tracker blocking and affiliate link handling.
update_security
Update the security configuration for a NextDNS profile. Toggle threat protection features such as AI threat detection, Google Safe Browsing, cryptojacking protection, DNS rebinding protection, and more. You can also manage the list of blocked TLDs (e.g., `.ru`, `.cn`). Only provide the fields you want to change.
delete_profile
Permanently delete a NextDNS DNS configuration profile. This also clears all logs associated with the profile. **This action cannot be undone.**
manage_rewrites
Manage DNS rewrite rules for a NextDNS profile. Add or remove custom DNS rewrite rules that map domain names to specific IP addresses or CNAMEs. Useful for local network resolution (e.g., mapping "router.local" to "192.168.1.1").
get_analytics
Retrieve DNS query analytics for a NextDNS profile. Query various dimensions including status counts, top domains, block reasons, client IPs, devices, protocols, query types, IP versions, DNSSEC validation, encryption stats, and destination countries or GAFAM companies. Supports date range filtering and optional time series mode.
clear_logs
Permanently clear all DNS query logs for a NextDNS profile. **This action is irreversible** — all log data will be deleted.
create_profile
Create a new NextDNS DNS configuration profile. Returns the ID and setup information for the newly created profile. After creation, configure security, privacy, and parental control settings using other tools.
manage_allowlist_denylist
Add, remove, or toggle domains on a NextDNS profile's allowlist or denylist. Retrieve the current lists, add new domains, remove existing domains, or toggle entries active/inactive. Operate on the allowlist, denylist, or both in a single call.
get_setup
Retrieve connection and setup information for a NextDNS profile. Returns DNS server addresses (IPv4/IPv6), linked IP details, DDNS hostname, DNS stamp, and other configuration needed to connect devices to the profile.
update_parental_control
Update parental control settings for a NextDNS profile. Block specific services (e.g., TikTok, Facebook) and content categories (e.g., porn, gambling), enable SafeSearch and YouTube Restricted Mode, and block bypass methods like VPNs and proxies. Add or remove blocked services and categories incrementally.
update_settings
Update operational settings for a NextDNS profile. Configure logging (enable/disable, retention, location, privacy options), block page display, performance options (ECS, cache boost, CNAME flattening), and Web3 domain resolution. Only provide the fields you want to change.
list_profiles
List all DNS configuration profiles in the NextDNS account. Returns a summary of each profile including its ID and name. Use this to discover available profiles before performing operations on them.
get_logs
Retrieve DNS query logs for a NextDNS profile. Each log entry includes the timestamp, queried domain, protocol, client IP, device info, query status, and blocking reasons. Supports filtering by date range, device, status, and domain search.