Skip to main content
The 3ngram MCP server exposes the following teams tools. Every entry is generated from the tool’s source signature and docstring, so this page never drifts from the backend.
Required parameters are marked with the required attribute. Optional parameters show their default value.

manage_team

Manage Team · writes · destructive · idempotent · closed-world Manage team lifecycle: create, add/remove members, list, or delete. Team primitives backing team-scoped memory sharing. Modes:
  • create: create a team named name owned by the caller (who becomes an active admin). Returns the new team_id.
  • add_member: add member_id (a user UUID) to team_id with role (admin or member). Caller must be the team creator or an active admin. Idempotent for an already-active member.
  • list_members: list active members of team_id the caller can see.
  • remove_member: soft-remove member_id from team_id (audit history is preserved; the member immediately loses team-share access). Caller must be the team creator or an active admin. The team’s last active admin cannot be removed — delete the team instead.
  • delete: permanently delete team_id and cascade-remove its members, per-memory shares, whole-scope shares, and share denials. Caller must be the team creator or an active admin. Irreversible.
Returns: str Source: backend/src/engram/mcp/tools/teams.py

Parameters

mode
Literal['create', 'add_member', 'list_members', 'remove_member', 'delete']
required
One of create, add_member, list_members, remove_member, delete.
name
str | None
default:"None"
Team name. Required for mode=‘create’.
team_id
str | None
default:"None"
Target team UUID. Required for every mode except create.
member_id
str | None
default:"None"
User UUID. Required for add_member / remove_member.
role
str
default:"'member'"
Role for the new member (admin or member). Defaults to member.