Manage members
manage_membersAsk to invite someone to a project, change a member's role, or remove a member. To see who is on it use list_project_items item members. No call changes membership itself: each files a request that the person behind this token, an owner of the project, confirms in the web app with a second factor; the server then makes exactly that change, once. Show approveUrl to the user, then call get_access_requests with the request id and wait; it answers done once the change is made. Actions (arguments besides action, project and reason):
invite (email, role): an invitation is emailed once confirmed; the person joins when they accept it.
set_role (member, role) and remove (member): member is an id from list_project_items item members, or the member's email. Removing a member also ends their agents' access to the project. Errors are messages: a member not on the project, inviting a current member, changing a member who only sees shared items, removing or demoting the last owner, an archived project, a server that cannot send email, too many requests waiting, a CI job's token, and, where billing is on, an organisation not on Pro. Audited. Needs projects:write, the owner role and full access to the project.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>",
"project": "<project>",
"reason": "<reason>"
},
"name": "manage_members"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | No | invite, set_role: reader (reads), editor (also writes) or owner (also manages members and settings) | |
| No | invite only: the address the invitation goes to | ||
| action | Yes | What to ask for | |
| member | No | set_role, remove: the member's user id (id from list_project_items item members) or their email | |
| reason | Yes | One sentence the owner reads when confirming: what you are doing and why | |
| project | Yes | Project slug from list_projects, e.g. my-app, or its id (a UUID) | |
| answer_within | No | Minutes the owner has to confirm (1 to 60, default 10) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| next | No | delete (manage_projects), invite, set_role, remove: what to do next | |
| action | No | delete (manage_projects), invite, set_role, remove: the change the owner is asked to confirm (kind, plus email, userId and role where they apply) | |
| status | No | delete (manage_projects), invite, set_role, remove: always "pending" here | |
| request | No | delete (manage_projects), invite, set_role, remove: the request id to pass to get_access_requests | |
| answerBy | No | delete (manage_projects), invite, set_role, remove: when the request expires unanswered | |
| approveUrl | No | delete (manage_projects), invite, set_role, remove: show this to the user; they confirm there with a second factor |