Use the Alibaba Cloud Domains MCP

Updated at:

After you connect to the Alibaba Cloud Domains MCP, you can use an AI assistant to query your domain name assets, prices, and DNS records, and to preview changes before you modify the configuration. This topic describes how to connect and provides common prompt examples.

What you can do

  • Query domain name assets, status, and expiration time.

  • Check registration eligibility, reference prices, and WHOIS.

  • View DNS records and preview adding a record.

  • Preview enabling the transfer lock and modifying remarks.

  • Check identity verification status and the registry lock, and search domain name and ICP filing knowledge.

Connect to the MCP

Let the AI assistant do it (recommended)

Send the following message to your AI assistant:

Connect the Alibaba Cloud Domains MCP service to the client that I am using. The server address is https://openapi-mcp.cn-hangzhou.aliyuncs.com/s/Domain/domain/2dd2d6410b8648938effea0a177280e6/mcp, the protocol is Streamable HTTP, authentication uses OAuth (you can use npx mcp-remote-alibaba-cloud as the proxy for authorization), and the service name is aliyun-domain. After you finish configuring it, tell me whether I need to restart the session.

This address is the public service address of the China site domain name MCP and is the same for all users. The account and permissions that you can use are determined by the OAuth authorization result.

Add manually

If your client natively supports Streamable HTTP and OAuth, specify the following settings:

  • Service name: aliyun-domain

  • Server address: https://openapi-mcp.cn-hangzhou.aliyuncs.com/s/Domain/domain/2dd2d6410b8648938effea0a177280e6/mcp

  • Protocol: Streamable HTTP

  • Authentication method: OAuth

Verify the connection

After you restart the session, tell the AI assistant:

Call the whoami tool of aliyun-domain to check the logon status, and do not display the account ID. Then call the list tool to list the domain names under the account. Only query the data; do not modify anything.

If authorization has not been completed, an authorization page opens or a link is returned. After you complete the authorization, a returned domain name list means that the configuration is successful. If the account has no domain names, an empty list is also normal.

AI usage examples

In the examples, replace example.com with your actual domain name.

What you can ask

Result

"List the domain names under my account, sorted by expiration time."

Returns the domain names, their status, and expiration time.

"Check whether example.com can be registered, and show its reference price and WHOIS information."

Returns the eligibility, price, and public registration information. No order is created.

"List the DNS records of example.com."

Returns the current DNS records without modifying the configuration.

"Add an A record for www on example.com that points to 192.0.2.1. Show the preview only; do not submit."

Returns the change preview and a plan_id, and does not write the record.

After a modification is previewed, the AI assistant submits it with the confirmation information only after you explicitly reply to confirm. The domain name must already be hosted by Alibaba Cloud DNS. A successful write does not mean that the DNS change has taken effect across the internet.

For more commands, see the aliyun domain command reference.

Precautions and FAQ

Precautions

  • Before modifying anything, check the target domain name, the changes, and the impact that the AI assistant shows, and submit only after you confirm.

  • ICP filing forms and file-based tools are not available in the remote MCP. Use the console or the local CLI instead.

FAQ

  • The AI assistant cannot connect to the MCP service. What should I do?

    Make sure that the client supports MCP. If you use a proxy, make sure that Node.js is version 20.18.1 or later. After you save the configuration, restart the session or the client.

  • The authorization page did not open automatically. What should I do?

    Check whether the information that the AI assistant returns contains an authorization link, and copy the link to a browser to complete the authorization.

  • The configuration did not change after I called a modification tool. What should I do?

    Modification tools only generate a preview by default. After you check the preview, explicitly reply to the AI assistant to confirm the submission.

  • file is unavailable or inaccessible is returned. What should I do?

    The tool is reading a local file on your computer, but the remote MCP cannot access that file. Use the console or the local CLI instead.

  • trade_detail returns INTERNAL or the JSON-RPC error -32603. What does it mean?

    If the error body contains DomainNotOnSale, the domain name is not currently on sale. This is not a system failure or a parameter error, and you do not need to retry.