---
title: "corestack_site_smoke_test"
url: https://docs.corefinity.com/mcp/tools/corestack_site_smoke_test
type: tool
last_updated: 2026-11-13
feature: migrate
related:
  - https://docs.corefinity.com/guides/migrate/migrate-wordpress.md
---
# corestack_site_smoke_test

**Smoke-test a site.** Test a site from the control panel before or after its DNS moves: request up to 20 paths on one of its hosts (its platform hostname, an attached domain or a pending-DNS domain), always at the site's own address, so public DNS is never used for a request. Answers each path's status, redirects, timings, TLS state (the platform hostname's at its public edge) and page title, and the error lines the site logged meanwhile. Redirects are followed only to the site's own hosts on the standard ports; any other is reported as off_host_redirect and not followed. The preview login is sent for you and never shown. Scope: exec.

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

## When to use it

Test a site from the Control Panel before or after its DNS moves: request up to 20 paths on one of its hosts (its platform hostname, an attached domain or a pending-DNS domain), always at the site's own address, so public DNS is never used for a request. Answers each path's status, redirects, timings, TLS state (the platform hostname's at its public edge) and page title, and the error lines the site logged meanwhile. Redirects are followed only to the site's own hosts on the standard ports; any other is reported as off_host_redirect and not followed. The preview login is sent for you and never shown.

The platform hostname's certificate lives at Corefinity's public edge, so its requests go to the site's own address without checking the certificate there, and its `tls` comes from one handshake to the hostname's public address instead: `tls.via` is `edge`, and `tls.message` says why when it is not valid (for example "The preview hostname has no DNS record."). The edge's answer never fails a check. Without `host`, a site that is not live yet is tested on its domain when its platform hostname has no DNS record.

## Inputs

- `site_id` (integer, ≥ 1, required)
- `paths` (array of string, 1–2048 characters, pattern `^/` or object, 1–20 items, required): Paths to request, each "/path?query" or {path, expect_status}.
  - `path` (string, 1–2048 characters, pattern `^/`, required): A path with an optional query, starting with /: no scheme, host or "..".
  - `expect_status` (integer, 100–599)
- `host` (string, up to 253 characters): One of the site's hosts: its platform hostname, an attached domain or a pending-DNS domain. Default: the domain when the site is live or its platform hostname has no DNS, else the platform hostname.
- `method` (one of `GET`, `HEAD`, default `"GET"`)

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "host": {
      "description": "One of the site's hosts: its platform hostname, an attached domain or a pending-DNS domain. Default: the domain when the site is live or its platform hostname has no DNS, else the platform hostname.",
      "maxLength": 253,
      "type": "string"
    },
    "method": {
      "default": "GET",
      "enum": [
        "GET",
        "HEAD"
      ],
      "type": "string"
    },
    "paths": {
      "description": "Paths to request, each \"/path?query\" or {path, expect_status}.",
      "items": {
        "anyOf": [
          {
            "description": "A path with an optional query, starting with /: no scheme, host or \"..\".",
            "maxLength": 2048,
            "minLength": 1,
            "pattern": "^/",
            "type": "string"
          },
          {
            "properties": {
              "expect_status": {
                "maximum": 599,
                "minimum": 100,
                "type": "integer"
              },
              "path": {
                "description": "A path with an optional query, starting with /: no scheme, host or \"..\".",
                "maxLength": 2048,
                "minLength": 1,
                "pattern": "^/",
                "type": "string"
              }
            },
            "required": [
              "path"
            ],
            "type": "object"
          }
        ]
      },
      "maxItems": 20,
      "minItems": 1,
      "type": "array"
    },
    "site_id": {
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "site_id",
    "paths"
  ],
  "type": "object"
}
```

## Refusals

- `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_site_smoke_test",
  "arguments": {
    "site_id": 4211,
    "paths": [
      "/",
      {
        "path": "/checkout",
        "expect_status": 200
      }
    ]
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_site_smoke_test with site_id 4211, paths ["/",{"path":"/checkout","expect_status":200}]. (Smoke-test a site.) Tell me what it returned.
```

## The same task elsewhere

- Guide: [Migrate WordPress](https://docs.corefinity.com/guides/migrate/migrate-wordpress.md)
