---
title: "tool si.read.roles"
description: "nothing, or one role: the register of roles: each role's side, what it does, what it hands on, which connection holds it, and whether its holder can be a lead."
section: reference
address: /reference/tools/si-read-roles
contract: 0476e35e6e275db5
---

# tool si.read.roles

nothing, or one role: the register of roles: each role's side, what it does, what it hands on, which connection holds it, and whether its holder can be a lead.

[figure: Over MCP, si.read.roles takes RolesInput and returns a card whose body is [RoleAroundADecision].]

the register of roles: each role's side, what it does, what it hands on, which connection holds it, and whether its holder can be a lead. The call needs the read grant at the brand rung.



| | |
|---|---|
| input | [RolesInput](/concepts/rolesinput) |
| result | a card whose body is [RoleAroundADecision](/concepts/rolearoundadecision) |
| read-only | yes |
| destructive | no |
| card address | `ui://scale-intelligence/cards/RoleAroundADecision` |
| HTTP route | [`/v1/read/roles`](/reference/read/roles) |





| field | type | required | note |
|---|---|---|---|
| `role` | `text` | no |  |