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

**Add my address.** Add the address this call comes from to the firewall — for you, this environment, its website or your company — so you can connect over SSH (a key is still needed) and skip the website's HTTP authentication and maintenance page. Scope: write. Long-running: answers with a task.

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

## When to use it

Add the address this call comes from — never one you name — so you can connect over SSH (a key is still needed) and skip the website's HTTP authentication and maintenance page. Pick the level: `me` (every environment you can reach), `environment`, `website` or `company`. Already allowed → `present: true`. Long-running: answers with a task that completes once every environment has applied it.

## 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
- `level` (string, required): `me`, `environment`, `website` or `company`
- `expires_in_days` (integer): 1, 30, 90 or 365; leave it out for no expiry
- `comment` (string, ≤ 200)

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "comment": {
      "description": "A note shown beside the address (at most 200 characters).",
      "maxLength": 200,
      "type": "string"
    },
    "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"
    },
    "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"
    },
    "level": {
      "description": "Who the address is added for: me (every environment you can reach), this environment, this website or your company.",
      "enum": [
        "me",
        "environment",
        "website",
        "company"
      ],
      "type": "string"
    },
    "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"
    }
  },
  "required": [
    "level"
  ],
  "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_address_refused`: the address this call comes from cannot be added (a shared provider range).

## Example

```json
{
  "name": "corestack_firewall_my_ip_add",
  "arguments": {
    "site_id": 4211,
    "level": "environment",
    "expires_in_days": 30
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_firewall_my_ip_add with site_id 4211, level environment, expires_in_days 30. (Add my address.) Tell me what it returned.
```

## The same task elsewhere

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