---
title: "tool si.act.membership"
description: "the person's address, and the roles with where each is held: the membership."
section: reference
address: /reference/tools/si-act-membership
contract: 0476e35e6e275db5
---

# tool si.act.membership

the person's address, and the roles with where each is held: the membership.

[figure: Over MCP, si.act.membership takes MembershipInput and returns a card whose body is Membership.]

the membership. The call needs the act grant at the tenant rung.



| | |
|---|---|
| input | [MembershipInput](/concepts/membershipinput) |
| result | a card whose body is [Membership](/concepts/membership) |
| read-only | no |
| destructive | yes |
| card address | `ui://scale-intelligence/cards/Membership` |
| HTTP route | [`/v1/act/membership`](/reference/act/membership) |





| field | type | required | note |
|---|---|---|---|
| `user` | `id` | no |  |
| `mail` | `address` | no | to invite |
| `tenant` | `id` | yes |  |
| `do` | `one of invite \| suspend \| remove` | yes |  |
| `kind` | `one of member \| guest` | no |  |