{"id":31767884,"url":"https://github.com/webdevtodayjason/namecheap-mcp","last_synced_at":"2026-06-23T12:03:38.869Z","repository":{"id":295647799,"uuid":"990773398","full_name":"webdevtodayjason/namecheap-mcp","owner":"webdevtodayjason","description":"Name Cheap MCP tools for your AI needs. ","archived":false,"fork":false,"pushed_at":"2025-06-04T16:35:36.000Z","size":81,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-05T07:18:48.083Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/webdevtodayjason.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-26T15:59:49.000Z","updated_at":"2025-06-04T16:35:37.000Z","dependencies_parsed_at":"2025-05-26T17:39:07.844Z","dependency_job_id":"704b46de-1eb0-4918-848c-bfe69372fde3","html_url":"https://github.com/webdevtodayjason/namecheap-mcp","commit_stats":null,"previous_names":["webdevtodayjason/namecheap-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/webdevtodayjason/namecheap-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdevtodayjason%2Fnamecheap-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdevtodayjason%2Fnamecheap-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdevtodayjason%2Fnamecheap-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdevtodayjason%2Fnamecheap-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/webdevtodayjason","download_url":"https://codeload.github.com/webdevtodayjason/namecheap-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webdevtodayjason%2Fnamecheap-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34686728,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-23T02:00:07.161Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-10T01:48:34.231Z","updated_at":"2026-06-23T12:03:38.864Z","avatar_url":"https://github.com/webdevtodayjason.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Namecheap MCP Server\n\n[![NPM Version](https://img.shields.io/npm/v/@webdevtoday/nc-mcp-server)](https://www.npmjs.com/package/@webdevtoday/nc-mcp-server)\n[![License](https://img.shields.io/npm/l/@webdevtoday/nc-mcp-server)](https://github.com/webdevtodayjason/nc-mcp-server/blob/main/LICENSE)\n[![smithery badge](https://smithery.ai/badge/@webdevtodayjason/namecheap-mcp)](https://smithery.ai/server/@webdevtodayjason/namecheap-mcp)\n[![Deploy on Smithery](https://smithery.ai/badge/deploy)](https://smithery.ai/server/@webdevtoday/namecheap-domains)\n\n## 🚀 The Problem\n\nManaging domain registrations typically requires navigating complex web interfaces or writing custom API integrations. This creates friction when you want to quickly check domain availability or register domains as part of your workflow.\n\n## 💡 The Solution\n\nThe Namecheap MCP Server brings comprehensive domain management directly into your AI assistant. Check availability, manage your portfolio, view DNS records, and register domains using natural language - all without leaving your conversation.\n\n```\nYou: \"Show me all my domains\"\nAssistant: \"You have 12 domains. 2 are expiring soon: myblog.com (expires in 15 days)...\"\n\nYou: \"Get DNS records for myblog.com\"\nAssistant: \"myblog.com has 4 A records, 2 MX records for email...\"\n\nYou: \"Is mycoolstartup.com available?\"\nAssistant: \"Yes, mycoolstartup.com is available! A .com costs $9.58/year.\"\n\nYou: \"Register it for 2 years\"\nAssistant: \"I'll register mycoolstartup.com for 2 years. Total: $19.16. Confirm?\"\n```\n\n## ⚠️ Important Security Warning\n\n**This tool uses the Namecheap live API and can make REAL purchases.** Always double-check domain registration commands before confirming.\n\n## 📦 Installation\n\n\u003cdetails open\u003e\n\u003csummary\u003e\u003cstrong\u003eQuick Start with Smithery (Recommended)\u003c/strong\u003e\u003c/summary\u003e\n\n1. Click [Deploy on Smithery](https://smithery.ai/server/@webdevtoday/namecheap-domains)\n2. Configure your Namecheap credentials\n3. Get your Smithery API key\n4. Add to your MCP client\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eClaude Desktop\u003c/strong\u003e\u003c/summary\u003e\n\nAdd to your Claude Desktop config:\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  \n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"namecheap\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@webdevtoday/nc-mcp-server\"],\n      \"env\": {\n        \"NC_USERNAME\": \"your_namecheap_username\",\n        \"NC_API_KEY\": \"your_namecheap_api_key\",\n        \"NODE_ENV\": \"production\"\n      }\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eOther MCP Clients (via Smithery)\u003c/strong\u003e\u003c/summary\u003e\n\n```json\n{\n  \"mcpServers\": {\n    \"namecheap\": {\n      \"uri\": \"https://api.smithery.ai/mcp/@webdevtoday/namecheap-domains\",\n      \"transport\": {\n        \"type\": \"sse\",\n        \"config\": {\n          \"apiKey\": \"your-smithery-api-key\"\n        }\n      }\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eDocker\u003c/strong\u003e\u003c/summary\u003e\n\n```bash\n# Build\ndocker build -t nc-mcp-server .\n\n# Run\ndocker run -p 3500:3500 \\\n  -e NC_USERNAME=your_username \\\n  -e NC_API_KEY=your_api_key \\\n  -e NODE_ENV=production \\\n  nc-mcp-server\n```\n\n\u003c/details\u003e\n\n## 🔧 Configuration\n\n### Environment Variables\n\n| Variable | Description | Required |\n|----------|-------------|----------|\n| `NC_USERNAME` | Your Namecheap username | ✅ |\n| `NC_API_KEY` | Your Namecheap API key | ✅ |\n| `NC_CLIENT_IP` | Your whitelisted IP (auto-detected if not set) | ❌ |\n| `NODE_ENV` | Set to `sandbox` for testing | ❌ |\n| `REGISTRANT_PROFILE` | JSON string with contact details | ❌ |\n| `REGISTRANT_PROFILE_PATH` | Path to registrant JSON file | ❌ |\n\n### Namecheap API Access\n\nTo use the Namecheap API, your account must meet **one** of these requirements:\n- At least 20 domains in your account\n- At least $50 account balance\n- At least $50 spent in the last 2 years\n\n### IP Whitelisting\n\n1. Find your IP: `curl ifconfig.me`\n2. Log in to Namecheap\n3. Go to **Profile → Tools → API Access**\n4. Add your IP to the whitelist\n\n### Registrant Profile\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eSetting up domain registration details\u003c/strong\u003e\u003c/summary\u003e\n\n**Option 1: Environment Variable**\n```json\n{\n  \"env\": {\n    \"REGISTRANT_PROFILE\": \"{\\\"firstName\\\":\\\"John\\\",\\\"lastName\\\":\\\"Doe\\\",\\\"address1\\\":\\\"123 Main St\\\",\\\"city\\\":\\\"New York\\\",\\\"stateProvince\\\":\\\"NY\\\",\\\"postalCode\\\":\\\"10001\\\",\\\"country\\\":\\\"US\\\",\\\"phone\\\":\\\"+1.2125551234\\\",\\\"email\\\":\\\"john@example.com\\\"}\"\n  }\n}\n```\n\n**Option 2: JSON File**\nCreate `registrant-profile.json`:\n```json\n{\n  \"firstName\": \"John\",\n  \"lastName\": \"Doe\",\n  \"address1\": \"123 Main St\",\n  \"city\": \"New York\",\n  \"stateProvince\": \"NY\",\n  \"postalCode\": \"10001\",\n  \"country\": \"US\",\n  \"phone\": \"+1.2125551234\",\n  \"email\": \"john@example.com\"\n}\n```\n\n\u003c/details\u003e\n\n## 🛠️ Available Tools\n\n### Domain Search \u0026 Information\n\n#### `check_domain`\nCheck if a domain is available for registration.\n\n```\n\"Is example.com available?\"\n\"Check mydomain.io\"\n```\n\n#### `get_domain_list`\nList all domains in your Namecheap account with filtering options.\n\n```\n\"Show me all my domains\"\n\"List my expiring domains\"\n\"Search for domains containing 'blog'\"\n```\n\n#### `get_domain_info`\nGet detailed information about a specific domain.\n\n```\n\"Get info for mydomain.com\"\n\"Show me details about example.com\"\n```\n\n#### `get_domain_contacts`\nRetrieve contact information for a domain.\n\n```\n\"Show contacts for mydomain.com\"\n\"Get registrant info for example.com\"\n```\n\n### Domain Management\n\n#### `get_tld_pricing`\nGet current pricing for any TLD.\n\n```\n\"How much does a .com cost?\"\n\"Price for .io domains\"\n```\n\n#### `register_domain`\nRegister a domain with optional WhoisGuard protection.\n\n```\n\"Register mydomain.com\"\n\"Register example.io for 2 years\"\n```\n\n### DNS Management\n\n#### `get_dns_hosts`\nRetrieve DNS records for domains using Namecheap DNS.\n\n```\n\"Show DNS records for mydomain.com\"\n\"Get DNS settings for example.com\"\n```\n\n## 🧪 Sandbox Mode\n\nTest without making real purchases:\n\n```json\n{\n  \"env\": {\n    \"NODE_ENV\": \"sandbox\",\n    \"NC_USERNAME\": \"your_username\",\n    \"NC_API_KEY\": \"your_sandbox_api_key\"\n  }\n}\n```\n\n## 🐛 Troubleshooting\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eCommon Issues\u003c/strong\u003e\u003c/summary\u003e\n\n### API Access Denied\n- Ensure your account meets the requirements\n- Verify your API key is correct\n- Check IP whitelisting\n\n### Connection Failed / IP Not Whitelisted\n- Check the Smithery logs to find the actual IP being used\n- Add that IP to your Namecheap whitelist (Profile → Tools → API Access)\n- Alternatively, set NC_CLIENT_IP in Smithery configuration\n- Note: Smithery servers may use different IPs than expected\n\n### Invalid API Key Error\n1. Verify API access is enabled in Namecheap\n2. Check your account meets requirements:\n   - At least 20 domains, OR\n   - At least $50 balance, OR  \n   - At least $50 spent in last 2 years\n3. Ensure API key is correctly copied\n\n### Registration Fails\n- Verify registrant profile is properly formatted\n- Ensure all required fields are filled\n- Check domain availability first\n\n\u003c/details\u003e\n\n## 🔨 Development\n\n```bash\n# Clone\ngit clone https://github.com/webdevtodayjason/nc-mcp-server\ncd nc-mcp-server\n\n# Install\nnpm install\n\n# Build\nnpm run build\n\n# Run\nNC_USERNAME=your_username NC_API_KEY=your_key npm start\n```\n\n### Deploy Your Own\n\nTo install Namecheap MCP Server for any client automatically via Smithery:\n\n```bash\nnpx -y @smithery/cli@latest install @webdevtoday/namecheap-domains --client \u003cCLIENT_NAME\u003e --key \u003cYOUR_SMITHERY_KEY\u003e\n```\n\nYou can find your Smithery key in the [Smithery.ai](https://smithery.ai) dashboard.\n\n## 🤝 Contributing\n\nContributions welcome! Please feel free to submit a Pull Request.\n\n## 📄 License\n\nMIT © [Jason Brashear](https://github.com/webdevtodayjason)\n\n## 🌟 Support\n\nIf you find this helpful, please consider:\n- ⭐ Starring the repository\n- 🐛 Reporting issues\n- 💡 Suggesting features\n- 🤝 Contributing code\n\n---\n\n\u003cp align=\"center\"\u003eMade with ❤️ by \u003ca href=\"https://github.com/webdevtodayjason\"\u003eJason Brashear\u003c/a\u003e\u003c/p\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebdevtodayjason%2Fnamecheap-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwebdevtodayjason%2Fnamecheap-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebdevtodayjason%2Fnamecheap-mcp/lists"}