godaddy-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
Option A — PyPI (recommended)
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.compointing tocname.vercel-dns.com"
"List all A records for
example.com"
"Delete the TXT record
_vercelfromexample.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.
- Fork the repo
- Create a feature branch (
git checkout -b feature/your-feature) - Commit your changes (
git commit -m 'feat: describe change') - 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.