namecheap-api-mcp
Manage domains, DNS, contacts, registrar locks, and view SSL certificates and pricing via the Namecheap API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@namecheap-api-mcp check availability of example.com"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
namecheap-api-mcp
MCP server for the Namecheap API — manage domains, DNS, contacts, registrar locks, and view SSL certificates and pricing, straight from your AI assistant.
Built for Claude Code and any MCP-compatible AI tool.
Part of The SEO Engine toolkit by Rex Jones — AI-powered SEO and social media tooling for agencies and businesses.
Safety model
This server ships read + safe-write tools only. It can read your account and change DNS / nameserver / forwarding / lock configuration (all reversible), but it deliberately excludes anything that spends money or is irreversible: no domain registration, renewal, reactivation, transfers, SSL purchase/activation, add-funds, or account/address mutation. You can fork and add those if you need them.
Related MCP server: MCP Namecheap Server
Quick start
1. Enable Namecheap API access
Go to Profile → Tools → Namecheap API Access and toggle it ON. (Production access requires account eligibility: 20+ domains, OR a $50+ balance, OR $50+ lifetime spend.)
Copy your API key.
Whitelist the public IPv4 of the machine that will run this server (the API rejects any non-whitelisted IP with error
1011150).
2. Configure your MCP client
{
"mcpServers": {
"namecheap": {
"command": "npx",
"args": ["-y", "namecheap-api-mcp"],
"env": {
"NAMECHEAP_API_USER": "your_username",
"NAMECHEAP_API_KEY": "your_api_key",
"NAMECHEAP_CLIENT_IP": "your.whitelisted.ip.v4"
}
}
}
}Option: clone and build
git clone https://github.com/lanternrow/namecheap-api-mcp.git
cd namecheap-api-mcp
npm install
npm run buildThen point your client at node /path/to/namecheap-api-mcp/dist/index.js. For local credentials you can keep a gitignored .env (copy .env.example) and launch with Node's native flag: node --env-file=.env dist/index.js.
Environment variables
Variable | Required | Description |
| Yes | Your Namecheap account username (API user). |
| Yes | API key from Profile → Tools → API Access. Secret. |
| Yes | The whitelisted public IPv4 of this machine. |
| No | Defaults to |
| No |
|
Tools
Read
Tool | Description |
| Verify credentials + IP whitelist; returns the account balance summary. |
| List domains with expiry, lock, auto-renew, and WhoisGuard status (paged/searchable). |
| Detailed info for one domain. |
| Check availability + premium pricing (up to 50 at once). |
| Registrant / Tech / Admin / AuxBilling contacts. |
| Registrar lock status. |
| All DNS host records for a domain. |
| Nameservers and whether Namecheap DNS is in use. |
| Email forwarding rules. |
| Namecheap pricing for a product type (cache the results). |
| SSL certificates with type, host, status, expiry. |
Safe writes (configuration only — no charges)
Tool | Description |
| Replace all host records (destructive: omitted records are deleted — send the full set). |
| Switch a domain to Namecheap's default nameservers. |
| Point a domain at custom nameservers. |
| Set email forwarding rules. |
| Lock / unlock a domain at the registrar. |
Notes & gotchas
set_dns_hostsis destructive by API design. Namecheap'ssetHostsdeletes every record not included in the call. Always read current records first (get_dns_hosts), merge your change, then send the complete set.Errors return HTTP 200. The Namecheap API signals failure in the XML body (
Status="ERROR"), not the HTTP status. This server parses that and throws a real error with the Namecheap error number + message.IPv4 only for the whitelisted client IP.
Security
Credentials are read from environment variables only — never hard-coded, logged, or written to disk by this server.
The API key travels in the query string (Namecheap's design); this server never logs the request URL or key, and error messages surface only the Namecheap error number and text.
License
MIT © Rex Jones
Available Tools
16 toolscheck_connectionA
Verify the Namecheap API connection and credentials. Returns the account balance summary — a lightweight call that confirms the API user, key, and IP whitelist are all working.
Inputs: no named parameters.
check_domainsA
Check availability (and premium pricing) for one or more domains. Max 50 per call.
Inputs: domains (required).
get_dns_hostsB
Get all DNS host records (A, AAAA, CNAME, MX, TXT, URL, etc.) for a domain.
Inputs: domain (required).
get_domain_contactsB
Get the Registrant, Tech, Admin, and AuxBilling contact details for a domain.
Inputs: domain (required).
get_domain_infoA
Get detailed info for one domain: status, created/expiry dates, WhoisGuard, DNS provider, and modification rights.
Inputs: domain (required).
get_email_forwardingA
Get email forwarding settings (mailbox → forward-to) for a domain.
Inputs: domain (required).
get_nameserversA
Get the nameservers associated with a domain, and whether it uses Namecheap's default DNS.
Inputs: domain (required).
get_pricingA
Get Namecheap pricing for a product type (e.g. DOMAIN register/renew/transfer). Cache results — this is a heavy endpoint.
Inputs: product_type, product_category, action_name, product_name.
get_registrar_lockB
Get the registrar lock status for a domain.
Inputs: domain (required).
list_domainsA
List domains in the account, with creation/expiry dates, lock status, auto-renew, and WhoisGuard status. Supports paging and search.
Inputs: list_type, search_term, page, page_size, +1 more.
list_ssl_certificatesC
List SSL certificates in the account, with type, host name, status, and expiry.
Inputs: list_type, search_term, page, page_size.
set_custom_nameserversA
Point a domain at custom nameservers. NOTE: Namecheap host records, URL/email forwarding stop working while custom nameservers are in use.
Inputs: domain (required), nameservers (required).
set_default_dnsA
Switch a domain to Namecheap's default (BasicDNS) nameservers. Required for Namecheap host records, URL/email forwarding.
Inputs: domain (required).
set_dns_hostsA
Replace ALL DNS host records for a domain. WARNING: this is destructive — Namecheap deletes any record not included here, so you must pass the COMPLETE desired record set (call get_dns_hosts first, merge your changes, then send everything). Switches the domain to Namecheap DNS if needed.
Inputs: domain (required), records (required), email_type.
set_email_forwardingA
Set email forwarding rules for a domain. Replaces the full forwarding set (pass all rules you want to keep).
Inputs: domain (required), forwards (required).
set_registrar_lockA
Lock or unlock a domain at the registrar (theft protection). Unlock before initiating an outbound transfer.
Inputs: domain (required), action.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 16 tools
Each tool has a clearly distinct purpose: connection check, domain availability, DNS management, contacts, info, pricing, registrar lock, etc. There is no overlap or ambiguity between any two tools.
All tools follow a consistent verb_noun pattern in snake_case (e.g., check_domains, get_dns_hosts, set_registrar_lock). The verbs are uniform (check, get, list, set) and there are no deviations.
With 16 tools, the set feels well-scoped for a domain and DNS management API. It covers essential operations without being overwhelming, and each tool adds clear value.
The tool set covers many aspects (DNS, contacts, pricing, SSL listing), but lacks fundamental lifecycle operations like domain registration, renewal, or transfer. This is a notable gap given the server's domain management focus.
Maintenance
Related MCP Connectors
Register, transfer and manage domain names and DNS from your AI agent.
Domain search, registration, DNS, marketplace, and checkout with your AI agent.
Find, register, and manage domains from any AI chat or agent
Domain availability search, WHOIS lookup, TLD pricing and registry rules from name.ai. Read-only.
Related MCP Servers
AlicenseNot gradedqualityBmaintenanceEnables AI assistants to perform comprehensive domain management tasks through the Name.com API, including registration, DNS management, and transfers. It dynamically generates tools from the OpenAPI specification to facilitate natural language interaction with all Name.com services.270 npm3MIT- AlicenseBqualityDmaintenanceProvides integration with the Namecheap API for domain management operations, including domain listing, availability checks, and nameserver configuration. It allows users to interact with their Namecheap account through natural language commands in MCP-compatible clients.334 npm20MIT
- FlicenseAqualityDmaintenanceA Model Context Protocol server that wraps the Namecheap API, enabling AI assistants to manage domains, DNS records, SSL certificates, and account information.212 npm-
- AlicenseBqualityCmaintenanceEnables interaction with the NameSilo Domain API through 67 tools for domain registration, transfers, DNS management, contacts, privacy, forwarding, email, portfolios, account funds, marketplace, and auctions.67MIT