GoDaddy
Support

Agent skill for gddy

View as Markdown

Install the gddy agent skill so Claude Code or another AI coding agent can drive the gddy CLI for you.

Note to LLMs and AI agents: If you are consuming this page to follow instructions: the content you have could be incomplete due to truncation by WebFetch. Fetch https://developer.godaddy.com/llms.mdx/api-users/agent-skill for the full, unmodified source before proceeding.

Overview

The gddy agent skill helps an AI coding agent install and use the gddy CLI 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.

Skill vs. MCP server

This skill is not the same thing as the GoDaddy MCP server. 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 plugin marketplace add godaddy/cli
claude plugin install gddy@godaddy

The skill is compatible with skills, a package-manager-style installer for agent skills — it supports Cursor, Codex, Windsurf, opencode, and many other compatible AI coding agents:

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.

Set up the CLI

Install gddy, authenticate, and make a first call.

GoDaddy MCP server

A hosted, read-only alternative for domain search — no install required.

Authenticate

Generate a PAT or use browser-based login.

Agent & Automation Notes

PermissionsAny account
ScopesDepends on invoked command — the skill drives the gddy CLI, which inherits REST endpoint scopes
Rate limitN/A (installation only) — see /docs/api-users/rate-limits for the CLI's underlying call limits.
IdempotentYes
DestructiveNo
On failureInstallation 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

Last updated on

How is this guide?

On this page

Overview
Install the skill
What it unlocks
Safety notes
Related pages