---
title: "corestack_site_magento_stores_list"
url: https://docs.corefinity.com/mcp/tools/corestack_site_magento_stores_list
type: tool
last_updated: 2026-11-13
feature: magento-stores
related:
  - https://docs.corefinity.com/api/reference/domains/list-site-magento-stores.md
  - https://docs.corefinity.com/guides/sites/go-live/magento-stores.md
---
# corestack_site_magento_stores_list

**Magento stores.** Read a Magento 2 site's websites and store views, their addresses, base URLs and warnings, with the versions needed to change which store an address shows. At most a minute old. Scope: read.

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

## When to use it

Read a Magento 2 site's websites and store views before choosing which address shows each one. The answer includes
active state, shown_on, base URLs, default_store, default_hosts (addresses using the default), nginx_version,
domains_version, warnings, read_at and store_hosts. The store
snapshot is at most a minute old. Each website stays on the same Control Panel site as the rest of its Magento install.

Each website has `id`, `code`, `name`, `default_group_id`, `is_default`, `active`, `shown_on`, `base_url`,
`base_url_elsewhere`, `base_url_own` and `store_views`. A store view has `id`, `code`, `name`, `website_id`, `group_id`, `is_active`,
`active`, `shown_on`, `base_url`, `base_url_elsewhere` and `base_url_own`. Missing names are empty strings, missing group ids are `0`
and a missing `is_default` is `false`. `default_store` is `{code, type}` or `null`; `default_hosts` is always a list.

`base_url_own` is a boolean: `true` when the effective secure base URL's host is the site's preview address, primary
domain or its www form, so it moves automatically when the store gets a domain. It is `false` for another host or
when no base URL is known. Use this decision from the read rather than rebuilding a host list. `base_url_elsewhere`
separately says whether the base URL's host is outside the addresses showing that store.

After the store change completes and before changing DNS:

Request `/` with `corestack_site_smoke_test`, setting `host` to the store domain. The final URL must be on that
store's `base_url` host from `corestack_site_magento_stores_list` (the domain itself, or its bare or `www` form
when the base URL uses it), and the title must be that store's. Magento redirects to the store's base URL; a
redirect to any other host means its base URL points elsewhere.
GraphQL picks its store from the `Store` header, so it cannot prove a domain's store.

## Inputs

- `site_id` (integer, at least 1, required): The site or one of its environments.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "site_id": {
      "description": "The site or one of its environments.",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "site_id"
  ],
  "type": "object"
}
```

## Refusals

- `not_magento`: this row is not a Magento 2 site.
- `switched_off`: site commands are switched off; try later.
- `not_running`: the environment is not running; wait for it to become ready.
- `command_running`: another command is running on the site; wait for it.
- `exec_unresolved`: a previous command has not been confirmed stopped; contact support.
- `upstream_unavailable`: Magento's stores could not be read; try again in a moment.
- `temporarily_unavailable`: the read cannot finish safely in this call; try again in a moment.
- The refusals every tool can answer: `invalid_arguments`, `tenant_mismatch`, `scope_required`, `pin_refused`, `rate_limited`, `internal_error` (corestack://guides/how-this-server-works).

## Example

```json
{"name":"corestack_site_magento_stores_list","arguments":{"site_id":4211}}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_site_magento_stores_list with site_id 4211. (Magento stores.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [GET /api/corestack/sites/{site}/magento/stores](https://docs.corefinity.com/api/reference/domains/list-site-magento-stores.md)
- Guide: [Magento stores on separate domains](https://docs.corefinity.com/guides/sites/go-live/magento-stores.md)
