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

**Read a migration target's facts.** Read what a migration needs to know about its target, without running anything on it: paths, PHP, Node.js and MariaDB versions, the database name and user (never the password), environment variable names, configuration conventions, services, the built-in cron, SSH, hosts, the fixed outbound addresses, limits and the copy hold — and, given the source application and version, whether it fits and what to upgrade first. Before the target exists, pass placement instead of site_id for the create lists and the verdict. Scope: read.

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

## When to use it

Read what a migration needs to know about its target, without running anything on it: paths, PHP, Node.js and MariaDB versions, the database name and user (never the password), environment variable names, configuration conventions, services, the built-in cron, SSH, hosts, the fixed outbound addresses, limits and the copy hold — and, given the source application and version, whether it fits and what to upgrade first. Before the target exists, pass placement instead of site_id for the create lists and the verdict.

A custom PHP application (`application: php`, while PHP is offered) has no version to check: leave `application_version` out, in either form. Its `verdict` is null — pick the PHP and MariaDB from `php` and `mariadb` (the create lists before the create, the row's own after it; before the create `php.create` holds only the versions a new site can be created on, and while none is open `php.wait` (`{message}`) says a create waits for `php.default`) — unless the target cannot take a PHP site: then it is `unsupported`, and its `reason` says why.

## Inputs

- `site_id` (integer, ≥ 1): An existing target: the production row or an environment's row.
- `application` (one of `wordpress`, `magento2`, `laravel`, `shopware`): The source's application.
- `application_version` (string, 1–40 characters): Its version, e.g. 6.8.3, 2.4.7-p3, 12.x or 6.6.10.8.
- `edition` (one of `open_source`, `mage_os`, `commerce`; only while `app_versions` is on and an edition is offered): magento2 only; left out, the default edition for the version. For another application leave it out (`invalid_arguments`).
- `source_php` (string, up to 16 characters, pattern `^\d+\.\d+(\.\d+)?$`): The PHP the source runs, e.g. 7.4.
- `source_database` (object): The source's database engine and version.
  - `engine` (one of `mysql`, `mariadb`, required)
  - `version` (string, 1–40 characters, required)
- `placement` (object): A target still to be made: where it will be created. Requires application and application_version.
  - `kind` (one of `cluster`, `platform`, required)
  - `cluster_id` (integer, ≥ 1): kind cluster: the CoreCluster the site will be created in.
  - `region` (one of `uk`, `us`, `nl`, `aus`): kind platform: the region of a standalone site.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "application": {
      "description": "The source's application.",
      "enum": [
        "wordpress",
        "magento2",
        "laravel",
        "shopware5"
      ],
      "type": "string"
    },
    "application_version": {
      "description": "Its version, e.g. 6.8.3, 2.4.7-p3, 12.x or 6.6.10.8.",
      "maxLength": 40,
      "minLength": 1,
      "type": "string"
    },
    "edition": {
      "description": "magento2 only; default from the version.",
      "enum": [
        "open_source"
      ],
      "type": "string"
    },
    "placement": {
      "additionalProperties": false,
      "description": "A target still to be made: where it will be created. Requires application and application_version.",
      "properties": {
        "cluster_id": {
          "description": "kind cluster: the CoreCluster the site will be created in.",
          "minimum": 1,
          "type": "integer"
        },
        "kind": {
          "enum": [
            "cluster",
            "platform"
          ],
          "type": "string"
        },
        "region": {
          "description": "kind platform: the region of a standalone site.",
          "enum": [
            "uk",
            "us",
            "nl",
            "aus"
          ],
          "type": "string"
        }
      },
      "required": [
        "kind"
      ],
      "type": "object"
    },
    "site_id": {
      "description": "An existing target: the production row or an environment's row.",
      "minimum": 1,
      "type": "integer"
    },
    "source_database": {
      "additionalProperties": false,
      "description": "The source's database engine and version.",
      "properties": {
        "engine": {
          "enum": [
            "mysql",
            "mariadb"
          ],
          "type": "string"
        },
        "version": {
          "maxLength": 40,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "engine",
        "version"
      ],
      "type": "object"
    },
    "source_php": {
      "description": "The PHP the source runs, e.g. 7.4.",
      "maxLength": 16,
      "pattern": "^\\d+\\.\\d+(\\.\\d+)?$",
      "type": "string"
    }
  },
  "type": "object"
}
```

## Refusals

- `invalid_arguments` on `application_version` ("A custom PHP application has no version to check: leave application_version out."): `application: php` takes no version.
- 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_target_facts_get",
  "arguments": {
    "site_id": 4211,
    "application": "magento2",
    "application_version": "2.4.7-p3"
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_site_target_facts_get with site_id 4211, application magento2, application_version 2.4.7-p3. (Read a migration target's facts.) Tell me what it returned.
```

## The same task elsewhere

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