---
title: "corestack_websites_list"
url: https://docs.corefinity.com/mcp/tools/corestack_websites_list
type: tool
last_updated: 2026-11-13
feature: enterprise-websites
related:
  - https://docs.corefinity.com/guides/corestack-enterprise/websites-and-environments.md
---
# corestack_websites_list

**Websites.** Your company's websites — CoreStack, CoreCluster and CoreStack Enterprise — each with its environments, their state, pending changes and attention, filtered, sorted and paged like the Websites page. A CoreStack environment's reseller_site_id is the site_id the site tools take; CoreStack Enterprise websites can be listed and read only. Scope: read.

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

## When to use it

Your company's websites — CoreStack, CoreCluster and CoreStack Enterprise — each with its environments, their state, pending changes and attention, filtered, sorted and paged like the Websites page. A CoreStack environment's reseller_site_id is the site_id the site tools take; CoreStack Enterprise websites can be listed and read only.

While migrations are available to the company, each row also carries `migration`: `{id, row_id, state, display}` when one of the website's sites is the copy of a site being moved here from another host (read it with `corestack_migration_get`), else null; `counts.migrating` is how many websites that is under the other filters, and `migrating: true` lists only those. Otherwise neither is there and `migrating` is ignored.

## Inputs

- `search` (string, up to 200 characters): Matches the website's name or URL, its company, or an environment's name or URL.
- `kind` (one of `enterprise`, `corestack`, `corecluster`, `mixed`): The product the website's production environment runs on: enterprise (CoreStack Enterprise), corestack or corecluster. Without a production environment, the product most of its environments run on, or mixed on a tie with CoreStack Enterprise.
- `status` (one of `0`, `1`, `2`, `3`): 0 Inactive, 1 Pending setup, 2 Onboarding, 3 Active.
- `platform` (string, up to 64 characters): A platform key, for example wordpress, magento2, laravel or shopware.
- `region` (one of `uk`, `us`, `nl`, `aus`)
- `cluster_id` (integer, ≥ 1): One of your CoreClusters (corecluster_list).
- `attention` (boolean): Only websites with something needing attention.
- `migrating` (boolean): Only websites with a site being moved here from another host.
- `sort` (one of `name`, `company`, `status`, `kind`, `updated`, default `"updated"`)
- `dir` (one of `asc`, `desc`, default `"desc"`)
- `page` (integer, 1–100000, default `1`)
- `per_page` (one of `25`, `50`, `100`, default `25`)

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "attention": {
      "description": "Only websites with something needing attention.",
      "type": "boolean"
    },
    "cluster_id": {
      "description": "One of your CoreClusters (corecluster_list).",
      "minimum": 1,
      "type": "integer"
    },
    "dir": {
      "default": "desc",
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string"
    },
    "kind": {
      "description": "The product the website's production environment runs on: enterprise (CoreStack Enterprise), corestack or corecluster. Without a production environment, the product most of its environments run on, or mixed on a tie with CoreStack Enterprise.",
      "enum": [
        "enterprise",
        "corestack",
        "corecluster",
        "mixed"
      ],
      "type": "string"
    },
    "migrating": {
      "description": "Only websites with a site being moved here from another host.",
      "type": "boolean"
    },
    "page": {
      "default": 1,
      "maximum": 100000,
      "minimum": 1,
      "type": "integer"
    },
    "per_page": {
      "default": 25,
      "enum": [
        25,
        50,
        100
      ],
      "type": "integer"
    },
    "platform": {
      "description": "A platform key, for example wordpress, laravel, magento2, shopware5.",
      "maxLength": 64,
      "type": "string"
    },
    "region": {
      "enum": [
        "uk",
        "us",
        "nl",
        "aus"
      ],
      "type": "string"
    },
    "search": {
      "description": "Matches the website's name or URL, its company, or an environment's name or URL.",
      "maxLength": 200,
      "type": "string"
    },
    "sort": {
      "default": "updated",
      "enum": [
        "name",
        "company",
        "status",
        "kind",
        "updated"
      ],
      "type": "string"
    },
    "status": {
      "description": "0 Inactive, 1 Pending setup, 2 Onboarding, 3 Active.",
      "enum": [
        0,
        1,
        2,
        3
      ],
      "type": "integer"
    }
  },
  "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_websites_list",
  "arguments": {}
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_websites_list. (Websites.) Tell me what it returned.
```

## The same task elsewhere

- Guide: [Websites and environments](https://docs.corefinity.com/guides/corestack-enterprise/websites-and-environments.md)
