# Cloud DNS MCP

> Cloud DNS MCP gives your agent direct access to global Anycast DNS settings. You manage zones, create records (A, MX, TXT), and delete anything needed through simple text commands. It automates complex domain management and network infrastructure changes without you ever needing to log into a console dashboard.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** dns, anycast, domain-management, networking, cloud-dns

## Description

Need to make a change to your domain's global routing? This MCP connects your AI client directly to the Cloud DNS API, letting you treat your entire network setup like a natural conversation. You tell your agent what needs fixing—maybe pointing a subdomain to a new IP address or retiring an old service—and it handles the infrastructure commands automatically. It lets you list all zones, create records for specific types (A, CNAME, MX), and audit every setting in a zone without manually navigating menus. Because this capability is hosted on Vinkius, you connect once from any compatible AI client and get full access to manage your global network settings right from your IDE or chat window.

## Tools

### create_record
This tool creates a brand new DNS record for an existing domain zone.

### create_zone
This tool sets up and defines an entirely new, blank DNS zone for a given domain name.

### delete_record
This tool removes a specific type of DNS record from its current zone.

### delete_zone
This tool permanently deletes all records and the entire domain zone structure.

### list_records
This tool fetches a list of every record currently defined within a specific target zone.

### list_zones
This tool retrieves a list of all DNS zones managed under the account.

### update_record
This tool changes the value or details of an already existing, active record.

## Prompt Examples

**Prompt:** 
```
List all my DNS zones.
```

**Response:** 
```
I've retrieved your DNS zones. You have 2 active zones: 'example.com' (ID: 12345) and 'my-app.net' (ID: 67890).
```

**Prompt:** 
```
Create a new A record for 'api' pointing to '1.2.3.4' in zone 12345.
```

**Response:** 
```
Successfully created the A record for 'api.example.com' pointing to 1.2.3.4 in zone 12345.
```

**Prompt:** 
```
Delete the DNS record with ID 98765 from zone 12345.
```

**Response:** 
```
The DNS record 98765 has been successfully removed from zone 12345.
```

## Capabilities

### Manage DNS Zones
You can create brand new domain zones, or delete entire domains if they are no longer needed.

### Control Network Records
Add and change specific record types—like A, CNAME, MX, or TXT—for any target zone.

### Update Existing Details
Modify the details of records you've already set up, such as adjusting TTLs or priority numbers for mail servers.

### Audit Zone Configuration
Pull a complete list of every single record currently defined within a specific zone to check for errors or compliance issues.

## Use Cases

### A microservice went live on a new IP address.
The backend developer needs to point 'staging.mycompany.com' to the new server IP, but they don't want to leave their terminal. They ask their agent: 'Update the A record for staging.mycompany.com to 203.0.113.45.' The MCP runs `update_record` and confirms the change immediately.

### The company is retiring an old product line.
The system administrator needs to completely remove all network presence for 'oldproductcorp.net'. They use the agent to run `delete_zone`, ensuring that every record and pointer associated with that domain are wiped clean.

### Need a quick audit of global domains.
The security team needs to know which subdomains exist across all managed zones. They ask the agent to run `list_zones` first, then loop through each zone using `list_records` to compile a complete list for review.

## Benefits

- Avoid manual dashboard clicks. Instead of navigating complex web interfaces, you simply tell your agent to run `create_record` or `update_record`, and it handles the API call in one go.
- Audit configuration instantly. If you need to check what's live before deployment, running `list_records` gives you a full manifest of data for any zone.
- Automate infrastructure setup. For DevOps teams, this MCP allows them to use `create_zone` and deploy initial record sets as part of their automated workflows.
- Manage entire domains at once. Don't just fix records; run `delete_zone` when a project is archived, or `list_zones` to see your full domain portfolio.
- Save time with structured updates. Instead of manually finding the correct record ID and value, use `update_record` to modify details like TTLs instantly.

## How It Works

The bottom line is: you describe the network change in plain English, and this MCP makes it happen instantly via API calls.

1. Subscribe to this MCP and provide your Cloud DNS API key.
2. Your AI agent uses the credentials to connect, giving it immediate read/write access to your domain settings.
3. You give a natural language request (e.g., 'Set up a new A record for my staging app'). The agent executes the necessary commands.

## Frequently Asked Questions

**Can I list all DNS records for a specific zone ID?**
Yes! Use the `list_records` tool with the target Zone ID. The agent will return all configured records including A, MX, CNAME, and TXT entries.

**How do I update the IP address of an existing A record?**
You can use the `update_record` tool. Provide the `zone_id`, `record_id`, and the new `value` (IP address). You can also optionally update the TTL at the same time.

**Does this server support creating both Master and Slave zones?**
Yes. The `create_zone` tool allows you to specify the `type` as either 'master' or 'slave' when adding a new domain to your account.

**How do I authenticate to manage my DNS using `list_zones`?**
You connect by providing your Cloud DNS Auth Key (API Key) during setup. Once authenticated, your AI client uses that key for all operations, letting you run tools like `list_zones` directly from chat or code.

**What is the process for completely removing a domain using `delete_zone`?**
The `delete_zone` tool handles full zone removal. Be careful, because deleting a zone immediately removes all associated records and its entire domain structure from your DNS configuration.

**I need to see every possible zone I manage; how do I use the `list_zones` function?**
`list_zones` retrieves a comprehensive list of every active DNS zone attached to your account. This is the perfect first step when you need an overview before running specific record management tasks.

**Can I use `create_record` for data types other than A or AAA records, like TXT?**
Yes. The `create_record` tool supports multiple resource types beyond just IP addresses, including CNAME and TXT records. This lets you manage domain verification or service pointers using non-IP data.

**If I try to run `update_record` on a record that has already been deleted, what happens?**
The system returns an error message indicating the specific resource was not found. This prevents accidental changes and allows your agent to immediately correct the workflow.