Gandi

Provides a MCP server to manage Gandi domains and LiveDNS records via the Gandi API v5.

typescript

0

GitHub Stars

typescript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "globodai-group-mcp-gandi": {
      "command": "npx",
      "args": [
        "@artik0din/mcp-gandi"
      ],
      "env": {
        "GANDI_API_TOKEN": "YOUR_GANDI_API_TOKEN"
      }
    }
  }
}

You can manage Gandi domains and LiveDNS records directly through a dedicated MCP server that communicates with Gandi API v5. This server enables your AI assistants and automation workflows to list domains, inspect details, check availability, manage domain contacts, and perform full DNS record CRUD operations with robust filtering, TTL controls, and safe error handling.

How to use

Use an MCP client to connect to the Gandi MCP Server and perform domain and DNS operations through the available tools. You can run the server locally or via an MCP-enabled client, then issue commands to list domains, get domain details, check availability, manage contacts, and manage DNS records (create, read, update, delete) with support for common record types and TTL settings.

How to install

# Prerequisites: Node.js 18+

# Install the MCP server globally via npm (example path shown in quick start)
npm install -g @artik0din/mcp-gandi

# Run the MCP server (start the server)
mcp-gandi

Or run directly with npx for a quick start (no global install required):

npx @artik0din/mcp-gandi

If you prefer to run from a local setup after cloning the project, install dependencies, build, and run as described below.

## Configuration and security

Configure access by supplying your Gandi API token as an environment variable. The server requires this token to manage domains and LiveDNS records. Use a dedicated token with only the permissions you need and rotate it regularly. Always pass credentials via environment variables and avoid embedding them in code or configuration files.

## Notes

The server is designed to work with Gandi API v5 for both Domain API operations and LiveDNS DNS record management. Ensure you understand your DNS changes impact production environments, especially when deleting or updating records. Validate inputs to prevent unintended modifications.

## Available tools

### gandi\_domains\_list

List all domains in your Gandi account.

### gandi\_domains\_get

Get detailed information about a specific domain.

### gandi\_domains\_check

Check if a domain name is available for registration.

### gandi\_domains\_contacts

List contacts associated with a domain.

### gandi\_dns\_records\_list

List all DNS records for a domain, with optional type filtering.

### gandi\_dns\_record\_get

Get a specific DNS record by name and type.

### gandi\_dns\_record\_create

Create a new DNS record with specified name, type, values, and optional TTL.

### gandi\_dns\_record\_update

Update an existing DNS record with new values and TTL.

### gandi\_dns\_record\_delete

Delete a DNS record by name and type.