---
title: "corestack_company_clients_list"
url: https://docs.corefinity.com/mcp/tools/corestack_company_clients_list
type: tool
last_updated: 2026-11-13
feature: agency-links
related:
  - https://docs.corefinity.com/guides/agencies/client-organisations-and-the-switcher.md
---
# corestack_company_clients_list

**Your agency's clients.** List your agency's client companies, by name, and whether you may detach them. Scope: read.

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

## When to use it

List your agency's client companies: the companies your people can work on through their link to your agency. Use it
before detaching a client with `corestack_company_client_detach`. Needs the `read` scope. The same as the client rows of
the Organisations list in the Control Panel and `GET /api/company/clients`.

Each client is listed by `id` and `name`; a client that no longer exists is listed as "Removed company" and can still be
detached. `can_detach` is true when you may detach a client: you are one of your agency's owners and the agency is not
archived. A company that is not an agency has no clients, so the list is empty.

## Inputs

None.

### Input schema

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

## Refusals

- `pin_refused`: a token limited to some sites cannot read company-wide links; ask the token's creator or a company owner
  to let it work everywhere in your company.
- 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_clients_list",
  "arguments": {}
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_company_clients_list. (Your agency's clients.) Tell me what it returned.
```

## The same task elsewhere

- Guide: [Client organisations and the switcher](https://docs.corefinity.com/guides/agencies/client-organisations-and-the-switcher.md)
