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

**Check DNS.** Check whether hosts point at a row in public DNS, with what to change when they do not — before attaching or changing a domain, or after moving DNS. Scope: read.

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

## When to use it

Check whether hosts point at a row in public DNS, with what to change when they do not — before attaching or changing a domain, or after moving DNS.

## Inputs

- `site_id` (integer, ≥ 1, required)
- `hosts` (array of string, up to 253 characters, 1–10 items, required)

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "hosts": {
      "items": {
        "maxLength": 253,
        "type": "string"
      },
      "maxItems": 10,
      "minItems": 1,
      "type": "array"
    },
    "site_id": {
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "site_id",
    "hosts"
  ],
  "type": "object"
}
```

## Refusals

- 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_check_dns",
  "arguments": {
    "site_id": 4211,
    "hosts": [
      "example.co.uk",
      "www.example.co.uk"
    ]
  }
}
```

## Prompt

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

## The same task elsewhere

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