Skip to content
MCP tools
View as Markdown
Read-onlyVerticals & rolesMCP tool

role_lookup

Get full details about a specific user role by its key.

Get full details about a specific user role by its key. Returns the role's vertical mapping, scope level, description, and whether it allows login. Use this to understand what a specific role key means and what vertical/authorization tier it belongs to. Works for both active and legacy (deprecated) roles.

Parameters#

ParameterTypeRequiredDescription
role_keystringYesThe role key to look up (e.g., "broker", "plumber", "home_inspector", "transaction_coordinator")

Example prompts#

  • "What exactly does the transaction coordinator role allow, and what scope level is it?"
  • "Is the plumber role loginable, and what vertical is it mapped to?"

Safety#

Read-only. This tool never changes your data — it only looks things up. Safe to run anytime.