# Domain names with your AI agent

> Your agent checks and prices domain names, lists the project's domains and their expiry, and manages the DNS of a domain bought at Galon.

## What your agent can do

- Check whether a name is available, and its price in USD.
- Price a purchase, renewal or transfer before anything is paid.
- List the project's domains, orders and expiry notices.
- Read and replace the DNS records of a domain bought at Galon, after your confirmation.
- Read the renewal settings and turn automatic renewal on or off.

## Ask your agent

Paste a request like these in your AI once it is connected. It calls the tools in this order.

| You ask | Your agent calls |
|---|---|
| “Is acme-studio.com available, and how much is it?” | `check_domain` → `get_job` |
| “Point www.acme-studio.com to my site.” | `read_dns_records` → `get_job` → `apply_dns_records` |
| “Which of my domains expire soon?” | `list_domain_notices` |
| “Turn on automatic renewal for acme-studio.com.” | `get_domain_renewal` → `set_auto_renew` |
| “Buy acme-studio.com for one year.” | `quote_domain` → `get_job` → `request_approval` → `get_approval` |

## Tools and routes

Every tool is a call to the REST route next to it, with the same permissions, limits and idempotency. `tools/list` shows only the tools your connection can call.

| Tool | What it does | Scope | Same through the REST API |
|---|---|---|---|
| `check_domain` | Check if a domain name is available and its price. | `domain:lookup` | `POST /v1/jobs` |
| `quote_domain` | Price a domain operation before any approval. | `domain:quote` | `POST /v1/jobs` |
| `get_job` | Read a job and its result (domain checks, quotes). | `job:read` | `GET /v1/jobs/{job_id}` |
| `get_domain_quote` | Read a domain quote and its sale price. | `domain:quote` | `GET /v1/domain-quotes/{quote_id}` |
| `list_owned_domains` | List the domain names of this project. | `domain:read` | `GET /v1/domain-portfolio` |
| `list_domain_orders` | List the domain orders of this project. | `domain:read` | `GET /v1/domain-orders` |
| `list_domain_notices` | Expiry and renewal notices of this project. | `domain:read` | MCP only |
| `read_dns_records` | Read the DNS records of a domain name of this project. | `domain:dns_read` | `POST /v1/jobs` |
| `apply_dns_records` | Replace the DNS records of a domain name of this project. | `domain:dns_write` | MCP only |
| `get_domain_renewal` | Read the renewal settings of a domain name of this project. | `domain:renew` | MCP only |
| `set_auto_renew` | Turn the automatic renewal of a domain name on or off. | `domain:renew` | MCP only |

## Limits, free tier and pricing

Read from the platform code each time this page is served.

| Limit | Value |
|---|---|
| DNS zones hosted by Galon per project | **50** |
| Lock after a purchase or a transfer (transfer out) | **60 days** |

Prices are quoted per name and operation, in US dollars, before any charge. The free plan includes no domain registration.

Your agent reads the current prices with `get_pricing` and the spending limits with `get_limits`.

## Good to know

- A domain is paid by card, never from the prepaid balance, and a person approves every purchase.
- `apply_dns_records` replaces every record of the domain: the agent shows you the full new set and asks for your confirmation first.
- Turning automatic renewal on costs money at the due date: the agent shows you the renewal price first.
- With a sign-in connection, the agent asks you to approve a purchase, renewal or transfer with `request_approval`; you approve it in the console, and the agent follows it with `get_approval`. With an API key, a purchase is made in the console.

## Next

- [Full service documentation](/cloud/docs/services/domains)
- [Connect your AI](/cloud/docs/ai-assistants)
- [All capabilities](/cloud/docs/agents)
- [API reference](/cloud/docs/api)
