# Gandi.net MCP for AI Agents AI Agent Connect

> Gandi.net MCP for AI Agents. Manage your domains, DNS records, mailboxes, and hosting instances directly through your AI client. Skip the manual dashboard clicks and let your agent handle the heavy lifting of web infrastructure management.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_xTohXzFo3spzqa6ZRv0azj08VB13Aq9CStLhEtSB/ai-agent-connect
- **Tags:** domain-registration, dns-management, web-hosting, email-hosting, gandi-api

## Description

You can handle your entire web presence without opening a browser. If you need to see which domains are currently in your portfolio, just ask. If a client needs a new mailbox or a specific alias set up, your agent does it in seconds. It handles the tedious parts of infrastructure, like updating A records or checking if a specific URL is available for registration. You can even audit your organizations and billing entities to see how your assets are grouped. Because Vinkius hosts this Connector, you get a unified way to connect your Gandi.net account to any tool you already use, like Cursor or Claude. It turns a multi-tab management task into a single conversation. Instead of navigating deep menus to find a specific record, you can just describe the change you want to make. The agent handles the API calls and gives you a confirmation once the record is live. This is especially useful for developers who need to verify domain status or for IT admins who need to manage multiple accounts at once. You can keep your infrastructure organized and your records accurate without the usual manual overhead. Whether you are managing a dozen small sites or a massive corporate portfolio, you can get a clear picture of your hosting instances and DNS records in one go. It takes the friction out of routine maintenance so you can focus on your actual work.

## Tools

### list_domains
Show all domains currently registered in your account. This is the fastest way to see your full portfolio.

### check_domain
See if a specific domain name is available for new registration. Use this to verify names before you buy them.

### create_dns_record
Add a new DNS record to your domain's configuration. Use this to set up new A, CNAME, or TXT records.

### create_mailbox
Create a new mailbox for a specific domain. This is useful for quickly setting up user accounts.

### delete_dns_record
Remove an existing DNS record from your domain. Use this to clean up old entries.

### get_domain
Fetch the full metadata and details for a specific domain. It helps you see all registration info at once.

### get_organization
Retrieve the details of a specific organization. This is helpful for auditing account structures.

### list_aliases
Show all aliases associated with a specific mailbox. Use this to manage multiple email addresses for one user.

### list_dns_records
Display every DNS record currently active for a domain. It gives you a complete view of your routing.

### list_hosting_instances
Get a full list of your Simple Hosting instances. Use this to audit your active web deployments.

### list_mailboxes
Show all mailboxes registered for a given domain. This helps you manage your email users quickly.

### list_organizations
List all the organizations you belong to. This is great for viewing your high-level account structure.

### update_dns_record
Modify an existing DNS record with new values. This is the primary way to change your site's routing.

### get_hosting_instance
Pull the technical specs for a Simple Hosting instance. Use this to check your current hosting environment.

## Prompt Examples

**Prompt:** 
```
Are there any domains in my account that are currently active?
```

**Response:** 
```
I've checked your Gandi.net account. Here are the domains currently registered:

| Domain | Status |
| :--- | :--- |
| **example.com** | Active |
| **dev.net** | Active |
| **test-site.org** | Expired (Renew soon!) |

Would you like me to fetch more details on any of these?
```

**Prompt:** 
```
Can you check if 'new-startup-app.io' is available?
```

**Response:** 
```
Checking availability for **new-startup-app.io**...

Good news! That domain is currently **available** for registration. You can grab it whenever you're ready.
```

**Prompt:** 
```
Add an A record for 'blog.example.com' pointing to 1.2.3.4.
```

**Response:** 
```
I've updated the DNS configuration for **blog.example.com**. The new A record now points to **1.2.3.4**. Let me know if you need any other records changed.
```

## Capabilities

### Check domain availability
See if a name is free before you try to buy it.

### Edit DNS records
Add, remove, or change A, CNAME, and TXT records instantly.

### Create mailboxes
Set up new email accounts for your domains on the fly.

### View hosting stats
Get the technical details of your active hosting instances.

### Audit organizations
See which entities and billing accounts are linked to your profile.

## Use Cases

### Fixing a broken production site
A site goes down because of a wrong A record. You tell your agent to `update_dns_record` to point to the new IP immediately.

### Onboarding a new client
A client needs a new domain and three mailboxes. You use `check_domain` to verify the name and `create_mailbox` to set them up.

### Hosting audit
You need to know which hosting instances are active. You ask your agent to `list_hosting_instances` to get a clear summary.

### Organization cleanup
You're moving assets between departments. You use `list_organizations` and `get_organization` to map out your current setup.

## Benefits

- Stop manually clicking through the Gandi.net dashboard to find specific domain details using `get_domain`.
- Update your DNS records instantly with `create_dns_record` or `update_dns_record` without opening a new tab.
- Verify domain availability for new projects in seconds using `check_domain`.
- Manage your email infrastructure faster by creating mailboxes with `create_mailbox` and listing them with `list_mailboxes`.
- Keep your hosting status organized by pulling instance details with `get_hosting_instance`.
- Audit your entire account structure quickly using `list_organizations` and `list_domains`.

## How It Works

The bottom line is you get a chat-based interface for your entire Gandi.net infrastructure.

1. Subscribe to the Gandi.net MCP on the Vinkius Marketplace.
2. Paste your Gandi.net API Key (v5) into your client's configuration.
3. Ask your agent to list your domains or update a DNS record to see it work.

## Frequently Asked Questions

**Can I use the Gandi.net MCP to manage my email accounts?**
Yes. You can use it to list all mailboxes for a domain, create new ones, and manage aliases directly through your AI client.

**Does the Gandi.net MCP work for my existing hosting?**
It works specifically for your Gandi.net Simple Hosting instances. You can retrieve technical details or list all your active hosting records.

**How do I connect my Gandi.net account to my AI agent?**
You just need to subscribe to the Connector on Vinkius and provide your Gandi.net API Key (v5). Your agent will then have the permissions to manage your assets.

**Can I use the Gandi.net MCP to check if a domain name is taken?**
Yes, you can ask your agent to check the availability of any domain name, and it will let you know if it's free for registration.

**Is this Connector safe for my DNS records?**
It uses your official Gandi.net API Key to perform actions. You have full control over what the agent does, and it only interacts with the services you authorize.

**Can I manage multiple organizations with the Gandi.net MCP?**
Yes, the Connector allows you to list and retrieve details for the various organizations and billing entities associated with your account.

**Can I check if a domain is available for registration using this tool?**
Yes! Use the `check_domain` tool with the FQDN you're interested in. The agent will return the availability status directly from Gandi's registry.

**How do I update a DNS record for one of my domains?**
You can use the `update_dns_record` tool. You'll need to provide the domain (fqdn), the record name (like 'www'), the type (like 'A'), and the new record data in JSON format.

**Can I see my hosting instances and their status?**
Absolutely. Use the `list_hosting_instances` tool to get an overview of all your hosting services, or `get_hosting_instance` for detailed information on a specific one.