How to integrate Control d MCP with Atomic Agent

Connect Atomic Agent to Control d MCP. List all devices connected to your account, remove a device by its id, and more using natural language, with authentication handled for you.

Control d logoControl d
Api Key

Control d is a customizable DNS filtering and traffic redirection platform. It helps you manage internet access, enforce policies, and monitor usage across devices and networks.

54 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Control d.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Control d account. See the Atomic Agent documentation for installation instructions.

Also integrate Control d with

How Atomic Agent connects to Control d

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Control d to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Control d. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Control d account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Control d MCP server, and what's possible with it?

The Control d MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Control d account. It provides structured and secure access to your DNS filtering and device management environment, so your agent can perform actions like managing devices, enforcing policies, retrieving analytics, and monitoring network access on your behalf.

  • Device inventory management: Easily list all devices on your account or remove specific devices by their identifier for streamlined device control.
  • Profile and rule administration: Direct your agent to delete profiles, custom rules, or schedules—helping you maintain and enforce up-to-date network policies.
  • Network access monitoring: Retrieve a list of known access IPs to keep tabs on which endpoints are connecting to your network infrastructure.
  • Analytics endpoints discovery: Quickly fetch available analytics storage regions and endpoints so you can integrate and analyze DNS traffic data efficiently.
  • Organization details access: Have the agent fetch and present your organization's account details for easy reference and auditing.

Use Control d from Atomic Agent

With your account connected, ask Atomic Agent to work with Control d in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Control d action and event your agent gets out of the box.

Delete Device by ID

Permanently delete a Control-D device/endpoint by its ID.

Delete Profile

Permanently deletes a Control D profile by its unique identifier (PK).

Delete Profile Rule by Rule ID

Delete a custom DNS rule from a Control D profile by its rule identifier (hostname/domain).

Delete Rule from Folder

Delete a custom DNS rule from a specific folder in a Control D profile.

Delete Profile Schedule

Tool to delete a specific schedule within a profile.

List Known Access IPs

List up to the latest 50 IP addresses that were used to query against a specific Device (resolver).

Get Analytics Endpoints

Tool to list analytics storage regions and their endpoints.

Get Analytics Levels

Tool to retrieve available analytics log levels for Control D devices.

Get Billing Payments

Tool to retrieve billing history of all payments made.

Get Billing Products

Retrieve all products currently activated on the Control D account.

Get Devices

Lists all Control D devices (endpoints) associated with the account.

Get Device Types

List all allowed device types in Control D.

Get IP

Tool to retrieve the current IP address and datacenter information for the API request.

Get Network Stats

Tool to retrieve network stats on available services in different POPs (Points of Presence).

Get Organization Members

Tool to view organization membership.

Get Organization Details

Tool to view the authenticated organization's details.

Get Sub-Organizations

Tool to view sub-organizations and their details.

Get Profiles

Tool to list all profiles associated with the authenticated account.

Get Profile Options

Retrieves all available configuration options for DNS profiles in Control D.

Get Profile by ID

Tool to retrieve details of a specific profile by its ID.

Get Profile Analytics

Retrieve analytics data for a Control D profile.

Get Profile Analytics Logs

Retrieves DNS query activity logs for a specific Control D profile.

Get Analytics Log Entry

Tool to retrieve a specific analytics log entry by its ID.

Get Profile Analytics Summary

Tool to fetch a summary of analytics data for a given profile.

Get Profile Analytics Top Domains

Tool to fetch top domains accessed within a specific profile.

Get Profile Top Services

Tool to fetch top services accessed within a profile.

Get Profile Filters

List all native (Control D curated) filters for a profile and their current states.

List External Filters for Profile

Tool to list third-party filters for a specific profile.

Get Profile Folders

List all rule folders (groups) within a Control D profile.

List Custom DNS Rules for Profile

Retrieve custom DNS rules for a Control D profile.

Get Specific Rule in Folder

Tool to retrieve a specific rule within a folder by its ID.

Get Profile Schedules

Tool to list schedules associated with a specific profile.

Get Profile Schedule

Tool to retrieve a specific schedule by its ID within a profile.

Get Profile Services

Tool to list services associated with a specific profile.

Get Proxies

Tool to retrieve the list of usable proxy locations that traffic can be redirected through.

Get Service Categories

List all available service categories in Control D.

List Services by Category

Retrieves all services within a specific ControlD service category.

Get Users

Retrieve the authenticated user's account information from Control D.

Create Device

Create a new device (DNS endpoint) in Control D.

Create Profile

Create a new blank profile or clone an existing one.

Create Custom DNS Rule

Create custom DNS rules for a profile to control domain resolution.

Create Custom Rules in Profile Folder

Tool to create custom rules within a specific folder for a profile.

Create Profile Schedule

Create a new time-based schedule within a Control D profile.

Modify Device

Modify an existing Control D device's settings.

Modify Organization

Modify organization settings such as name, contact details, website, and device limits.

Modify Profile

Modify an existing profile by its ID.

Bulk Update Profile Filters

Tool to bulk update filters on a specific profile.

Update External Filters for Profile

Tool to update external filters for a specific profile.

Modify Profile Filter

Modify the enabled state of a specific native filter on a profile.

Modify Custom Rule for Profile

Modify an existing custom DNS rule for a profile in Control D.

Update Custom Rule by Rule ID

Tool to update an existing custom rule by its ID.

Move Profile Rule to Folder

Tool to move a specific custom rule into a different folder.

Update Profile Schedule

Tool to update a specific schedule within a profile.

Modify Service for Profile

Tool to modify a specific service rule for a profile.

FAQ

Frequently asked questions

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

Yes, you can. Atomic Agent 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 Control d tools.

Yes, absolutely. You can configure which Control d 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.

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 Control d data and credentials are handled as safely as possible.

Start with Control d.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Control d tool your agent needs.Free to start.

Start building