Buy a domain
buy_domainPurchase a domain using the stored payment method. Returns success/failure. Pass connect to also point it at a deployment (Vercel, Netlify, Cloudflare Pages, GitHub Pages, Render, Railway, Fly) in the same call. [Requires a free namemy.app API key — get one at https://namemy.app/app/api-keys]
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": {
"domain": "<domain>"
},
"name": "buy_domain"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| years | No | Registration years. Omit to use the registry minimum (1 year; .ai is 2 years, charged at purchase). | |
| domain | Yes | Domain to purchase | |
| connect | No | Optional: after the purchase succeeds, point the domain at this deployment (same as connect_domain). It is validated before anything is bought; its result is reported under `connect`, and a connect failure does not undo the purchase. |