# How to integrate Nextdns MCP with Hermes

```json
{
  "title": "How to integrate Nextdns MCP with Hermes",
  "toolkit": "Nextdns",
  "toolkit_slug": "nextdns",
  "framework": "Hermes",
  "framework_slug": "hermes-agent",
  "url": "https://composio.dev/toolkits/nextdns/framework/hermes-agent",
  "markdown_url": "https://composio.dev/toolkits/nextdns/framework/hermes-agent.md",
  "updated_at": "2026-05-06T08:21:33.156Z"
}
```

## Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.
This guide explains the easiest and most robust way to connect your Nextdns account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

## Also integrate Nextdns with

- [OpenAI Agents SDK](https://composio.dev/toolkits/nextdns/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/nextdns/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/nextdns/framework/claude-code)
- [Claude Cowork](https://composio.dev/toolkits/nextdns/framework/claude-cowork)
- [Codex](https://composio.dev/toolkits/nextdns/framework/codex)
- [OpenClaw](https://composio.dev/toolkits/nextdns/framework/openclaw)
- [CLI](https://composio.dev/toolkits/nextdns/framework/cli)
- [Google ADK](https://composio.dev/toolkits/nextdns/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/nextdns/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/nextdns/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/nextdns/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/nextdns/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/nextdns/framework/crew-ai)

## TL;DR

### What is Composio Connect?
Composio Connect is a consumer offering that lets anyone plug 1,000+ applications directly into their agent harness — including Hermes. It can:
- Search and load tools from relevant toolkits on-demand, reducing context usage.
- Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
- Manage app authentication end-to-end with zero manual overhead.

## Connect Nextdns to Hermes

### Integrating Nextdns with Hermes
### Using Composio Connect CLI
1. Install the Composio CLI
Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

```bash
curl -fsSL https://composio.dev/install | bash
```

## What is the Nextdns MCP server, and what's possible with it?

The Nextdns MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Nextdns account. It provides structured and secure access to your DNS security and privacy controls, so your agent can perform actions like blocking domains, managing profiles, analyzing DNS analytics, and clearing logs on your behalf.
- Dynamic domain and TLD blocking: Instantly add domains or top-level domains to your denylist or security blocklist, helping you stay ahead of new threats.
- Profile management and configuration: Create, update, or delete NextDNS configuration profiles to tailor DNS filtering and security settings for different users or devices.
- Comprehensive DNS analytics: Retrieve detailed analytics by device, domain, or client IP to monitor DNS activity, spot anomalies, and optimize security policies.
- Log management and export: Download DNS query logs for audit or troubleshooting, or clear logs entirely to maintain your privacy.
- Control over block page settings: Enable or disable the block page for any configuration, giving you flexibility over how blocks are displayed to users.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `NEXTDNS_ADD_BLOCKED_TLD` | 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. |
| `NEXTDNS_ADD_DENYLIST_DOMAIN` | 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. |
| `NEXTDNS_BLOCK_PAGE` | Toggle Block Page | Tool to enable or disable block page for a configuration. use when you need to toggle whether dns blocks show a block page. |
| `NEXTDNS_CLEAR_LOGS` | 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. |
| `NEXTDNS_CREATE_PROFILE` | 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. |
| `NEXTDNS_DELETE_CONFIG` | Delete NextDNS Configuration | 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. |
| `NEXTDNS_DOWNLOAD_LOGS` | Download Logs | Tool to download dns logs for a profile. use when you need the url of the exported logs. use after confirming the profile id is valid. supports getting a redirect url or json. |
| `NEXTDNS_GET_ANALYTICS_DEVICES` | Get Analytics Devices | Tool to retrieve analytics aggregated by devices. use when you need per-device query metrics within a specific time frame. |
| `NEXTDNS_GET_ANALYTICS_DOMAINS` | 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. |
| `NEXTDNS_GET_ANALYTICS_IPS` | 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. |
| `NEXTDNS_GET_ANALYTICS_IP_VERSIONS` | 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. |
| `NEXTDNS_GET_ANALYTICS_QUERY_TYPES` | 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. |
| `NEXTDNS_GET_ANALYTICS_REASONS` | 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. |
| `NEXTDNS_GET_ANALYTICS_STATUS` | 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. |
| `NEXTDNS_GET_LOGS` | 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. |
| `NEXTDNS_GET_PROFILE` | Get Profile Details | 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. |
| `NEXTDNS_GET_SETUP_INFO` | Get Setup Info | Tool to get setup information for a provided configuration (profile). use after obtaining a profile id to fetch its current settings. |
| `NEXTDNS_LIST_CONFIGURATIONS` | List Configurations | Tool to list all configurations (profiles) available on the nextdns account. use after authenticating to page through profiles. |
| `NEXTDNS_LIST_DENYLIST_DOMAINS` | 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." |
| `NEXTDNS_LIST_SECURITY_SETTINGS` | List Security Settings | Tool to list current security options for a nextdns configuration. use after obtaining the configuration id to review active security settings. |
| `NEXTDNS_LIST_SETTINGS` | List Settings | Tool to list settings for a nextdns profile. use when auditing or inspecting all enabled settings before applying changes. |
| `NEXTDNS_LOG_CLIENT_IPS` | 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. |
| `NEXTDNS_LOG_DOMAINS` | Toggle Domain Logging | 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` | 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. |
| `NEXTDNS_MONTHLY_QUERIES` | Get Monthly Queries | Tool to get the number of dns queries made in the current month for a profile. use after selecting a profile. |
| `NEXTDNS_REMOVE_BLOCKED_TLD` | 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. |
| `NEXTDNS_REMOVE_DENYLIST_DOMAIN` | Remove Denylist Domain | Tool to remove a domain from a profile's denylist. use after confirming the domain is currently denied to clean it up. |
| `NEXTDNS_RENAME_CONFIG` | Rename Configuration | 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") |
| `NEXTDNS_SET_AI_DETECTION` | Set AI Threat Detection | Tool to enable or disable ai threat detection for a nextdns configuration. use after listing security settings to toggle the ai detection flag. |
| `NEXTDNS_SET_CRYPTOJACKING` | Toggle Cryptojacking Protection | Tool to enable or disable cryptojacking protection for a nextdns configuration. use when toggling unauthorized crypto mining protection after listing security settings. |
| `NEXTDNS_SET_CSAM` | Set CSAM Blocking | 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. |
| `NEXTDNS_SET_DGA` | Toggle DGA Protection | 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. |
| `NEXTDNS_SET_DNS_REBINDING` | Set DNS Rebinding Protection | Tool to enable or disable dns rebinding protection for a nextdns configuration. use when toggling dns rebinding protection after reviewing current security settings. |
| `NEXTDNS_SET_HOMOGRAPH` | Set Homograph Protection | Tool to enable or disable homograph attack protection for a nextdns configuration. use when toggling idn homograph filtering after listing security settings. |
| `NEXTDNS_SET_NEW_DOMAINS` | Set Newly Registered 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. |
| `NEXTDNS_SET_PARKED` | Toggle Parked Domains Blocking | Tool to enable or disable blocking of parked domains for a nextdns configuration. use when toggling parked domain blocking after listing security settings. |
| `NEXTDNS_SET_SAFE_BROWSING` | 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. |
| `NEXTDNS_SET_THREAT_INTELLIGENCE_FEEDS` | Toggle 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. |
| `NEXTDNS_SET_TYPOSQUATTING` | Toggle Typosquatting Protection | Tool to enable or disable typosquatting protection for a nextdns configuration. use after listing security settings to toggle the typosquatting flag. |
| `NEXTDNS_UPDATE_LINKED_IP` | Update linked IP | Tool to update the linked ip for a nextdns profile. use after retrieving the profile setup to apply the current ip to the profile. |
| `NEXTDNS_UPDATE_PERFORMANCE_SETTINGS` | Update Performance Settings | Tool to update performance settings of a nextdns profile. use when adjusting performance optimizations after reviewing current settings. |
| `NEXTDNS_UPDATE_PRIVACY_SETTINGS` | 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. |
| `NEXTDNS_UPDATE_PROFILE` | Update Profile | Tool to update an existing profile. use after retrieving a profile's current settings to apply changes. |

## Supported Triggers

None listed.

## Creating MCP Server - Stand-alone vs Composio SDK

The Nextdns MCP server provides comprehensive access to Nextdns operations through Composio. Once connected, Hermes can perform all major Nextdns actions on your behalf using natural language commands.

## Complete Code

None listed.

## Conclusion

### Way Forward
With Nextdns connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.
From here, you can extend Hermes further:
- Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
- Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
- Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.
If you run into trouble or want to share what you've built, join the [community](https://discord.com/invite/composio) or check out the [Docs](https://docs.composio.dev?utm_source=toolkits&utm_medium=framework_template&utm_campaign=hermes&utm_content=docs) for deeper configuration options.

## How to build Nextdns MCP Agent with another framework

- [OpenAI Agents SDK](https://composio.dev/toolkits/nextdns/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/nextdns/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/nextdns/framework/claude-code)
- [Claude Cowork](https://composio.dev/toolkits/nextdns/framework/claude-cowork)
- [Codex](https://composio.dev/toolkits/nextdns/framework/codex)
- [OpenClaw](https://composio.dev/toolkits/nextdns/framework/openclaw)
- [CLI](https://composio.dev/toolkits/nextdns/framework/cli)
- [Google ADK](https://composio.dev/toolkits/nextdns/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/nextdns/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/nextdns/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/nextdns/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/nextdns/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/nextdns/framework/crew-ai)

## Related Toolkits

- [Excel](https://composio.dev/toolkits/excel) - Microsoft Excel is a robust spreadsheet application for organizing, analyzing, and visualizing data. It's the go-to tool for calculations, reporting, and flexible data management.
- [21risk](https://composio.dev/toolkits/_21risk) - 21RISK is a web app built for easy checklist, audit, and compliance management. It streamlines risk processes so teams can focus on what matters.
- [Abstract](https://composio.dev/toolkits/abstract) - Abstract provides a suite of APIs for automating data validation and enrichment tasks. It helps developers streamline workflows and ensure data quality with minimal effort.
- [Addressfinder](https://composio.dev/toolkits/addressfinder) - Addressfinder is a data quality platform for verifying addresses, emails, and phone numbers. It helps you ensure accurate customer and contact data every time.
- [Agentql](https://composio.dev/toolkits/agentql) - Agentql is a toolkit that connects AI agents to the web using a specialized query language. It enables structured web interaction and data extraction for smarter automations.
- [Agenty](https://composio.dev/toolkits/agenty) - Agenty is a web scraping and automation platform for extracting data and automating browser tasks—no coding needed. It streamlines data collection, monitoring, and repetitive online actions.
- [Ambee](https://composio.dev/toolkits/ambee) - Ambee is an environmental data platform providing real-time, hyperlocal APIs for air quality, weather, and pollen. Get precise environmental insights to power smarter decisions in your apps and workflows.
- [Ambient weather](https://composio.dev/toolkits/ambient_weather) - Ambient Weather is a platform for personal weather stations with a robust API for accessing local, real-time, and historical weather data. Get detailed environmental insights directly from your own sensors for smarter apps and automations.
- [Anonyflow](https://composio.dev/toolkits/anonyflow) - Anonyflow is a service for encryption-based data anonymization and secure data sharing. It helps organizations meet GDPR, CCPA, and HIPAA data privacy compliance requirements.
- [Api ninjas](https://composio.dev/toolkits/api_ninjas) - Api ninjas offers 120+ public APIs spanning categories like weather, finance, sports, and more. Developers use it to supercharge apps with real-time data and actionable endpoints.
- [Api sports](https://composio.dev/toolkits/api_sports) - Api sports is a comprehensive sports data platform covering 2,000+ competitions with live scores and 15+ years of stats. Instantly access up-to-date sports information for analysis, apps, or chatbots.
- [Apify](https://composio.dev/toolkits/apify) - Apify is a cloud platform for building, deploying, and managing web scraping and automation tools called Actors. It lets you automate data extraction and workflow tasks at scale—no infrastructure headaches.
- [Autom](https://composio.dev/toolkits/autom) - Autom is a lightning-fast search engine results data platform for Google, Bing, and Brave. Developers use it to access fresh, low-latency SERP data on demand.
- [Beaconchain](https://composio.dev/toolkits/beaconchain) - Beaconchain is a real-time analytics platform for Ethereum 2.0's Beacon Chain. It provides detailed insights into validators, blocks, and overall network performance.
- [Big data cloud](https://composio.dev/toolkits/big_data_cloud) - BigDataCloud provides APIs for geolocation, reverse geocoding, and address validation. Instantly access reliable location intelligence to enhance your applications and workflows.
- [Bigpicture io](https://composio.dev/toolkits/bigpicture_io) - BigPicture.io offers APIs for accessing detailed company and profile data. Instantly enrich your applications with up-to-date insights on 20M+ businesses.
- [Bitquery](https://composio.dev/toolkits/bitquery) - Bitquery is a blockchain data platform offering indexed, real-time, and historical data from 40+ blockchains via GraphQL APIs. Get unified, reliable access to complex on-chain data for analytics, trading, and research.
- [Brightdata](https://composio.dev/toolkits/brightdata) - Brightdata is a leading web data platform offering advanced scraping, SERP APIs, and anti-bot tools. It lets you collect public web data at scale, bypassing blocks and friction.
- [Builtwith](https://composio.dev/toolkits/builtwith) - BuiltWith is a web technology profiler that uncovers the technologies powering any website. Gain actionable insights into analytics, hosting, and content management stacks for smarter research and lead generation.
- [Byteforms](https://composio.dev/toolkits/byteforms) - Byteforms is an all-in-one platform for creating forms, managing submissions, and integrating data. It streamlines workflows by centralizing form data collection and automation.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and Nextdns MCP?

With a standalone Nextdns MCP server, the agents and LLMs can only access a fixed set of Nextdns tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Nextdns and many other apps based on the task at hand, all through a single MCP endpoint.

### Can I use Tool Router MCP with Hermes?

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Nextdns tools.

### Can I manage the permissions and scopes for Nextdns while using Tool Router?

Yes, absolutely. You can configure which Nextdns scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

### How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Nextdns data and credentials are handled as safely as possible.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)