Skip to content

Commit e9de64d

Browse files
committed
brainkb skill: add admin user-management (activate, roles/groups, onboarding)
Section 9: admin actions on the usermanagement service — list users, available roles, activate/deactivate, assign/remove role (Admin/Lab Member/External), create a new group; note Globus/OAuth onboarding auto-creates profiles.
1 parent aa78d39 commit e9de64d

1 file changed

Lines changed: 18 additions & 0 deletions

File tree

skills/brainkb_skills/SKILL.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -161,6 +161,24 @@ Call `brainkb_login(email, password, base_url?)`. Confirm with `brainkb_whoami()
161161
- Remove: `brainkb_remove_access_rule(slug, rule_id)`.
162162
- Owner and Admin/SuperAdmin always bypass rules (no lockout).
163163

164+
### 9. Admin: manage users, roles & activation (usermanagement service)
165+
These act on the **usermanagement service** (a separate service with its own
166+
token) and require the caller to hold an **Admin/SuperAdmin** role. They work when
167+
the MCP has credentials (env auto-login, or `brainkb_login(email, password)` — an
168+
OAuth-only session can't log into usermanagement).
169+
- Onboarding: users are usually created by **first login via Globus/ORCID/GitHub**
170+
(auto-creates their profile + a default `Curator` role). Admins then adjust.
171+
- Inspect: `brainkb_list_users(q, role)` · `brainkb_available_roles()`.
172+
- Activate/deactivate an account: `brainkb_activate_user(email)` /
173+
`brainkb_deactivate_user(email)`.
174+
- Assign / remove a role (= permission group: Admin, Lab Member, External, …):
175+
`brainkb_assign_role(email, role)` / `brainkb_remove_role(email, role)`
176+
(the user must have a profile — i.e. have signed in once).
177+
- New group: `brainkb_create_role("External", "Community", "External collaborators")`
178+
then `brainkb_assign_role(email, "External")`.
179+
- KG-specific capabilities (create team spaces, etc.) are granted with the
180+
query_service admin tools — see §8.
181+
164182
## Typical end-to-end
165183

166184
1. `brainkb_login(...)`

0 commit comments

Comments
 (0)