---
title: "MCP Tools Reference — PageWeave"
---

> For the full documentation index, see [PageWeave Documentation](https://pageweave.dev/docs) or fetch [llms.txt](https://pageweave.dev/llms.txt).

# list_dns_records, add_dns_record, update_dns_record, delete_dns_record

Manage records in the DNS zone of a domain you own (DNS-managed through PageWeave).

Records live in the external DNS zone — they only apply to domains whose DNS PageWeave manages (see [Domains](/docs/mcp-tools/domains)).

## Actions

### list

List DNS records for a domain you own.

**Parameters:**
- `domain` — Domain name (exact match)
- `type` — Optional filter by record type (`A`, `AAAA`, `ALIAS`, `CNAME`, `MX`, `TXT`, `NS`, `SRV`)
- `host` — Optional filter by host/subdomain (empty string = apex)

### add

Add a DNS record.

**Parameters:**
- `domain` — Domain name (exact match)
- `type` — Record type: `A`, `AAAA`, `ALIAS`, `CNAME`, `MX`, `TXT`, `NS`, `SRV`
- `host` — Host/subdomain (empty string or `@` = apex)
- `record` — Record value (e.g. IP, hostname, TXT content)
- `ttl` — TTL in seconds
- `priority` — Priority (MX/SRV only)
- `weight` — Weight (SRV only)

Requires confirmation.

### update

Update a DNS record by `record_id`. Only provided fields change.

**Parameters:**
- `domain` — Domain name (exact match)
- `record_id` — Record id (from `list_dns_records`)
- `record` — New record value (optional)
- `host` — New host/subdomain (optional)
- `ttl` — New TTL in seconds (optional)
- `priority` — New priority, MX/SRV only (optional)
- `weight` — New weight, SRV only (optional)

Requires confirmation.

### delete

Delete a DNS record by `record_id`. Not reversible — requires confirmation.

**Parameters:**
- `domain` — Domain name (exact match)
- `record_id` — Record id (from `list_dns_records`)

## OAuth Scopes

| Action | Scope |
|--------|-------|
| list | `dns:read` |
| add, update, delete | `dns:write` |