Groups

User-created groups/guilds with configurable visibility, member limits, and roles.

Groups let users form communities within your app. They support public/private visibility, configurable member limits, and role-based membership.

SDK usage

Create a group

const group = await client.groups.create({
  name: 'Fitness Warriors',
  description: 'A group for fitness enthusiasts',
  is_public: true,
  max_members: 50,
});

Search public groups

const groups = await client.groups.search({ q: 'fitness', limit: 20 });

Join/leave a group

await client.groups.join('group_xxx');
await client.groups.leave('group_xxx');

Get my groups

const myGroups = await client.groups.getMine();
// Returns: [{ role: "owner", groups: { name: "Fitness Warriors", ... } }]

List group members

const members = await client.groups.getMembers('group_xxx');

Client API reference

Method	Path	Description
`POST`	`/client/groups`	Create a group
`GET`	`/client/groups/mine`	List user's groups
`GET`	`/client/groups/search`	Search public groups
`POST`	`/client/groups/:id/join`	Join a group
`POST`	`/client/groups/:id/leave`	Leave a group
`GET`	`/client/groups/:id/members`	List group members

MCP tools

Tool	Description
`amba_create_group`	Create a group with name, visibility, and max members
`amba_list_groups`	List all groups in a project

Example

Agent: "Create a VIP group for premium users"

amba_create_group({
  project_id: "proj_xxx",
  name: "VIP Lounge",
  owner_id: "admin_user_xxx",
  description: "Exclusive group for premium members",
  is_public: false,
  max_members: 500
})

Database tables

Table	Purpose
`groups`	Group definitions with name, visibility, metadata
`group_members`	Membership records with user ID, group ID, and role

On this page