Integrates with the GoDaddy OTE (Operational Test Environment) API to check domain availability and pricing. Provides tools for checking individual domains or bulk domain availability across multiple TLD suffixes, with support for fast and full check modes.
MCP Domain Availability Server
A Model Context Protocol (MCP) server for checking domain availability and pricing using the GoDaddy OTE (Operational Test Environment) API.
Features
- Check domain availability and pricing via GoDaddy OTE sandbox
- Support for multiple TLD suffixes
- Fast and Full check modes
- Support for bulk domain checking
- Rate limiting (60 calls per minute)
- Normalized pricing in dollars with 2 decimal places
- Consistent field naming and data structures
- Period normalization (stored in months, displayed in years)
Installation
Using uv (Recommended)
Manual Installation
Configuration
Environment Variables
DOMAIN_API_KEY
: Your GoDaddy OTE API credentials in format"key:secret"
(required)
Note: The server uses GoDaddy OTE (sandbox) API by default: https://api.ote-godaddy.com
GoDaddy OTE Setup
- Sign up for GoDaddy Developer account
- Get OTE (sandbox) API credentials
- Set the environment variable:
DOMAIN_API_KEY="your-ote-key:your-ote-secret"
MCP Configuration
Add this to your MCP client configuration (e.g., Claude Desktop's claude_desktop_config.json
):
Usage
Development & Testing
This will start the MCP Inspector at http://localhost:6274
for interactive testing.
Tools Available
The server provides one tool: check_domain_availability
Parameters
Option 1: Direct domain list
domains
: Array of domain names to check (e.g.,["example.com", "example.org"]
)
Option 2: Base name with TLD suffixes
base_name
: Base domain name (e.g.,"example"
)tld_suffixes
: Array of TLD suffixes (e.g.,[".com", ".org", ".net", ".io"]
)
Optional
checkType
:"FAST"
or"FULL"
(default:"FAST"
)FAST
: Optimized for speedFULL
: Optimized for accuracy
Examples
Check specific domains
Check base name with multiple TLDs
Response Format
Text Response:
JSON Response (normalized fields):
Data Normalization
Price Normalization
- Input: GoDaddy API returns prices in micro-units (1/1,000,000 of currency)
- Output: Converted to dollars with 2 decimal places
- Example:
12000000
micro-units →$12.00 USD
Period Normalization
- Storage: Period stored in months for consistency
- Display: Converted to years for user-friendly display
- Example:
12 months
→"1 year"
,24 months
→"2 years"
Field Naming
Consistent, explicit field names:
domain_name
(instead ofdomain
)is_available
(instead ofavailable
)price_dollars
(instead ofprice
)currency_code
(instead ofcurrency
)is_definitive
(instead ofdefinitive
)registration_period_months
(instead ofperiod
)error_message
(instead oferror
)
API Integration
This server integrates with GoDaddy OTE API:
- Base URL:
https://api.ote-godaddy.com
- Endpoint:
GET /v1/domains/available?domain={domain}
- Headers:
Authorization: sso-key {key}:{secret}
- Rate Limit: 60 requests per minute
Authentication Format
Error Handling
The server handles various error conditions:
- Missing API key
- Invalid domains
- API rate limits (429) - with retry guidance
- Partial responses (203)
- Authentication errors (401, 403)
- Server errors (500)
- Network timeouts
Development
Setup Development Environment
Testing with MCP Inspector
- Set your OTE credentials:
DOMAIN_API_KEY="your-key:your-secret"
- Run:
mcp dev domain_availability/server.py
- Open browser at
http://localhost:6274
- Use the session token displayed in terminal if prompted
- Test the
check_domain_availability
tool
License
MIT License
Support
For issues and questions, please create an issue in the repository.
This server cannot be installed
Enables checking domain availability and pricing using the GoDaddy OTE API, supporting multiple TLD suffixes and both fast and full check modes.
Related MCP Servers
- AsecurityFlicenseAqualityEnables AI agents to perform WHOIS lookups to retrieve domain registration details, including ownership, registration dates, and availability status without requiring browser searches.Last updated -427216JavaScript
- -securityFlicense-qualityA Model Context Protocol server that enables AI assistants to check domain name availability using WHOIS lookups.Last updated -53TypeScript
- -securityFlicense-qualityMCP Server that enables interaction with GoDaddy's Orders API using natural language, auto-generated from the OTE GoDaddy Orders OpenAPI specification.Last updated -Python
- -securityAlicense-qualityA Model Context Protocol server that provides comprehensive domain analysis capabilities including WHOIS lookups, DNS record queries, and DNS health checking.Last updated -2PythonMIT License