# Gandi.net API MCP

> Gandi.net (Domain Registration & Hosting API) MCP connects your AI agent directly to Gandi.net for full domain and hosting management. List domains, check availability, configure DNS records, manage mailboxes, and monitor web hosting instances—all from natural language prompts.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** domain-registration, dns-management, web-hosting, email-hosting, gandi-api

## Description

This connection lets you handle all things related to your online presence without opening a browser or logging into an admin panel. You can use your AI agent to list every domain you own, check if 'new-cool-site.net' is available right now, and even create entire mailboxes for new employees across multiple domains. If you need to update where a domain points, the MCP lets you modify DNS records (like A or CNAME) directly from your chat window. Need to know what hosting resources are running? You can pull up technical details on existing web deployments, too. When using Vinkius, you get access to this entire catalog alongside hundreds of other developer tools, keeping all your infrastructure management in one place.

## Tools

### check_domain
Checks if a domain name is available to be registered right now.

### create_dns_record
Adds a brand new DNS record (like A or TXT) to an existing domain's records.

### create_mailbox
Sets up a new email account for a specific domain.

### delete_dns_record
Removes an existing DNS record from the records list.

### get_domain
Retrieves all detailed metadata for a specific domain name you own.

### get_hosting_instance
Gets technical details and status information for a specified web hosting setup.

### get_organization
Fetches detailed information about an organizational unit associated with your account.

### list_aliases
Lists all alternative email addresses (aliases) attached to a specific mailbox.

### list_dns_records
Shows every existing DNS record type and value for a given domain.

### list_domains
Retrieves a list of all domains registered under your Gandi account.

### list_hosting_instances
Lists every web hosting instance configured in your account.

### list_mailboxes
Retrieves a list of all created mailboxes for a particular domain.

### list_organizations
Shows every organization you are currently a member of.

### update_dns_record
Modifies the value or type of an existing DNS record without deleting it first.

## Prompt Examples

**Prompt:** 
```
List all domains in my Gandi account.
```

**Response:** 
```
I've retrieved your domain list. You have 3 domains: 'example.com', 'my-portfolio.net', and 'dev-site.org'. Would you like more details on any of these?
```

**Prompt:** 
```
Check if 'cool-new-app.io' is available for registration.
```

**Response:** 
```
Checking availability for 'cool-new-app.io'... Good news! The domain is currently available for registration. Would you like to know the next steps?
```

**Prompt:** 
```
Show me the DNS records for 'example.com'.
```

**Response:** 
```
Fetching DNS records for 'example.com'... I found 4 records: an A record pointing to 93.184.216.34, two MX records for mail, and a TXT record for verification. Do you need to modify any of these?
```

## Capabilities

### Check domain availability
Verifies if a specific domain name is available for registration.

### Manage DNS records
Creates, updates, or deletes all types of DNS records (A, TXT, CNAME) for any registered domain.

### Create and list mailboxes
Sets up new email accounts or checks which addresses are available under a specific domain.

### List owned domains
Retrieves a full list of all domains associated with your Gandi account.

### View hosting status
Gets current technical details and monitoring data for your web hosting instances.

## Use Cases

### A client needs a new domain, but you don't know if it's free.
Instead of manually checking the Gandi website, your agent runs `check_domain('newclientcorp.com')`. It gets an immediate 'available' response, letting you start the setup process instantly.

### The main site is pointing to old IP addresses after a migration.
You instruct your agent: 'Update the A record for example.com to 192.0.2.1.' The MCP uses `update_dns_record` and confirms the change, preventing downtime.

### A new employee needs an email address under a newly acquired domain.
Your agent first runs `list_domains` to confirm ownership of the domain. Then it executes `create_mailbox('john@newdomain.com')`, handling both discovery and provisioning in sequence.

### You need a full list of all owned assets for an audit report.
Your agent runs `list_domains` to get the domain list, then uses `list_hosting_instances` to cross-reference active web deployments against billing records.

## Benefits

- Verify domain availability instantly: Use `check_domain` to see if a new TLD is open for registration without switching tabs or running command-line queries.
- Full control over routing: You can modify records by using `create_dns_record`, `update_dns_record`, or `delete_dns_record`, ensuring your site always points to the right place, all from natural language.
- Simplify email setup: Need a new address? Use `list_mailboxes` and then `create_mailbox` to provision accounts across multiple domains without manual steps.
- Audit infrastructure quickly: Instead of manually reviewing dashboards, you can use `list_domains` and then `get_organization` to audit your entire digital portfolio in seconds.
- Monitor web deployments on the fly: Use `list_hosting_instances` and `get_hosting_instance` to get technical status reports when debugging or planning maintenance.

## How It Works

The bottom line is you manage your entire web infrastructure by talking to it, not by clicking buttons in a dashboard.

1. Subscribe to this MCP and provide your Gandi.net API key (v5) credentials.
2. Use a natural language prompt in your AI client, like 'List all my domains' or 'Create an A record for example.com'.
3. The MCP executes the command against Gandi.net and returns structured data detailing the status or confirming the action.

## Frequently Asked Questions

**How do I update DNS records using the Gandi.net API MCP?**
You use `update_dns_record`. First, you should run `list_dns_records` to verify the existing record details; this prevents accidental overwrites.

**Can I list all my domains using the Gandi.net API MCP?**
Yep, just prompt your agent to use `list_domains`. It pulls every domain registered under your account for review.

**What if I need to create a whole new email system?**
You can list existing accounts with `list_mailboxes`, and then provision new ones using `create_mailbox` across multiple domains in sequence.

**Is this MCP only for DNS changes?**
No. It handles much more than just records. You can also manage web hosting instances with tools like `list_hosting_instances` and check organization details using `get_organization`.

**What information is needed to run the `get_domain` command?**
You need a valid Gandi API Key and the specific domain name you want details for. The agent handles the secure authentication once your credentials are set up in Vinkius, allowing you to query any associated data immediately.

**If I run `update_dns_record`, how does the MCP handle errors or conflicts?**
The agent reports specific error codes and messages provided by the Gandi API. If a record already exists or if your credentials lack permission, it tells you exactly what went wrong instead of just failing silently.

**How do I access information about different legal entities using `list_organizations`?**
The MCP first retrieves all organizations linked to your account. After listing them, you use the returned organization ID to scope further actions, like auditing domain portfolios or checking billing details for that specific entity.

**When using `list_domains`, does the MCP support bulk or pagination for large accounts?**
Yes. The agent is designed to handle high volumes of data. It automatically manages pagination, ensuring you receive every single domain record associated with your account without timing out.

**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.