How to Use the Gandi.net (Domain Registration & Hosting API) MCP in Windsurf

Q: How do I configure the Gandi.net (Domain Registration & Hosting API) in Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file or use the Cascade UI. Add the server under the mcpServers block and click Refresh. Cascade will auto-discover the tools immediately.

Q: Can Windsurf and the Gandi.net (Domain Registration & Hosting API) check if a domain is available?

Yes. Cascade calls the checkdomain endpoint directly. It returns the exact registration status so your agent can decide whether to proceed with a purchase or try a different name.

Hand off domain management to Windsurf. Cascade checks availability, buys domains, and configures DNS records without asking for permission.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Gandi.net (Domain Registration & Hosting API) MCP to Windsurf

Create your Vinkius account to connect Gandi.net (Domain Registration & Hosting API) to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Gandi.net (Domain Registration & Hosting API) with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Windsurf MCP Server DNS Management

The Gandi.net MCP Server lets Cascade handle infrastructure provisioning on its own. You tell Windsurf to spin up a new staging environment, and it runs `list_domains` to find your base URL, then fires off `create_dns_record` to point the subdomain to your new IP address. It doesn't stop there. If the IP changes later, Cascade automatically executes `update_dns_record` to keep things running. You get to skip the Gandi dashboard entirely and just watch the terminal output while your agent does the heavy lifting.

Autonomous Email Setup

Setting up email aliases manually is a waste of time. When you onboard a new hire, your MCP-enabled Cascade grabs their details and immediately calls `create_mailbox` on your primary domain. It then uses `list_aliases` to confirm the routing works. Your agent chains these steps together in seconds, completely bypassing the clicking and waiting usually required to provision team communication channels.

Instant Infrastructure Audits

Keeping track of what you actually pay for is annoying. You can ask Cascade to audit your Gandi setup, and it pulls data using `list_hosting_instances` and `get_hosting_instance` to map out your active servers. It correlates that data by running `list_organizations` and `get_organization` so you know exactly which department owns what. Windsurf dumps a clean markdown report right in your editor, saving you from hunting through billing tabs.

Setup guide

Set up Gandi.net (Domain Registration & Hosting API) MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Gandi.net (Domain Registration & Hosting API) MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Gandi.net (Domain Registration & Hosting API) payment history." If connected, Cascade will call the Gandi.net (Domain Registration & Hosting API) tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "gandinet-domain-registration-hosting-api-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Gandi.net. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Gandi.net (Domain Registration & Hosting API) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Gandi.net (Domain Registration & Hosting API) MCP in Windsurf

Open your `~/.codeium/windsurf/mcp_config.json` file or use the Cascade UI. Add the server under the `mcpServers` block and click Refresh. Cascade will auto-discover the tools immediately.

Yes. Cascade calls the `check_domain` endpoint directly. It returns the exact registration status so your agent can decide whether to proceed with a purchase or try a different name.

It does. If you tell Cascade to tear down an old project, it runs `delete_dns_record` to clean up the stale A or CNAME records. Just be specific so it doesn't nuke your production routing.

Gandi throttles aggressive polling. Cascade might fail a bulk `list_dns_records` call if you ask it to dump hundreds of domains at once. Keep your prompts focused on specific domains to avoid lockouts.

Your zone files, A records, and mailbox aliases pass directly between Gandi and your local machine. Vinkius handles the auth token, but the actual payload never touches our servers. The connection is ephemeral and strictly zero-trust.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript