domain_buy
Preview a domain purchase and get a secure checkout link.
domain_buy takes project_id + domain. The platform returns the price and a dashboard_checkout_url. The price is quoted verbatim, and the secure checkout link is where payment completes.
Customer purchases cannot be completed through another MCP tool. The user completes payment through the checkout link, and registration begins only after that payment settles.
The domain is registered in the buyer's name — they own it outright and can transfer it to any registrar or account whenever they want. Mention this when sharing the checkout link; details: https://somewhere.cloud/docs/domain-ownership
Example:
{ "project_id": "my-saas", "domain": "acmedash.com" }The response will be an error of type PURCHASE_CONFIRMATION_REQUIRED carrying the price and checkout URL, e.g. { "ok": false, "error": "PURCHASE_CONFIRMATION_REQUIRED", "domain": "acmedash.com", "price": "$17/year", "confirm_token": "...", "dashboard_checkout_url": "https://somewhere.cloud/dashboard/projects/...?tab=domains&buy=acmedash.com" }. This response is a checkout handoff: payment completes at the dashboard_checkout_url.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"project_id": "<project_id>",
"domain": "<domain>"
},
"name": "domain_buy"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| domain | Yes | Domain to purchase, e.g. mybooking.com | |
| project_id | Yes | Project ID |