@themkn/gandi-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mkn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,121 @@
+# gandi-mcp — Gandi LiveDNS MCP Server
+
+[![npm](https://img.shields.io/npm/v/@themkn/gandi-mcp)](https://www.npmjs.com/package/@themkn/gandi-mcp)
+[![license](https://img.shields.io/npm/l/@themkn/gandi-mcp)](./LICENSE)
+
+An [MCP server](https://modelcontextprotocol.io) for [Gandi LiveDNS](https://api.gandi.net/docs/livedns/). Manage DNS records, list domains, and take zone snapshots — directly from [Claude Code](https://docs.anthropic.com/en/docs/claude-code) or any MCP-compatible client.
+
+## What this gives you
+
+- **8 MCP tools:** `list_domains`, `list_records`, `get_record`, `add_record`, `update_record`, `delete_record`, `list_snapshots`, `create_snapshot`
+- **Safety by default:** every `add`/`update`/`delete` writes a timestamped local JSON backup of the full zone **before** mutating. Configurable.
+- **One-JSON config:** no env vars, one file with strict `0600` perms
+
+## Prerequisites
+
+- **A Gandi account** with a [Personal Access Token](https://admin.gandi.net/) (*Account → Security → Personal Access Tokens*) with LiveDNS access
+- **Node.js 24+**
+
+## Install
+
+```sh
+npm install -g @themkn/gandi-mcp
+```
+
+The binary is `gandi-mcp` regardless of the scoped package name.
+
+## Configure
+
+The server reads a JSON config from `~/.gandi-mcp/config.json`. Create it with `0600`:
+
+```sh
+mkdir -p ~/.gandi-mcp
+chmod 700 ~/.gandi-mcp
+cat > ~/.gandi-mcp/config.json <<'EOF'
+{
+  "apiKey": "YOUR_GANDI_PAT",
+  "defaultDomain": "example.com"
+}
+EOF
+chmod 600 ~/.gandi-mcp/config.json
+```
+
+### Full config reference
+
+| Field | Required | Default | Description |
+|-------|----------|---------|-------------|
+| `apiKey` | yes | — | Your Gandi Personal Access Token |
+| `defaultDomain` | no | none | Used when a tool call omits `domain` |
+| `autoBackup` | no | `true` | Write local zone backup before each mutation |
+| `backupDir` | no | `~/.gandi-mcp/backups` | Where backup files land |
+
+The server refuses to start if the config file is group- or world-readable.
+
+## Hook into Claude Code
+
+Add this to your `.mcp.json` (project-scoped) or `~/.config/claude/mcp.json` (global):
+
+```json
+{
+  "mcpServers": {
+    "gandi": {
+      "command": "gandi-mcp"
+    }
+  }
+}
+```
+
+### Auto-approve tools
+
+By default Claude Code prompts on every tool call. To allow all `gandi-mcp` tools without prompting, add to `~/.claude/settings.json`:
+
+```json
+{
+  "permissions": {
+    "allow": ["mcp__gandi__*"]
+  }
+}
+```
+
+## Tool reference
+
+| Tool | What it does |
+|------|--------------|
+| `list_domains` | List all domains on your Gandi account |
+| `list_records` | List records for a domain, with optional `type` and `nameFilter` (anchored, case-insensitive glob — `*` = any, `?` = one) |
+| `get_record` | Fetch a single record by name + type |
+| `add_record` | Add a new record; auto-backup runs first |
+| `update_record` | Replace values/TTL on an existing record; auto-backup runs first |
+| `delete_record` | Delete a record; auto-backup runs first |
+| `list_snapshots` | List Gandi server-side zone snapshots |
+| `create_snapshot` | Create a server-side zone snapshot on Gandi |
+
+Mutation tools return the local backup path in their response — reference it if you need to roll back manually.
+
+## Backups
+
+Each mutation writes `~/.gandi-mcp/backups/<domain>-<timestamp>.json`:
+
+```json
+{
+  "domain": "example.com",
+  "date": "2026-04-24T11:47:03.123Z",
+  "records": [ /* full zone */ ]
+}
+```
+
+Format matches the `gandi` CLI's backup shape. Disable via `"autoBackup": false` in config.
+
+## Development
+
+```sh
+git clone git@github.com:themkn/gandi-mcp.git
+cd gandi-mcp
+pnpm install
+pnpm test
+pnpm build
+```
+
+## License
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,12 @@
+import { z } from "zod";
+export declare const DEFAULT_CONFIG_PATH: string;
+declare const ConfigSchema: z.ZodObject<{
+    apiKey: z.ZodString;
+    defaultDomain: z.ZodOptional<z.ZodString>;
+    autoBackup: z.ZodDefault<z.ZodBoolean>;
+    backupDir: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type Config = z.infer<typeof ConfigSchema>;
+export declare function loadConfig(path?: string): Config;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB,QAA+C,CAAC;AAEhF,QAAA,MAAM,YAAY;;;;;iBAKhB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,wBAAgB,UAAU,CAAC,IAAI,GAAE,MAA4B,GAAG,MAAM,CA2CrE"}

package/dist/config.js

@@ -0,0 +1,51 @@
+import { readFileSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { z } from "zod";
+export const DEFAULT_CONFIG_PATH = join(homedir(), ".gandi-mcp", "config.json");
+const ConfigSchema = z.object({
+    apiKey: z.string().min(1, "apiKey must be a non-empty string"),
+    defaultDomain: z.string().min(1).optional(),
+    autoBackup: z.boolean().default(true),
+    backupDir: z.string().min(1).default(join(homedir(), ".gandi-mcp", "backups")),
+});
+export function loadConfig(path = DEFAULT_CONFIG_PATH) {
+    let stat;
+    try {
+        stat = statSync(path);
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            throw new Error(`Config not found at ${path}. Create it with mode 0600, e.g.\n` +
+                `  mkdir -p ~/.gandi-mcp && chmod 700 ~/.gandi-mcp\n` +
+                `  echo '{"apiKey":"...","defaultDomain":"example.com"}' > ${path}\n` +
+                `  chmod 600 ${path}`);
+        }
+        throw err;
+    }
+    if ((stat.mode & 0o077) !== 0) {
+        const current = (stat.mode & 0o777).toString(8);
+        throw new Error(`Config file ${path} has insecure permission ${current}. Run: chmod 600 ${path}`);
+    }
+    let raw;
+    try {
+        raw = readFileSync(path, "utf8");
+    }
+    catch (err) {
+        throw new Error(`Unable to read ${path}: ${err.message}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`Failed to parse ${path}: ${err.message}`);
+    }
+    const result = ConfigSchema.safeParse(parsed);
+    if (!result.success) {
+        const msg = result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ");
+        throw new Error(`Invalid config (${path}): ${msg}`);
+    }
+    return result.data;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/gandi/backup.d.ts

@@ -0,0 +1,3 @@
+import type { DnsRecord } from "./types.js";
+export declare function writeLocalBackup(domain: string, records: readonly DnsRecord[], dir: string): Promise<string>;
+//# sourceMappingURL=backup.d.ts.map

package/dist/gandi/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/gandi/backup.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAqB5C,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,SAAS,SAAS,EAAE,EAC7B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,CAoBjB"}

package/dist/gandi/backup.js

@@ -0,0 +1,38 @@
+import { mkdir, writeFile, chmod } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+function expandTilde(p) {
+    if (p === "~")
+        return homedir();
+    if (p.startsWith("~/"))
+        return join(homedir(), p.slice(2));
+    return p;
+}
+function assertSafeDomain(domain) {
+    if (domain.includes("/") ||
+        domain.includes("\\") ||
+        domain.split(/[/\\]/).includes("..") ||
+        domain.includes("\0") ||
+        domain === "." ||
+        domain === "..") {
+        throw new Error(`Refusing to write backup: invalid domain "${domain}"`);
+    }
+}
+export async function writeLocalBackup(domain, records, dir) {
+    assertSafeDomain(domain);
+    const resolvedDir = expandTilde(dir);
+    await mkdir(resolvedDir, { recursive: true, mode: 0o700 });
+    const iso = new Date().toISOString(); // 2026-04-24T11:47:03.123Z
+    const safeIso = iso.replace(/[:.]/g, "-");
+    const filename = `${domain}-${safeIso}.json`;
+    const fullPath = join(resolvedDir, filename);
+    const payload = {
+        domain,
+        date: iso,
+        records,
+    };
+    await writeFile(fullPath, JSON.stringify(payload, null, 2), { mode: 0o600 });
+    await chmod(fullPath, 0o600);
+    return fullPath;
+}
+//# sourceMappingURL=backup.js.map

package/dist/gandi/backup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.js","sourceRoot":"","sources":["../../src/gandi/backup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,SAAS,WAAW,CAAC,CAAS;IAC5B,IAAI,CAAC,KAAK,GAAG;QAAE,OAAO,OAAO,EAAE,CAAC;IAChC,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAc;IACtC,IACE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QACpB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QACrB,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QACpC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QACrB,MAAM,KAAK,GAAG;QACd,MAAM,KAAK,IAAI,EACf,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,6CAA6C,MAAM,GAAG,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAc,EACd,OAA6B,EAC7B,GAAW;IAEX,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IACrC,MAAM,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAE3D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,2BAA2B;IACjE,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,GAAG,MAAM,IAAI,OAAO,OAAO,CAAC;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAE7C,MAAM,OAAO,GAAG;QACd,MAAM;QACN,IAAI,EAAE,GAAG;QACT,OAAO;KACR,CAAC;IAEF,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7E,MAAM,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAE7B,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/gandi/client.d.ts

@@ -0,0 +1,15 @@
+import type { DnsRecord, Domain, RecordInput, Snapshot } from "./types.js";
+export declare class GandiClient {
+    private readonly token;
+    constructor(token: string);
+    private request;
+    listDomains(): Promise<Domain[]>;
+    listRecords(domain: string): Promise<DnsRecord[]>;
+    getRecord(domain: string, name: string, type: string): Promise<DnsRecord>;
+    addRecord(domain: string, input: RecordInput): Promise<void>;
+    updateRecord(domain: string, input: RecordInput): Promise<void>;
+    deleteRecord(domain: string, name: string, type: string): Promise<void>;
+    listSnapshots(domain: string): Promise<Snapshot[]>;
+    createSnapshot(domain: string, name?: string): Promise<Snapshot>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/gandi/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/gandi/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAK3E,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,MAAM;YAE5B,OAAO;IA8Bf,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIhC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAIjD,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAMzE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAY5D,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAa/D,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvE,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAIlD,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;CAKvE"}

package/dist/gandi/client.js

@@ -0,0 +1,79 @@
+import { GandiError } from "./errors.js";
+const BASE_URL = "https://api.gandi.net/v5/livedns";
+export class GandiClient {
+    token;
+    constructor(token) {
+        this.token = token;
+    }
+    async request(path, options = {}) {
+        const response = await fetch(`${BASE_URL}${path}`, {
+            ...options,
+            headers: {
+                Authorization: `Bearer ${this.token}`,
+                "Content-Type": "application/json",
+                ...(options.headers ?? {}),
+            },
+        });
+        if (!response.ok) {
+            let detail = response.statusText;
+            try {
+                const body = (await response.json());
+                if (body.message)
+                    detail = body.message;
+            }
+            catch {
+                // body not JSON — keep statusText
+            }
+            throw new GandiError(response.status, detail);
+        }
+        if (response.status === 204 || response.headers.get("content-length") === "0") {
+            return undefined;
+        }
+        const text = await response.text();
+        if (!text)
+            return undefined;
+        return JSON.parse(text);
+    }
+    async listDomains() {
+        return this.request("/domains");
+    }
+    async listRecords(domain) {
+        return this.request(`/domains/${encodeURIComponent(domain)}/records`);
+    }
+    async getRecord(domain, name, type) {
+        return this.request(`/domains/${encodeURIComponent(domain)}/records/${encodeURIComponent(name)}/${encodeURIComponent(type)}`);
+    }
+    async addRecord(domain, input) {
+        await this.request(`/domains/${encodeURIComponent(domain)}/records`, {
+            method: "POST",
+            body: JSON.stringify({
+                rrset_name: input.name,
+                rrset_type: input.type,
+                rrset_values: input.values,
+                rrset_ttl: input.ttl ?? 300,
+            }),
+        });
+    }
+    async updateRecord(domain, input) {
+        await this.request(`/domains/${encodeURIComponent(domain)}/records/${encodeURIComponent(input.name)}/${encodeURIComponent(input.type)}`, {
+            method: "PUT",
+            body: JSON.stringify({
+                rrset_values: input.values,
+                rrset_ttl: input.ttl ?? 300,
+            }),
+        });
+    }
+    async deleteRecord(domain, name, type) {
+        await this.request(`/domains/${encodeURIComponent(domain)}/records/${encodeURIComponent(name)}/${encodeURIComponent(type)}`, { method: "DELETE" });
+    }
+    async listSnapshots(domain) {
+        return this.request(`/domains/${encodeURIComponent(domain)}/snapshots`);
+    }
+    async createSnapshot(domain, name) {
+        const init = { method: "POST" };
+        if (name !== undefined)
+            init.body = JSON.stringify({ name });
+        return this.request(`/domains/${encodeURIComponent(domain)}/snapshots`, init);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/gandi/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/gandi/client.ts"],"names":[],"mappings":"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"}

package/dist/gandi/errors.d.ts

@@ -0,0 +1,7 @@
+export declare class GandiError extends Error {
+    readonly status: number;
+    readonly detail: string;
+    constructor(status: number, detail: string);
+    toUserMessage(): string;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/gandi/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/gandi/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAW,SAAQ,KAAK;aAEjB,MAAM,EAAE,MAAM;aACd,MAAM,EAAE,MAAM;gBADd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM;IAOhC,aAAa,IAAI,MAAM;CAmBxB"}

package/dist/gandi/errors.js

@@ -0,0 +1,31 @@
+export class GandiError extends Error {
+    status;
+    detail;
+    constructor(status, detail) {
+        super(`Gandi API error ${status}: ${detail}`);
+        this.status = status;
+        this.detail = detail;
+        this.name = "GandiError";
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    toUserMessage() {
+        switch (this.status) {
+            case 401:
+                return "Gandi rejected the API key. Regenerate at admin.gandi.net and update ~/.gandi-mcp/config.json.";
+            case 403:
+                return "Your Gandi PAT lacks permission for this operation.";
+            case 404:
+                return `Not found: ${this.detail} — check domain/name/type are correct.`;
+            case 409:
+                return this.detail;
+            case 429:
+                return "Rate limited by Gandi. Retry in a moment.";
+            default:
+                if (this.status >= 500 && this.status < 600) {
+                    return `Gandi server error (${this.status}). Try again.`;
+                }
+                return this.detail;
+        }
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/gandi/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/gandi/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,UAAW,SAAQ,KAAK;IAEjB;IACA;IAFlB,YACkB,MAAc,EACd,MAAc;QAE9B,KAAK,CAAC,mBAAmB,MAAM,KAAK,MAAM,EAAE,CAAC,CAAC;QAH9B,WAAM,GAAN,MAAM,CAAQ;QACd,WAAM,GAAN,MAAM,CAAQ;QAG9B,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAED,aAAa;QACX,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;YACpB,KAAK,GAAG;gBACN,OAAO,gGAAgG,CAAC;YAC1G,KAAK,GAAG;gBACN,OAAO,qDAAqD,CAAC;YAC/D,KAAK,GAAG;gBACN,OAAO,cAAc,IAAI,CAAC,MAAM,wCAAwC,CAAC;YAC3E,KAAK,GAAG;gBACN,OAAO,IAAI,CAAC,MAAM,CAAC;YACrB,KAAK,GAAG;gBACN,OAAO,2CAA2C,CAAC;YACrD;gBACE,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;oBAC5C,OAAO,uBAAuB,IAAI,CAAC,MAAM,eAAe,CAAC;gBAC3D,CAAC;gBACD,OAAO,IAAI,CAAC,MAAM,CAAC;QACvB,CAAC;IACH,CAAC;CACF"}

package/dist/gandi/types.d.ts

@@ -0,0 +1,23 @@
+export interface DnsRecord {
+    readonly rrset_name: string;
+    readonly rrset_type: string;
+    readonly rrset_values: readonly string[];
+    readonly rrset_ttl: number;
+    readonly rrset_href?: string;
+}
+export interface Domain {
+    readonly fqdn: string;
+}
+export interface Snapshot {
+    readonly id: string;
+    readonly name?: string;
+    readonly created_at: string;
+    readonly automatic?: boolean;
+}
+export interface RecordInput {
+    readonly name: string;
+    readonly type: string;
+    readonly values: readonly string[];
+    readonly ttl?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/gandi/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/gandi/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/gandi/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/gandi/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/gandi/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+import { loadConfig } from "./config.js";
+import { GandiClient } from "./gandi/client.js";
+import { runServer } from "./server.js";
+import { domainTools } from "./tools/domains.js";
+import { recordTools } from "./tools/records.js";
+import { snapshotTools } from "./tools/snapshots.js";
+async function main() {
+    const config = loadConfig();
+    const client = new GandiClient(config.apiKey);
+    const tools = [
+        ...domainTools,
+        ...recordTools,
+        ...snapshotTools,
+    ];
+    await runServer({ config, client, tools });
+}
+main().catch((err) => {
+    process.stderr.write(`gandi-mcp: ${err.message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAuB,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAE9C,MAAM,KAAK,GAA8B;QACvC,GAAG,WAAW;QACd,GAAG,WAAW;QACd,GAAG,aAAa;KACjB,CAAC;IAEF,MAAM,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAU,EAAE,EAAE;IAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,22 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { type ZodTypeAny } from "zod";
+import { GandiClient } from "./gandi/client.js";
+import type { Config } from "./config.js";
+export interface ToolDefinition<Input> {
+    name: string;
+    description: string;
+    schema: ZodTypeAny;
+    handler: (input: Input, ctx: ToolContext) => Promise<unknown>;
+}
+export interface ToolContext {
+    client: GandiClient;
+    config: Config;
+}
+export interface ServerBootstrap {
+    config: Config;
+    client: GandiClient;
+    tools: ToolDefinition<unknown>[];
+}
+export declare function buildServer(bootstrap: ServerBootstrap): Server;
+export declare function runServer(bootstrap: ServerBootstrap): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAOnE,OAAO,EAAK,KAAK,UAAU,EAAE,MAAM,KAAK,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,cAAc,CAAC,KAAK;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;CAClC;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,eAAe,GAAG,MAAM,CA4C9D;AAED,wBAAsB,SAAS,CAAC,SAAS,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAIzE"}

package/dist/server.js

@@ -0,0 +1,52 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import { GandiError } from "./gandi/errors.js";
+export function buildServer(bootstrap) {
+    const { config, client, tools } = bootstrap;
+    const byName = new Map(tools.map((t) => [t.name, t]));
+    const ctx = { client, config };
+    const mcp = new Server({ name: "gandi-mcp", version: "0.1.0" }, { capabilities: { tools: {} } });
+    mcp.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: tools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: toInputSchema(t.schema),
+        })),
+    }));
+    mcp.setRequestHandler(CallToolRequestSchema, async (req) => {
+        const tool = byName.get(req.params.name);
+        if (!tool) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Unknown tool: ${req.params.name}` }],
+            };
+        }
+        const parsed = tool.schema.safeParse(req.params.arguments ?? {});
+        if (!parsed.success) {
+            const msg = parsed.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ");
+            return { isError: true, content: [{ type: "text", text: `Invalid input: ${msg}` }] };
+        }
+        try {
+            const result = await tool.handler(parsed.data, ctx);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (err) {
+            const text = err instanceof GandiError
+                ? err.toUserMessage()
+                : `Unexpected error: ${err.message}`;
+            return { isError: true, content: [{ type: "text", text }] };
+        }
+    });
+    return mcp;
+}
+export async function runServer(bootstrap) {
+    const server = buildServer(bootstrap);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+function toInputSchema(schema) {
+    return z.toJSONSchema(schema, { target: "draft-7" });
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools/domains.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "../server.js";
+export declare const domainTools: ToolDefinition<unknown>[];
+//# sourceMappingURL=domains.d.ts.map

package/dist/tools/domains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domains.d.ts","sourceRoot":"","sources":["../../src/tools/domains.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAInD,eAAO,MAAM,WAAW,EAAE,cAAc,CAAC,OAAO,CAAC,EAShD,CAAC"}

package/dist/tools/domains.js

@@ -0,0 +1,13 @@
+import { z } from "zod";
+const ListDomainsInput = z.object({}).strict();
+export const domainTools = [
+    {
+        name: "list_domains",
+        description: "List all domains on this Gandi account.",
+        schema: ListDomainsInput,
+        handler: async (_input, ctx) => {
+            return ctx.client.listDomains();
+        },
+    },
+];
+//# sourceMappingURL=domains.js.map

package/dist/tools/domains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domains.js","sourceRoot":"","sources":["../../src/tools/domains.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAE/C,MAAM,CAAC,MAAM,WAAW,GAA8B;IACpD;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,yCAAyC;QACtD,MAAM,EAAE,gBAAgB;QACxB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;YAC7B,OAAO,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAClC,CAAC;KACF;CACF,CAAC"}

package/dist/tools/records.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "../server.js";
+export declare const recordTools: ToolDefinition<unknown>[];
+//# sourceMappingURL=records.d.ts.map

package/dist/tools/records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../../src/tools/records.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,cAAc,CAAC;AAmDhE,eAAO,MAAM,WAAW,EAAE,cAAc,CAAC,OAAO,CAAC,EAkFhD,CAAC"}

package/dist/tools/records.js

@@ -0,0 +1,122 @@
+import { z } from "zod";
+import { writeLocalBackup } from "../gandi/backup.js";
+const DomainRef = z.string().min(1).optional();
+const NameStr = z.string().min(1);
+const TypeStr = z.string().min(1);
+const ValuesArr = z.array(z.string().min(1)).min(1);
+const TtlNum = z.number().int().positive().optional();
+const TtlMutation = z.number().int().positive().default(300);
+const ListInput = z
+    .object({
+    domain: DomainRef,
+    type: z.string().min(1).optional(),
+    nameFilter: z.string().min(1).optional(),
+})
+    .strict();
+const GetInput = z.object({ domain: DomainRef, name: NameStr, type: TypeStr }).strict();
+const AddInput = z
+    .object({ domain: DomainRef, name: NameStr, type: TypeStr, values: ValuesArr, ttl: TtlMutation })
+    .strict();
+const UpdateInput = z
+    .object({ domain: DomainRef, name: NameStr, type: TypeStr, values: ValuesArr, ttl: TtlMutation })
+    .strict();
+const DeleteInput = z.object({ domain: DomainRef, name: NameStr, type: TypeStr }).strict();
+function resolveDomain(input, ctx) {
+    const d = input.domain ?? ctx.config.defaultDomain;
+    if (!d) {
+        throw new Error("No domain provided and no `defaultDomain` in config. Pass `domain` explicitly or set one in ~/.gandi-mcp/config.json.");
+    }
+    return d;
+}
+function globToRegex(pattern) {
+    const escaped = pattern
+        .replace(/[.+^${}()|[\]\\]/g, "\\$&")
+        .replace(/\*/g, ".*")
+        .replace(/\?/g, ".");
+    return new RegExp(`^${escaped}$`, "i");
+}
+async function backupIfEnabled(ctx, domain) {
+    if (!ctx.config.autoBackup)
+        return null;
+    const records = await ctx.client.listRecords(domain);
+    return writeLocalBackup(domain, records, ctx.config.backupDir);
+}
+export const recordTools = [
+    {
+        name: "list_records",
+        description: "List DNS records for a domain. Optionally filter by `type` (A, CNAME, MX, TXT, ...) and `nameFilter` (anchored, case-insensitive glob: `*` = any chars, `?` = one char).",
+        schema: ListInput,
+        handler: async (input, ctx) => {
+            const i = input;
+            const domain = resolveDomain(i, ctx);
+            let records = await ctx.client.listRecords(domain);
+            if (i.type) {
+                const t = i.type.toUpperCase();
+                records = records.filter((r) => r.rrset_type.toUpperCase() === t);
+            }
+            if (i.nameFilter) {
+                const re = globToRegex(i.nameFilter);
+                records = records.filter((r) => re.test(r.rrset_name));
+            }
+            return records;
+        },
+    },
+    {
+        name: "get_record",
+        description: "Fetch a single DNS record by name and type. Throws if no record with that name and type exists — use `list_records` first if you're unsure what exists.",
+        schema: GetInput,
+        handler: async (input, ctx) => {
+            const i = input;
+            return ctx.client.getRecord(resolveDomain(i, ctx), i.name, i.type);
+        },
+    },
+    {
+        name: "add_record",
+        description: "Add a new DNS record. A local JSON backup of the full zone is written first (configurable). Verifies by re-fetching the record.",
+        schema: AddInput,
+        handler: async (input, ctx) => {
+            const i = AddInput.parse(input);
+            const domain = resolveDomain(i, ctx);
+            const backup = await backupIfEnabled(ctx, domain);
+            await ctx.client.addRecord(domain, {
+                name: i.name,
+                type: i.type,
+                values: i.values,
+                ttl: i.ttl,
+            });
+            const record = await ctx.client.getRecord(domain, i.name, i.type);
+            return { backup, record };
+        },
+    },
+    {
+        name: "update_record",
+        description: "Replace values and/or TTL for an existing record. A local JSON backup of the full zone is written first (configurable). Verifies by re-fetching.",
+        schema: UpdateInput,
+        handler: async (input, ctx) => {
+            const i = UpdateInput.parse(input);
+            const domain = resolveDomain(i, ctx);
+            const backup = await backupIfEnabled(ctx, domain);
+            await ctx.client.updateRecord(domain, {
+                name: i.name,
+                type: i.type,
+                values: i.values,
+                ttl: i.ttl,
+            });
+            const record = await ctx.client.getRecord(domain, i.name, i.type);
+            return { backup, record };
+        },
+    },
+    {
+        name: "delete_record",
+        description: "Delete a DNS record. Irreversible. A local JSON backup of the full zone is written first (configurable).",
+        schema: DeleteInput,
+        handler: async (input, ctx) => {
+            const i = input;
+            const domain = resolveDomain(i, ctx);
+            const backup = await backupIfEnabled(ctx, domain);
+            await ctx.client.deleteRecord(domain, i.name, i.type);
+            return { backup, deleted: { name: i.name, type: i.type } };
+        },
+    },
+];
+//# sourceMappingURL=records.js.map

package/dist/tools/records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.js","sourceRoot":"","sources":["../../src/tools/records.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;AAC/C,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAClC,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAClC,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACpD,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC;AACtD,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AAE7D,MAAM,SAAS,GAAG,CAAC;KAChB,MAAM,CAAC;IACN,MAAM,EAAE,SAAS;IACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAClC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACzC,CAAC;KACD,MAAM,EAAE,CAAC;AACZ,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AACxF,MAAM,QAAQ,GAAG,CAAC;KACf,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC;KAChG,MAAM,EAAE,CAAC;AACZ,MAAM,WAAW,GAAG,CAAC;KAClB,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC;KAChG,MAAM,EAAE,CAAC;AACZ,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAE3F,SAAS,aAAa,CAAC,KAA0B,EAAE,GAAgB;IACjE,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC;IACnD,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,IAAI,KAAK,CACb,uHAAuH,CACxH,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,MAAM,OAAO,GAAG,OAAO;SACpB,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC;SACpC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvB,OAAO,IAAI,MAAM,CAAC,IAAI,OAAO,GAAG,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,GAAgB,EAAE,MAAc;IAC7D,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IACxC,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACrD,OAAO,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAA8B;IACpD;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,0KAA0K;QAC5K,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC5B,MAAM,CAAC,GAAG,KAAkC,CAAC;YAC7C,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACrC,IAAI,OAAO,GAAyB,MAAM,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACzE,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;gBACX,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC/B,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;YACpE,CAAC;YACD,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;gBACjB,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;gBACrC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;YACzD,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;KACF;IACD;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,yJAAyJ;QAC3J,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC5B,MAAM,CAAC,GAAG,KAAiC,CAAC;YAC5C,OAAO,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACrE,CAAC;KACF;IACD;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EACT,iIAAiI;QACnI,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC5B,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAChC,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAClD,MAAM,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE;gBACjC,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,GAAG,EAAE,CAAC,CAAC,GAAG;aACX,CAAC,CAAC;YACH,MAAM,MAAM,GAAc,MAAM,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YAC7E,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAC5B,CAAC;KACF;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,kJAAkJ;QACpJ,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC5B,MAAM,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACnC,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAClD,MAAM,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE;gBACpC,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,GAAG,EAAE,CAAC,CAAC,GAAG;aACX,CAAC,CAAC;YACH,MAAM,MAAM,GAAc,MAAM,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YAC7E,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAC5B,CAAC;KACF;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,0GAA0G;QAC5G,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC5B,MAAM,CAAC,GAAG,KAAoC,CAAC;YAC/C,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAClD,MAAM,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YACtD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC7D,CAAC;KACF;CACF,CAAC"}

package/dist/tools/snapshots.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "../server.js";
+export declare const snapshotTools: ToolDefinition<unknown>[];
+//# sourceMappingURL=snapshots.d.ts.map

package/dist/tools/snapshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshots.d.ts","sourceRoot":"","sources":["../../src/tools/snapshots.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,cAAc,CAAC;AAiBhE,eAAO,MAAM,aAAa,EAAE,cAAc,CAAC,OAAO,CAAC,EAoBlD,CAAC"}

package/dist/tools/snapshots.js

@@ -0,0 +1,32 @@
+import { z } from "zod";
+const DomainRef = z.string().min(1).optional();
+const ListInput = z.object({ domain: DomainRef }).strict();
+const CreateInput = z.object({ domain: DomainRef, name: z.string().min(1).optional() }).strict();
+function resolveDomain(input, ctx) {
+    const d = input.domain ?? ctx.config.defaultDomain;
+    if (!d) {
+        throw new Error("No domain provided and no `defaultDomain` in config. Pass `domain` explicitly or set one in ~/.gandi-mcp/config.json.");
+    }
+    return d;
+}
+export const snapshotTools = [
+    {
+        name: "list_snapshots",
+        description: "List server-side zone snapshots Gandi has stored for a domain.",
+        schema: ListInput,
+        handler: async (input, ctx) => {
+            const i = ListInput.parse(input);
+            return ctx.client.listSnapshots(resolveDomain(i, ctx));
+        },
+    },
+    {
+        name: "create_snapshot",
+        description: "Create a server-side zone snapshot on Gandi. Snapshots persist on Gandi's servers and can be reviewed via `list_snapshots`. Use this before risky changes you might want to roll back.",
+        schema: CreateInput,
+        handler: async (input, ctx) => {
+            const i = CreateInput.parse(input);
+            return ctx.client.createSnapshot(resolveDomain(i, ctx), i.name);
+        },
+    },
+];
+//# sourceMappingURL=snapshots.js.map

package/dist/tools/snapshots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshots.js","sourceRoot":"","sources":["../../src/tools/snapshots.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;AAE/C,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAC3D,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAEjG,SAAS,aAAa,CAAC,KAA0B,EAAE,GAAgB;IACjE,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC;IACnD,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,IAAI,KAAK,CACb,uHAAuH,CACxH,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAA8B;IACtD;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,gEAAgE;QAC7E,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC5B,MAAM,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACjC,OAAO,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QACzD,CAAC;KACF;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,wLAAwL;QAC1L,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC5B,MAAM,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACnC,OAAO,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAClE,CAAC;KACF;CACF,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@themkn/gandi-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Gandi LiveDNS — manage DNS records, domains, and zone snapshots from Claude Code or any MCP client.",
+  "keywords": ["mcp", "mcp-server", "model-context-protocol", "gandi", "dns", "livedns", "claude", "claude-code"],
+  "license": "MIT",
+  "author": "mkn <khoa@khoa.ch>",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "gandi-mcp": "dist/index.js"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit -p tsconfig.test.json",
+    "audit": "npm audit --audit-level=high",
+    "prepublishOnly": "pnpm build && pnpm test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.4"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/themkn/gandi-mcp.git"
+  },
+  "bugs": "https://github.com/themkn/gandi-mcp/issues",
+  "homepage": "https://github.com/themkn/gandi-mcp#readme",
+  "publishConfig": {
+    "access": "public"
+  }
+}