---
title: "corestack_company_ssh_key_list"
url: https://docs.corefinity.com/mcp/tools/corestack_company_ssh_key_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_company_ssh_key_list

**List company SSH keys.** List your company's SSH keys, the sites each one reaches, the limits and any change still applying. Scope: read.

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

## When to use it

List your company's SSH keys, the sites each one reaches, the limits and any change still applying.

`can_add` says whether your role may add a company key, `{available, reason}`: without the Create Company SSH Keys permission it is unavailable, and `reason` is the sentence adding one would refuse with (the permission and who can grant it).

The keys keep this tool's earlier shape: `pending_sites` are the sites a key has not reached yet. For where a key works on every environment it reaches, CoreStack Enterprise included (`applied` of `total`, `waiting` for the one-time switch-over or a platform update, a removal's `removed`, and `not_on_new_system` for the environments not on the new system yet, which `total` leaves out), use `corestack_ssh_keys_list` with `my_company`.

## Inputs

None.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {},
  "type": "object"
}
```

## Refusals

- `forbidden`: the person's role lacks the View Company SSH Keys permission. The message names it and says an owner of
  the company can grant it in Roles; `details.permission` is `viewCompanySSHKeys`.
- 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).

## Example

```json
{
  "name": "corestack_company_ssh_key_list",
  "arguments": {}
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_company_ssh_key_list. (List company 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)
