Skip to main content

godaddy-mcp

License: MIT Python MCP

A Model Context Protocol (MCP) server for managing GoDaddy DNS records. Lets AI assistants (Claude, etc.) list, add, replace, and delete DNS records on any domain in your GoDaddy account.

Table of Contents

Installation

Requires uv (Python 3.11+).

uvx godaddy-mcp

No cloning or path configuration needed.

Option B — from source

git clone https://github.com/davidcjw/godaddy-mcp
cd godaddy-mcp
uv sync

Configuration

1. Get GoDaddy API credentials

Generate a Production API key at developer.godaddy.com (select Production, not OTE).

2. Register with Claude Code

Add the following to the mcpServers section of ~/.claude.json:

With PyPI install (recommended):

"godaddy-dns": {
  "command": "uvx",
  "args": ["godaddy-mcp"],
  "env": {
    "GODADDY_API_KEY": "your_api_key",
    "GODADDY_API_SECRET": "your_api_secret"
  }
}

With source install:

"godaddy-dns": {
  "command": "/path/to/godaddy-mcp/.venv/bin/python",
  "args": ["/path/to/godaddy-mcp/server.py"],
  "env": {
    "GODADDY_API_KEY": "your_api_key",
    "GODADDY_API_SECRET": "your_api_secret"
  }
}

Restart Claude Code to activate the server.

3. Other MCP clients

Run the server directly:

GODADDY_API_KEY=your_key GODADDY_API_SECRET=your_secret uvx godaddy-mcp
# or from source:
GODADDY_API_KEY=your_key GODADDY_API_SECRET=your_secret uv run python server.py

Usage

Once registered, Claude (or any MCP client) can manage DNS records conversationally:

"Add a CNAME record for app.example.com pointing to cname.vercel-dns.com"

"List all A records for example.com"

"Delete the TXT record _vercel from example.com"

Tools

Tool Description
list_dns_records List all records for a domain, optionally filtered by type and/or name
add_dns_record Add a record without overwriting existing ones of the same type (PATCH)
replace_dns_records Overwrite all records of a given type+name — use when you need exactly one record (PUT)
delete_dns_record Delete all records matching a given type and name

Supported record types: A, AAAA, CNAME, MX, TXT, NS, SRV, CAA, and others supported by the GoDaddy API.

Contributing

Contributions are welcome! Please open an issue first to discuss what you'd like to change.

  1. Fork the repo
  2. Create a feature branch (git checkout -b feature/your-feature)
  3. Commit your changes (git commit -m 'feat: describe change')
  4. Push and open a pull request

Please make sure the server starts cleanly (uv run python server.py) before submitting a PR.

Code of Conduct

This project follows the Contributor Covenant v2.1. By participating you agree to uphold a welcoming, harassment-free environment.

License

Distributed under the MIT License. See LICENSE for details.

Metadata

Release files for godaddy-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for godaddy-mcp 0.1.0
File Size Uploaded Provenance Actions
godaddy_mcp-0.1.0.tar.gz 48.8 kB Without provenance Details for godaddy_mcp-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for godaddy-mcp 0.1.0
File Interpreter ABI Platform Actions
godaddy_mcp-0.1.0-py3-none-any.whl Python 3 none any Details for godaddy_mcp-0.1.0-py3-none-any.whl

Total release size: 53.9 kB

Release files / godaddy_mcp-0.1.0.tar.gz

Download URL godaddy_mcp-0.1.0.tar.gz
Size 48.8 kB
Tags Source
SHA-256 checksum
How to use checksums
f86663d8d3c824f846179ba8d257a8c19ef124533bf2ca08a7e83cd87d23729e
BLAKE2b-256 checksum
How to use checksums
2d869b671cff6498e0039b190593b4e9189a8b2f7aeaf3b544fb553b40e1217c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / godaddy_mcp-0.1.0-py3-none-any.whl

Download URL godaddy_mcp-0.1.0-py3-none-any.whl
Size 5.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3ae94360d93fb81e335bbc8012cd4f7044f0d7c911b9101f71feb08da8d634f8
BLAKE2b-256 checksum
How to use checksums
1c897f659c1f8058af178698f6062b415a453469b45fd2f89cefca286e75b9d2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for godaddy-mcp 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page