---
title: "corestack_domains_point_dns"
url: https://docs.corefinity.com/mcp/tools/corestack_domains_point_dns
type: tool
last_updated: 2026-11-13
feature: domains
related:
  - https://docs.corefinity.com/api/reference/domains/point-site-domains-dns.md
  - https://docs.corefinity.com/guides/sites/go-live/add-a-domain.md
---
# corestack_domains_point_dns

**Point DNS at a site.** Point a row's own production hosts at it in the company's connected Cloudflare account. When a record would be replaced, send confirm_replacements: true. Scope: write.

- Scope: `write`
- Runs as a task: no

## When to use it

Point a row's own production hosts at it in the company's connected Cloudflare account. When a record would be replaced, send confirm_replacements: true.

## Inputs

- `site_id` (integer, ≥ 1, required)
- `hosts` (array of string, up to 253 characters, 1–10 items, required): Hosts the row already serves.
- `confirm_replacements` (boolean): Required true when an existing record would be replaced.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "confirm_replacements": {
      "description": "Required true when an existing record would be replaced.",
      "type": "boolean"
    },
    "hosts": {
      "description": "Hosts the row already serves.",
      "items": {
        "maxLength": 253,
        "type": "string"
      },
      "maxItems": 10,
      "minItems": 1,
      "type": "array"
    },
    "site_id": {
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "site_id",
    "hosts"
  ],
  "type": "object"
}
```

## Refusals

- `preview_only`: the row has no domain attached yet; attach one with corestack_site_attach_domain first.
- `not_connected`: no Cloudflare connection can write this zone; connect Cloudflare or point DNS by hand.
- `no_zone`: the domain's DNS zone is not in the connected Cloudflare account; point DNS by hand.
- `upstream_unavailable`: the Control Panel answered 502: the cluster, a DNS resolver, Cloudflare, Mailgun, a Git provider, Google, Xero or Cloud Storage did not answer; `details.upstream` names it; retry later.
- `managed_elsewhere` (message: "This site is managed by another control panel"): another control panel manages this site, so use that control panel for it. This is refused before anything else about the site, as in the Control Panel and the API. Nothing was done.
- The refusals every tool can answer: `invalid_arguments`, `tenant_mismatch`, `scope_required`, `pin_refused`, `rate_limited`, `temporarily_unavailable`, `internal_error` (corestack://guides/how-this-server-works).

## Example

```json
{
  "name": "corestack_domains_point_dns",
  "arguments": {
    "site_id": 4211,
    "hosts": [
      "example.co.uk",
      "www.example.co.uk"
    ]
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_domains_point_dns with site_id 4211, hosts ["example.co.uk","www.example.co.uk"]. (Point DNS at a site.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [POST /api/corestack/sites/{site}/domains/point-dns](https://docs.corefinity.com/api/reference/domains/point-site-domains-dns.md)
- Guide: [Add a domain](https://docs.corefinity.com/guides/sites/go-live/add-a-domain.md)
