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

**Ask for a wider range.** Ask Corefinity to approve a range wider than /24 (IPv6 /48) on the firewall, with the reason; it waits as pending_approval until staff approve or reject it. Scope: write.

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

## When to use it

Ask Corefinity to approve a range wider than self-service allows (IPv4 /9 to /23, IPv6 /9 to /47). It waits as `pending_approval` in corestack_firewall_list until staff approve or reject it (with their reason). Ten an hour.

## Inputs

- `owner` (object, required) — `{type, id}`: `environment` (its `environment.id`), `website`, `company`, or `user` (your own id)
- `address` (string, required)
- `justification` (string, required, ≤ 500): why the range is needed
- `scope` (string: `both` · `ssh` · `web`; default `both`) — as corestack_firewall_entry_add
- `expires_in_days` (integer: 1 · 30 · 90 · 365); leave it out for no expiry

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "address": {
      "description": "A range wider than self-service allows: IPv4 /9 to /23 or IPv6 /9 to /47.",
      "maxLength": 64,
      "minLength": 2,
      "type": "string"
    },
    "expires_in_days": {
      "description": "Remove the address after 1, 30, 90 or 365 days. Leave it out for no expiry.",
      "enum": [
        1,
        30,
        90,
        365
      ],
      "type": "integer"
    },
    "justification": {
      "description": "Why this range is needed; Corefinity staff read it.",
      "maxLength": 500,
      "minLength": 1,
      "type": "string"
    },
    "owner": {
      "additionalProperties": false,
      "description": "Where the address is added: an environment, a website, a company, or user (your own id: every environment you can reach).",
      "properties": {
        "id": {
          "minimum": 1,
          "type": "integer"
        },
        "type": {
          "enum": [
            "environment",
            "website",
            "company",
            "user"
          ],
          "type": "string"
        }
      },
      "required": [
        "type",
        "id"
      ],
      "type": "object"
    },
    "scope": {
      "description": "What the address may reach: both (default), ssh only or web only (the website's HTTP authentication and maintenance page).",
      "enum": [
        "both",
        "ssh",
        "web"
      ],
      "type": "string"
    }
  },
  "required": [
    "owner",
    "address",
    "justification"
  ],
  "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).
- `switched_off`: the firewall is not available for this object yet.
- `firewall_width_refused`: /8 or wider, never accepted.

## Example

```json
{
  "name": "corestack_firewall_range_request",
  "arguments": {
    "owner": {
      "type": "company",
      "id": 31
    },
    "address": "198.51.100.0/22",
    "justification": "Our office block"
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_firewall_range_request with owner {"type":"company","id":31}, address 198.51.100.0/22, justification Our office block. (Ask for a wider range.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [POST /api/firewall/range-requests](https://docs.corefinity.com/api/reference/firewall/create-firewall-range-request.md)
- Guide: [Firewall](https://docs.corefinity.com/guides/sites/access-and-security/firewall.md)
