# Nextdns

NextDNS is a DNS service that enhances internet security and privacy by blocking malicious websites, tracking scripts, and ads before they reach your device.

- **Category:** security & identity tools
- **Auth:** API_KEY
- **Tools:** 43
- **Triggers:** 0
- **Slug:** `NEXTDNS`
- **Version:** 20260211_00

## Tools

### Add Blocked TLD

**Slug:** `NEXTDNS_ADD_BLOCKED_TLD`

Tool to add a top-level domain to the security blocklist for a NextDNS profile. Use after listing current security settings to ensure the TLD is not already blocked.

### Add Denylist Domain

**Slug:** `NEXTDNS_ADD_DENYLIST_DOMAIN`

Tool to add a domain to the denylist of a NextDNS profile. Use when blocking specific domains under a profile after obtaining its ID.

### Toggle Block Page

**Slug:** `NEXTDNS_BLOCK_PAGE`

Enable or disable the block page for a NextDNS configuration. When enabled, users attempting to access blocked domains see a branded page explaining the block. When disabled, blocked domains return NXDOMAIN silently. Use this to customize the user experience when domains are blocked by your DNS filtering rules.

### Clear Logs

**Slug:** `NEXTDNS_CLEAR_LOGS`

Tool to clear DNS logs for a NextDNS profile. Use when you want to remove all existing query logs for a given profile. Note: this operation cannot be undone.

### Create Profile

**Slug:** `NEXTDNS_CREATE_PROFILE`

This tool allows users to create a new NextDNS profile. It uses the POST method at the endpoint https://api.nextdns.io/profiles. A profile is a distinct configuration set for DNS filtering and security settings.

### Delete NextDNS Configuration

**Slug:** `NEXTDNS_DELETE_CONFIG`

Tool to delete a NextDNS configuration profile. Use when you need to remove an existing profile by its ID. Use after confirming the profile exists.

### Download Logs

**Slug:** `NEXTDNS_DOWNLOAD_LOGS`

Retrieves the download URL for exported DNS query logs from a NextDNS profile. Returns a time-limited URL pointing to a CSV file containing the profile's DNS logs. Use this to export log data for analysis, backup, or compliance purposes. The profile_id can be obtained from the list_configurations action.

### Get Analytics Devices

**Slug:** `NEXTDNS_GET_ANALYTICS_DEVICES`

Tool to retrieve analytics aggregated by devices. Use when you need per-device query metrics within a specific time frame.

### Get Analytics Domains

**Slug:** `NEXTDNS_GET_ANALYTICS_DOMAINS`

Tool to retrieve analytics data for domains within a specific profile. Use after confirming the profile ID to get per-domain query stats.

### Get Analytics IPs

**Slug:** `NEXTDNS_GET_ANALYTICS_IPS`

Tool to retrieve analytics aggregated by client IP addresses. Use when you need to analyze DNS query distribution per client IP for a given profile.

### Get Analytics IP Versions

**Slug:** `NEXTDNS_GET_ANALYTICS_IP_VERSIONS`

Tool to retrieve analytics grouped by IP version within a specific profile. Use after you have a profile ID to see IPv4 vs IPv6 query counts.

### Get Analytics Query Types

**Slug:** `NEXTDNS_GET_ANALYTICS_QUERY_TYPES`

Tool to retrieve DNS query counts broken down by query type. Use after selecting a profile and specifying date filters to analyze distribution by type.

### Get Analytics Reasons

**Slug:** `NEXTDNS_GET_ANALYTICS_REASONS`

Tool to retrieve DNS query counts broken down by classification reason. Use after selecting a profile and specifying date filters to analyze reason distribution.

### Get Analytics Status

**Slug:** `NEXTDNS_GET_ANALYTICS_STATUS`

Tool to retrieve analytics status for a specific profile. Use when you need counts of DNS queries broken down by status categories.

### Get Logs

**Slug:** `NEXTDNS_GET_LOGS`

Tool to retrieve logs for a specific NextDNS profile with optional filters. Use after confirming the profile ID to fetch raw or filtered DNS logs.

### Get Profile Details

**Slug:** `NEXTDNS_GET_PROFILE`

Retrieves the details of a specific NextDNS profile. It requires a 'profileId' as a path parameter and returns the profile details including name, security, privacy, parental control, denylist, allowlist, and general settings.

### Get Setup Info

**Slug:** `NEXTDNS_GET_SETUP_INFO`

Tool to get setup information for a provided configuration (profile). Use after obtaining a profile ID to fetch its current settings.

### List Configurations

**Slug:** `NEXTDNS_LIST_CONFIGURATIONS`

List all NextDNS configurations (profiles) associated with the authenticated account. Returns all profiles with their IDs, names, fingerprints, and user roles. Profile IDs returned by this action are used as the 'profile_id' or 'config_id' parameter for other NextDNS actions (e.g., get settings, update profile, etc.).

### List Denylist Domains

**Slug:** `NEXTDNS_LIST_DENYLIST_DOMAINS`

Tool to list domains in the denylist for a profile. Use after confirming the profile ID to review all blocked domains. Example: "List denylist domains for profile abc123."

### List Security Settings

**Slug:** `NEXTDNS_LIST_SECURITY_SETTINGS`

Tool to list current security options for a NextDNS configuration. Use after obtaining the configuration ID to review active security settings.

### List Settings

**Slug:** `NEXTDNS_LIST_SETTINGS`

Tool to list settings for a NextDNS profile. Use when auditing or inspecting all enabled settings before applying changes.

### Log Client IPs

**Slug:** `NEXTDNS_LOG_CLIENT_IPS`

Tool to enable or disable logging of client IPs for a NextDNS configuration. Use when you need to toggle whether client IPs are recorded in DNS logs.

### Toggle Domain Logging

**Slug:** `NEXTDNS_LOG_DOMAINS`

Tool to enable or disable logging of domains for a NextDNS profile. Use after retrieving profile settings when you need to adjust domain logging. Example: "Enable domain logging for profile abc123."

### NextDNS Login

**Slug:** `NEXTDNS_LOGIN`

Tool to authenticate to the NextDNS API. Use when you have an API key and need to verify credentials and obtain session headers and cookies for subsequent requests.

### Get Monthly Queries

**Slug:** `NEXTDNS_MONTHLY_QUERIES`

Tool to get the number of DNS queries made in the current month for a profile. Use after selecting a profile.

### Remove Blocked TLD

**Slug:** `NEXTDNS_REMOVE_BLOCKED_TLD`

Tool to remove a top-level domain from the security blocklist for a NextDNS profile. Use after listing current security settings to confirm the TLD is currently blocked.

### Remove Denylist Domain

**Slug:** `NEXTDNS_REMOVE_DENYLIST_DOMAIN`

Removes a domain from a NextDNS profile's denylist (blocklist). The domain will no longer be blocked by the DNS filter after removal. Use 'List Denylist Domains' first to verify the domain exists in the denylist before attempting removal.

### Rename Configuration

**Slug:** `NEXTDNS_RENAME_CONFIG`

Tool to rename a NextDNS configuration (profile). Use when you need to update a profile's name after obtaining its ID. Example: RenameConfig(name="Home Profile", config_id="d46a5b")

### Set AI Threat Detection

**Slug:** `NEXTDNS_SET_AI_DETECTION`

Tool to enable or disable AI Threat Detection for a NextDNS configuration. Use after listing security settings to toggle the AI detection flag.

### Toggle Cryptojacking Protection

**Slug:** `NEXTDNS_SET_CRYPTOJACKING`

Tool to enable or disable cryptojacking protection for a NextDNS configuration. Use when toggling unauthorized crypto mining protection after listing security settings.

### Set CSAM Blocking

**Slug:** `NEXTDNS_SET_CSAM`

Tool to enable or disable blocking of child sexual abuse material domains for a NextDNS profile. Use when updating security settings after obtaining the profile ID.

### Toggle DGA Protection

**Slug:** `NEXTDNS_SET_DGA`

Tool to enable or disable DGA (domain generation algorithm) protection for a NextDNS configuration. Use when toggling algorithm-generated domains protection after listing security settings.

### Set DNS Rebinding Protection

**Slug:** `NEXTDNS_SET_DNS_REBINDING`

Tool to enable or disable DNS rebinding protection for a NextDNS configuration. Use when toggling DNS rebinding protection after reviewing current security settings.

### Set Homograph Protection

**Slug:** `NEXTDNS_SET_HOMOGRAPH`

Tool to enable or disable homograph attack protection for a NextDNS configuration. Use when toggling IDN homograph filtering after listing security settings.

### Set Newly Registered Domains

**Slug:** `NEXTDNS_SET_NEW_DOMAINS`

Tool to enable or disable blocking of newly registered domains for a NextDNS profile. Use when updating security settings after obtaining the profile ID.

### Toggle Parked Domains Blocking

**Slug:** `NEXTDNS_SET_PARKED`

Tool to enable or disable blocking of parked domains for a NextDNS configuration. Use when toggling parked domain blocking after listing security settings.

### Set Safe Browsing

**Slug:** `NEXTDNS_SET_SAFE_BROWSING`

Tool to enable or disable Google Safe Browsing for a NextDNS configuration. Use when toggling malware and phishing protection after reviewing current security settings.

### Toggle Threat Intelligence Feeds

**Slug:** `NEXTDNS_SET_THREAT_INTELLIGENCE_FEEDS`

Tool to enable or disable Real-Time Threat Intelligence Feeds for a NextDNS configuration. Use after listing security settings to toggle the threatIntelligenceFeeds flag.

### Toggle Typosquatting Protection

**Slug:** `NEXTDNS_SET_TYPOSQUATTING`

Tool to enable or disable typosquatting protection for a NextDNS configuration. Use after listing security settings to toggle the typosquatting flag.

### Update linked IP

**Slug:** `NEXTDNS_UPDATE_LINKED_IP`

Updates the linked IP address for a NextDNS profile to the current caller's public IP. This is used for dynamic DNS setups where the profile needs to recognize the user's current IP address for DNS filtering to work properly.

### Update Performance Settings

**Slug:** `NEXTDNS_UPDATE_PERFORMANCE_SETTINGS`

Tool to update performance settings of a NextDNS profile. Use when adjusting performance optimizations after reviewing current settings.

### Update Privacy Settings

**Slug:** `NEXTDNS_UPDATE_PRIVACY_SETTINGS`

Tool to update privacy settings for a profile. Use when you need to change blocklists, native trackers, disguisedTrackers, or allowAffiliate in one call.

### Update Profile

**Slug:** `NEXTDNS_UPDATE_PROFILE`

Update an existing NextDNS profile's settings. Supports partial updates - only the fields you provide will be modified, other settings remain unchanged. Common use cases: - Rename a profile: {"profile": "abc123", "name": "New Name"} - Enable security features: {"profile": "abc123", "security": {"googleSafeBrowsing": true}} - Block domains: {"profile": "abc123", "denylist": [{"id": "malware.com", "active": true}]} - Configure parental controls: {"profile": "abc123", "parentalControl": {"safeSearch": true}} Note: Use NEXTDNS_LIST_CONFIGURATIONS to get available profile IDs, and NEXTDNS_GET_PROFILE to view current settings before updating.
