# Agent skill for gddy (https://developer.godaddy.com/en/docs/api-users/agent-skill)

***

title: Agent skill for gddy
description: Install the gddy agent skill so Claude Code or another AI coding agent can drive the gddy CLI for you.
agentNotes:
permissions: \["Any account"]
scopes: \["Depends on invoked command — the skill drives the gddy CLI, which inherits REST endpoint scopes"]
rateLimit: "N/A (installation only) — see /docs/api-users/rate-limits for the CLI's underlying call limits."
idempotent: true
destructive: false
failureRecovery: "Installation is safe to repeat. Re-run the install command to update or reinstall. Removing the skill does not affect the gddy CLI itself or its stored credentials."
related:
guides:

* title: "Set up the CLI"
  href: "/docs/api-users/cli-setup"
* title: "GoDaddy MCP server"
  href: "/docs/api-users/mcp"
* title: "Authenticate"
  href: "/docs/api-users/auth"

***

## Overview

The `gddy` agent skill helps an AI coding agent install and use the [`gddy` CLI](https://developer.godaddy.com/docs/api-users/cli-setup) on your behalf. Installing the skill is a one-time setup — once it's in place, you can ask your agent to find a domain, check pricing, register it, or update DNS records in plain language, and it runs the actual `gddy` commands using your own authenticated session.

This skill is not the same thing as the [GoDaddy MCP server](https://developer.godaddy.com/docs/api-users/mcp). The MCP server is a hosted, read-only service anyone can connect to for domain search and availability — no install, no credentials, no purchases or DNS writes. The agent skill instead helps your coding agent install and run `gddy` itself, so it can do everything the CLI can do — including domain purchase and DNS management — using your own credentials.

## Install the skill

**Claude Code**

```bash
claude plugin marketplace add godaddy/cli
claude plugin install gddy@godaddy
```

**Any other AI coding agent**

The skill is compatible with [skills](https://github.com/vercel-labs/skills), a package-manager-style installer for agent skills — it supports Cursor, Codex, Windsurf, opencode, and many other compatible AI coding agents:

```bash
npx skills add godaddy/cli --skill gddy --agent <agent>
```

Swap `<agent>` for whichever agent you use (`claude-code`, `cursor`, `codex`, `windsurf`, `opencode`, ...). Run `npx skills add --help` for the full list of supported agents.

## What it unlocks

Once installed, ask your agent things like:

* "Set up gddy for me and log me in." (installs the CLI and walks you through `gddy auth login` if it isn't set up yet)
* "Find available domains for a coffee subscription startup."
* "Is `example.com` available, and what would it cost to register?"
* "Add a CNAME record for `www` on `example.com` pointing to `example.github.io`."
* "List the DNS records on `example.com`."

Your agent will run the equivalent `gddy` commands, parse the JSON output, and summarize the result. It also knows how to use the CLI's self-documentation to stay current as `gddy` evolves — `gddy --help`, `gddy --search <keywords>`, `gddy tree`, and `gddy guide`.

## Safety notes

* **Domain purchase is real money and not reversible.** By default, the skill walks through the quote-then-purchase flow and confirms with you before finalizing a purchase.
* **`gddy dns set` and `gddy dns delete` are destructive** — they replace or remove every matching record. By default, the skill runs these with `--dry-run` first and shows you the change before applying it.
* The skill acts with whatever credentials and environment your `gddy` CLI is currently authenticated against. Check with `gddy auth status` if you're unsure which account or environment your agent is operating on.

## Related pages