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

**List Legacy SSH keys.** Lists a company's Legacy SSH keys (from the old shared list, which stop working at the cut-off): last use, CI hints, placement and end date, optionally for one environment. Keep the ones still needed with corestack_ssh_legacy_key_keep. Scope: read.

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

## When to use it

List a company's Legacy keys — the old shared list's, which stop working at the cut-off — with last use, CI hints, placement and end date. Keep the ones still needed with corestack_ssh_legacy_key_keep.

Each environment group carries `not_on_new_system`: `true` when the environment is not on the new system yet. Do not promise it a switch-over date; a removal there is recorded now and takes effect once it is on the new system.

## Inputs

- `my_company` (boolean): `true` for your own company. Give this or `client_company_id`.
- `client_company_id` (integer): a client company your agency reaches.
- `enterprise_env_id` (integer): only this CoreStack Enterprise environment's Legacy keys.
- `site_id` (integer): only this CoreStack or CoreCluster environment row's Legacy keys.
- `cursor` (string): `next_cursor` from the previous page.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "client_company_id": {
      "description": "A client company your agency reaches.",
      "minimum": 1,
      "type": "integer"
    },
    "cursor": {
      "description": "next_cursor from the previous page.",
      "maxLength": 200,
      "type": "string"
    },
    "enterprise_env_id": {
      "description": "A CoreStack Enterprise environment's id (environment.id in corestack_ssh_keys_list); for CoreStack or CoreCluster give site_id.",
      "minimum": 1,
      "type": "integer"
    },
    "my_company": {
      "description": "true: your own company (the token's).",
      "type": "boolean"
    },
    "site_id": {
      "description": "Only this CoreStack or CoreCluster environment row's Legacy keys.",
      "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`: SSH keys are not switched on for this object yet.
- `enterprise_panel_only`: SSH keys for CoreStack Enterprise environments are managed in the Control Panel only at the moment.

## Example

```json
{
  "name": "corestack_ssh_legacy_list",
  "arguments": {
    "my_company": true
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_ssh_legacy_list with my_company true. (List Legacy SSH keys.) Tell me what it returned.
```

## The same task elsewhere

- Guide: [SSH keys](https://docs.corefinity.com/guides/sites/access-and-security/ssh-keys.md)
