Read-onlyVerticals & rolesMCP tool
roles_list
List all user roles in the platform role registry.
List all user roles in the platform role registry. Use to understand what a role can do before assigning it, or to enumerate the roles available in a vertical. Each role maps to exactly one vertical and has a scope_level (admin, brokerage, team, standard) that determines its authorization tier. Filterable by vertical key (e.g., "inspection" returns 16 roles) or scope_level (e.g., "brokerage" returns broker-level roles). Returns role key, vertical_key, vertical_label, label, description, scope_level, and is_loginable. There are roughly 80 active roles across 12 verticals.
Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
vertical | string | No | Filter by vertical key (e.g., "real_estate", "inspection", "home_services", "lending"). Leave empty for all roles. |
scope_level | enum | No | Filter by scope level. "admin" = full system access, "brokerage" = brokerage-wide, "team" = team-wide, "standard" = own data. · One of: admin, brokerage, team, standard |
Example prompts#
- "List all brokerage-level roles across the platform."
- "What roles exist in the inspection vertical?"
Safety#
Read-only. This tool never changes your data — it only looks things up. Safe to run anytime.