---
title: "corestack_team_roles_list"
url: https://docs.corefinity.com/mcp/tools/corestack_team_roles_list
type: tool
last_updated: 2026-11-13
feature: team
related:
  - https://docs.corefinity.com/api/reference/organisation/list-team-roles.md
  - https://docs.corefinity.com/guides/organisation/people/users-and-invitations.md
---
# corestack_team_roles_list

**Roles.** List the roles in your company (standard and custom), the permissions each one gives, and which ones you may give a team member. Scope: read.

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

## When to use it

List the roles in your company, as Company › Roles shows them: your company's custom roles and the standard roles for
your kind of company, each with the permissions it gives and `assignable`, whether you may give it to a team member.
The same list as `GET /api/team/roles`.

## Inputs

None.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {},
  "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).

## Example

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

## Prompt

```text
Using the Corefinity MCP server, call corestack_team_roles_list. (Roles.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [GET /api/team/roles](https://docs.corefinity.com/api/reference/organisation/list-team-roles.md)
- Guide: [Users and invitations](https://docs.corefinity.com/guides/organisation/people/users-and-invitations.md)
