---
title: "corestack_firewall_list"
url: https://docs.corefinity.com/mcp/tools/corestack_firewall_list
type: tool
last_updated: 2026-11-13
feature: firewall
related:
  - https://docs.corefinity.com/guides/sites/access-and-security/firewall.md
---
# corestack_firewall_list

**Show the firewall.** Show every address allowed to reach an environment (SSH, and the website past HTTP authentication and maintenance), a website, a company or yourself — where each comes from, who added it, its comment, expiry, scope and status — and whether the address this call came from can connect. Scope: read.

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

## When to use it

Show every address allowed to reach an environment over SSH, or to see its website past HTTP authentication and the maintenance page — or the addresses of a website, your company, a client company your agency reaches, or your own — with where each comes from (agency, company, website, environment, user, preset), who added it, its comment, expiry, scope and status. `your_address` says whether the address this call came from can connect (for a hosted client that is the provider's address).

## Inputs

- `site_id` (integer, ≥ 1) — a CoreStack or CoreCluster environment row, or
- `enterprise_env_id` (integer, ≥ 1) — a CoreStack Enterprise environment (its `environment.id`); give exactly one
- `website_id` (integer, ≥ 1) — a website: its own entries and those inherited from above it, or
- `my_company` (boolean, true) — your own company, or
- `client_company_id` (integer, ≥ 1) — a client company you reach as an agency, or
- `me` (boolean, true) — your own user-level addresses

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "client_company_id": {
      "description": "A client company your agency reaches.",
      "minimum": 1,
      "type": "integer"
    },
    "enterprise_env_id": {
      "description": "A CoreStack Enterprise environment's id (environment.id in corestack_firewall_list). Give this or site_id.",
      "minimum": 1,
      "type": "integer"
    },
    "me": {
      "description": "Your own user-level addresses.",
      "enum": [
        true
      ],
      "type": "boolean"
    },
    "my_company": {
      "description": "Your own company.",
      "enum": [
        true
      ],
      "type": "boolean"
    },
    "site_id": {
      "description": "A CoreStack or CoreCluster environment row's site_id, as the other corestack tools take it. Give this or enterprise_env_id.",
      "minimum": 1,
      "type": "integer"
    },
    "website_id": {
      "description": "A website's id. Give exactly one of site_id, enterprise_env_id, website_id, my_company, client_company_id or me.",
      "minimum": 1,
      "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).
- `switched_off`: the firewall is not available for this object yet.

## Example

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

## Prompt

```text
Using the Corefinity MCP server, call corestack_firewall_list with site_id 4211. (Show the firewall.) Tell me what it returned.
```

## The same task elsewhere

- Guide: [Firewall](https://docs.corefinity.com/guides/sites/access-and-security/firewall.md)
