Community (opt-in)

Groups

List Groups

read-onlyidempotentopen-world

discourse_list_groups

List visible groups. Empty input exhaustively traverses the bounded directory; any explicit page or filter field preserves the existing single-page query behavior. Both modes return one structured envelope with truthful completion metadata and JSON text fallback. Opt in with the groups toolset.

List Groups

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_list_groups",
    "arguments": {
        "page": 0,
        "order": "name",
        "asc": true,
        "filter": "string",
        "username": "string",
        "type": "my"
      }
  }
}

const result = await client.callTool({
  "name": "discourse_list_groups",
  "arguments": {
    "page": 0,
    "order": "name",
    "asc": true,
    "filter": "string",
    "username": "string",
    "type": "my"
  }
});

result = await session.call_tool("discourse_list_groups", arguments={
  "page": 0,
  "order": "name",
  "asc": true,
  "filter": "string",
  "username": "string",
  "type": "my"
})

Response

{
  "groups": [
    {
      "id": 0,
      "name": "string"
    }
  ],
  "meta": {
    "total": 0,
    "reported_total": 0,
    "pages_fetched": 0,
    "complete": true,
    "has_more": true,
    "truncated_reason": "page_limit",
    "error": "string"
  },
  "total_rows_groups": 0,
  "load_more_groups": "string"
}

Parameters

pageinteger>= 0

orderstringnameuser_count

ascboolean

filterstring

usernamestring

typestringmyownerpubliccloseautomaticnon_automatic

Returns

groupsArray<object>required

Show child attributes

idintegerrequired

namestringrequired

metaobjectrequired

Show child attributes

totalinteger>= 0required

reported_totalinteger | nullrequired

Show child attributes

Any of

integer>= 0

null

pages_fetchedinteger>= 0required

completebooleanrequired

has_morebooleanrequired

truncated_reasonstringpage_limitdeadlinecancelledno_new_idstotal_mismatchlegacy_site_jsonanonymous_fallbackupstream_error

errorstring

extrasany

total_rows_groupsinteger>= 0

load_more_groupsstring | null

Get Group

discourse_get_group

Get complete visible group details by numeric ID or name, including caller capabilities and group settings.

Get Group

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_get_group",
    "arguments": {
        "id": 0,
        "name": "string"
      }
  }
}

const result = await client.callTool({
  "name": "discourse_get_group",
  "arguments": {
    "id": 0,
    "name": "string"
  }
});

result = await session.call_tool("discourse_get_group", arguments={
  "id": 0,
  "name": "string"
})

Parameters

idinteger

namestring

List Group Posts

read-onlyidempotentopen-world

discourse_list_group_posts

List visible posts authored by a group using Discourse's fixed 20-row page, ID or timestamp cursor, and optional category filter. Group authorship is cohort evidence, not proof of organizational responsibility.

List Group Posts

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_list_group_posts",
    "arguments": {
        "group_name": "string",
        "before_post_id": 0,
        "before": "2024-01-15T09:30:00Z",
        "category_id": 0
      }
  }
}

const result = await client.callTool({
  "name": "discourse_list_group_posts",
  "arguments": {
    "group_name": "string",
    "before_post_id": 0,
    "before": "2024-01-15T09:30:00Z",
    "category_id": 0
  }
});

result = await session.call_tool("discourse_list_group_posts", arguments={
  "group_name": "string",
  "before_post_id": 0,
  "before": "2024-01-15T09:30:00Z",
  "category_id": 0
})

Parameters

group_namestringrequired

before_post_idinteger

beforestring<date-time>

category_idinteger

List Group Members

discourse_list_group_members

List a group's members and owners with filtering, ordering, and pagination. Visibility is enforced by Discourse.

List Group Members

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_list_group_members",
    "arguments": {
        "name": "string",
        "limit": 1,
        "offset": 0,
        "filter": "string",
        "order": "username",
        "asc": true
      }
  }
}

const result = await client.callTool({
  "name": "discourse_list_group_members",
  "arguments": {
    "name": "string",
    "limit": 1,
    "offset": 0,
    "filter": "string",
    "order": "username",
    "asc": true
  }
});

result = await session.call_tool("discourse_list_group_members", arguments={
  "name": "string",
  "limit": 1,
  "offset": 0,
  "filter": "string",
  "order": "username",
  "asc": true
})

Parameters

namestringrequired

limitinteger[1, 1000]

offsetinteger>= 0

filterstring

orderstringusernamelast_posted_atlast_seen_atadded_at

ascboolean

List Group Membership Requests

discourse_list_group_membership_requests

List pending membership requests and reasons for a group the caller can manage, with filtering and pagination.

List Group Membership Requests

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_list_group_membership_requests",
    "arguments": {
        "name": "string",
        "limit": 1,
        "offset": 0,
        "filter": "string",
        "order": "requested_at",
        "asc": true
      }
  }
}

const result = await client.callTool({
  "name": "discourse_list_group_membership_requests",
  "arguments": {
    "name": "string",
    "limit": 1,
    "offset": 0,
    "filter": "string",
    "order": "requested_at",
    "asc": true
  }
});

result = await session.call_tool("discourse_list_group_membership_requests", arguments={
  "name": "string",
  "limit": 1,
  "offset": 0,
  "filter": "string",
  "order": "requested_at",
  "asc": true
})

Parameters

namestringrequired

limitinteger[1, 1000]

offsetinteger>= 0

filterstring

orderstring

ascboolean

Create Group

discourse_create_group

Create a custom group with complete core settings, initial members and owners, custom fields, associations, and optional plugin fields. Requires staff group-creation permission.

Create Group

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_create_group",
    "arguments": {
        "name": "string",
        "mentionable_level": 0,
        "messageable_level": 0,
        "visibility_level": 0,
        "members_visibility_level": 0,
        "automatic_membership_email_domains": "string",
        "title": "string",
        "primary_group": true,
        "grant_trust_level": 0,
        "incoming_email": "string",
        "flair_icon": "string",
        "flair_upload_id": 0,
        "flair_bg_color": "string",
        "flair_color": "string",
        "bio_raw": "string",
        "public_admission": true,
        "public_exit": true,
        "allow_membership_requests": true,
        "full_name": "string",
        "default_notification_level": 0,
        "membership_request_template": "string",
        "publish_read_state": true,
        "associated_group_ids": [
          0
        ],
        "custom_fields": {},
        "owner_usernames": [
          "string"
        ],
        "usernames": [
          "string"
        ],
        "plugin_fields": {}
      }
  }
}

const result = await client.callTool({
  "name": "discourse_create_group",
  "arguments": {
    "name": "string",
    "mentionable_level": 0,
    "messageable_level": 0,
    "visibility_level": 0,
    "members_visibility_level": 0,
    "automatic_membership_email_domains": "string",
    "title": "string",
    "primary_group": true,
    "grant_trust_level": 0,
    "incoming_email": "string",
    "flair_icon": "string",
    "flair_upload_id": 0,
    "flair_bg_color": "string",
    "flair_color": "string",
    "bio_raw": "string",
    "public_admission": true,
    "public_exit": true,
    "allow_membership_requests": true,
    "full_name": "string",
    "default_notification_level": 0,
    "membership_request_template": "string",
    "publish_read_state": true,
    "associated_group_ids": [
      0
    ],
    "custom_fields": {},
    "owner_usernames": [
      "string"
    ],
    "usernames": [
      "string"
    ],
    "plugin_fields": {}
  }
});

result = await session.call_tool("discourse_create_group", arguments={
  "name": "string",
  "mentionable_level": 0,
  "messageable_level": 0,
  "visibility_level": 0,
  "members_visibility_level": 0,
  "automatic_membership_email_domains": "string",
  "title": "string",
  "primary_group": true,
  "grant_trust_level": 0,
  "incoming_email": "string",
  "flair_icon": "string",
  "flair_upload_id": 0,
  "flair_bg_color": "string",
  "flair_color": "string",
  "bio_raw": "string",
  "public_admission": true,
  "public_exit": true,
  "allow_membership_requests": true,
  "full_name": "string",
  "default_notification_level": 0,
  "membership_request_template": "string",
  "publish_read_state": true,
  "associated_group_ids": [
    0
  ],
  "custom_fields": {},
  "owner_usernames": [
    "string"
  ],
  "usernames": [
    "string"
  ],
  "plugin_fields": {}
})

Request Body

{
  "name": "string",
  "mentionable_level": 0,
  "messageable_level": 0,
  "visibility_level": 0,
  "members_visibility_level": 0,
  "automatic_membership_email_domains": "string",
  "title": "string",
  "primary_group": true,
  "grant_trust_level": 0,
  "incoming_email": "string",
  "flair_icon": "string",
  "flair_upload_id": 0,
  "flair_bg_color": "string",
  "flair_color": "string",
  "bio_raw": "string",
  "public_admission": true,
  "public_exit": true,
  "allow_membership_requests": true,
  "full_name": "string",
  "default_notification_level": 0,
  "membership_request_template": "string",
  "publish_read_state": true,
  "associated_group_ids": [
    0
  ],
  "custom_fields": {},
  "owner_usernames": [
    "string"
  ],
  "usernames": [
    "string"
  ],
  "plugin_fields": {}
}

Body

application/json

namestringrequired

mentionable_levelinteger[0, 4]

messageable_levelinteger[0, 4]

visibility_levelinteger[0, 4]

members_visibility_levelinteger[0, 4]

automatic_membership_email_domainsstring

titlestring | null

primary_groupboolean

grant_trust_levelinteger | null

Show child attributes

Any of

integer[0, 4]

null

incoming_emailstring | null

flair_iconstring | null

flair_upload_idinteger | null

Show child attributes

Any of

integer

null

flair_bg_colorstring | null

flair_colorstring | null

bio_rawstring | null

Show child attributes

Any of

string

null

public_admissionboolean

public_exitboolean

allow_membership_requestsboolean

full_namestring | null

default_notification_levelinteger[0, 3]

membership_request_templatestring | null

Show child attributes

Any of

string

null

publish_read_stateboolean

associated_group_idsArray<integer>

custom_fieldsobject

Show child attributes

[key: string]any

owner_usernamesArray<string>

usernamesArray<string>

plugin_fieldsobject

Show child attributes

[key: string]any

Update Group

discourse_update_group

Update all core group profile, visibility, admission, notification-default, association, email, SMTP, custom, and plugin settings supported by the caller and group type.

Update Group

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_update_group",
    "arguments": {
        "id": 0,
        "name": "string",
        "mentionable_level": 0,
        "messageable_level": 0,
        "visibility_level": 0,
        "members_visibility_level": 0,
        "automatic_membership_email_domains": "string",
        "title": "string",
        "primary_group": true,
        "grant_trust_level": 0,
        "incoming_email": "string",
        "flair_icon": "string",
        "flair_upload_id": 0,
        "flair_bg_color": "string",
        "flair_color": "string",
        "bio_raw": "string",
        "public_admission": true,
        "public_exit": true,
        "allow_membership_requests": true,
        "full_name": "string",
        "default_notification_level": 0,
        "membership_request_template": "string",
        "publish_read_state": true,
        "associated_group_ids": [
          0
        ],
        "custom_fields": {},
        "muted_category_ids": [
          0
        ],
        "regular_category_ids": [
          0
        ],
        "tracking_category_ids": [
          0
        ],
        "watching_category_ids": [
          0
        ],
        "watching_first_post_category_ids": [
          0
        ],
        "muted_tags": [
          "string"
        ],
        "regular_tags": [
          "string"
        ],
        "tracking_tags": [
          "string"
        ],
        "watching_tags": [
          "string"
        ],
        "watching_first_post_tags": [
          "string"
        ],
        "smtp_server": "string",
        "smtp_port": 0,
        "smtp_ssl_mode": 0,
        "smtp_enabled": true,
        "email_username": "string",
        "email_password": "string",
        "email_from_alias": "string",
        "allow_unknown_sender_topic_replies": true,
        "update_existing_users": true,
        "plugin_fields": {}
      }
  }
}

const result = await client.callTool({
  "name": "discourse_update_group",
  "arguments": {
    "id": 0,
    "name": "string",
    "mentionable_level": 0,
    "messageable_level": 0,
    "visibility_level": 0,
    "members_visibility_level": 0,
    "automatic_membership_email_domains": "string",
    "title": "string",
    "primary_group": true,
    "grant_trust_level": 0,
    "incoming_email": "string",
    "flair_icon": "string",
    "flair_upload_id": 0,
    "flair_bg_color": "string",
    "flair_color": "string",
    "bio_raw": "string",
    "public_admission": true,
    "public_exit": true,
    "allow_membership_requests": true,
    "full_name": "string",
    "default_notification_level": 0,
    "membership_request_template": "string",
    "publish_read_state": true,
    "associated_group_ids": [
      0
    ],
    "custom_fields": {},
    "muted_category_ids": [
      0
    ],
    "regular_category_ids": [
      0
    ],
    "tracking_category_ids": [
      0
    ],
    "watching_category_ids": [
      0
    ],
    "watching_first_post_category_ids": [
      0
    ],
    "muted_tags": [
      "string"
    ],
    "regular_tags": [
      "string"
    ],
    "tracking_tags": [
      "string"
    ],
    "watching_tags": [
      "string"
    ],
    "watching_first_post_tags": [
      "string"
    ],
    "smtp_server": "string",
    "smtp_port": 0,
    "smtp_ssl_mode": 0,
    "smtp_enabled": true,
    "email_username": "string",
    "email_password": "string",
    "email_from_alias": "string",
    "allow_unknown_sender_topic_replies": true,
    "update_existing_users": true,
    "plugin_fields": {}
  }
});

result = await session.call_tool("discourse_update_group", arguments={
  "id": 0,
  "name": "string",
  "mentionable_level": 0,
  "messageable_level": 0,
  "visibility_level": 0,
  "members_visibility_level": 0,
  "automatic_membership_email_domains": "string",
  "title": "string",
  "primary_group": true,
  "grant_trust_level": 0,
  "incoming_email": "string",
  "flair_icon": "string",
  "flair_upload_id": 0,
  "flair_bg_color": "string",
  "flair_color": "string",
  "bio_raw": "string",
  "public_admission": true,
  "public_exit": true,
  "allow_membership_requests": true,
  "full_name": "string",
  "default_notification_level": 0,
  "membership_request_template": "string",
  "publish_read_state": true,
  "associated_group_ids": [
    0
  ],
  "custom_fields": {},
  "muted_category_ids": [
    0
  ],
  "regular_category_ids": [
    0
  ],
  "tracking_category_ids": [
    0
  ],
  "watching_category_ids": [
    0
  ],
  "watching_first_post_category_ids": [
    0
  ],
  "muted_tags": [
    "string"
  ],
  "regular_tags": [
    "string"
  ],
  "tracking_tags": [
    "string"
  ],
  "watching_tags": [
    "string"
  ],
  "watching_first_post_tags": [
    "string"
  ],
  "smtp_server": "string",
  "smtp_port": 0,
  "smtp_ssl_mode": 0,
  "smtp_enabled": true,
  "email_username": "string",
  "email_password": "string",
  "email_from_alias": "string",
  "allow_unknown_sender_topic_replies": true,
  "update_existing_users": true,
  "plugin_fields": {}
})

Request Body

{
  "id": 0,
  "name": "string",
  "mentionable_level": 0,
  "messageable_level": 0,
  "visibility_level": 0,
  "members_visibility_level": 0,
  "automatic_membership_email_domains": "string",
  "title": "string",
  "primary_group": true,
  "grant_trust_level": 0,
  "incoming_email": "string",
  "flair_icon": "string",
  "flair_upload_id": 0,
  "flair_bg_color": "string",
  "flair_color": "string",
  "bio_raw": "string",
  "public_admission": true,
  "public_exit": true,
  "allow_membership_requests": true,
  "full_name": "string",
  "default_notification_level": 0,
  "membership_request_template": "string",
  "publish_read_state": true,
  "associated_group_ids": [
    0
  ],
  "custom_fields": {},
  "muted_category_ids": [
    0
  ],
  "regular_category_ids": [
    0
  ],
  "tracking_category_ids": [
    0
  ],
  "watching_category_ids": [
    0
  ],
  "watching_first_post_category_ids": [
    0
  ],
  "muted_tags": [
    "string"
  ],
  "regular_tags": [
    "string"
  ],
  "tracking_tags": [
    "string"
  ],
  "watching_tags": [
    "string"
  ],
  "watching_first_post_tags": [
    "string"
  ],
  "smtp_server": "string",
  "smtp_port": 0,
  "smtp_ssl_mode": 0,
  "smtp_enabled": true,
  "email_username": "string",
  "email_password": "string",
  "email_from_alias": "string",
  "allow_unknown_sender_topic_replies": true,
  "update_existing_users": true,
  "plugin_fields": {}
}

Body

application/json

idintegerrequired

namestring

mentionable_levelinteger[0, 4]

messageable_levelinteger[0, 4]

visibility_levelinteger[0, 4]

members_visibility_levelinteger[0, 4]

automatic_membership_email_domainsstring

titlestring | null

primary_groupboolean

grant_trust_levelinteger | null

Show child attributes

Any of

integer[0, 4]

null

incoming_emailstring | null

flair_iconstring | null

flair_upload_idinteger | null

Show child attributes

Any of

integer

null

flair_bg_colorstring | null

flair_colorstring | null

bio_rawstring | null

Show child attributes

Any of

string

null

public_admissionboolean

public_exitboolean

allow_membership_requestsboolean

full_namestring | null

default_notification_levelinteger[0, 3]

membership_request_templatestring | null

Show child attributes

Any of

string

null

publish_read_stateboolean

associated_group_idsArray<integer>

custom_fieldsobject

Show child attributes

[key: string]any

muted_category_idsArray<integer>

regular_category_idsArray<integer>

tracking_category_idsArray<integer>

watching_category_idsArray<integer>

watching_first_post_category_idsArray<integer>

muted_tagsArray<string>

regular_tagsArray<string>

tracking_tagsArray<string>

watching_tagsArray<string>

watching_first_post_tagsArray<string>

smtp_serverstring | null

smtp_portinteger | null

Show child attributes

Any of

integer

null

smtp_ssl_modeinteger>= 0

smtp_enabledboolean

email_usernamestring | null

email_passwordstring | null

email_from_aliasstring | null

allow_unknown_sender_topic_repliesboolean

update_existing_usersboolean

plugin_fieldsobject

Show child attributes

[key: string]any

Delete Group

discourse_delete_group

Permanently delete a custom group. Automatic groups cannot be deleted. Requires staff access.

Delete Group

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_delete_group",
    "arguments": {
        "id": 0
      }
  }
}

const result = await client.callTool({
  "name": "discourse_delete_group",
  "arguments": {
    "id": 0
  }
});

result = await session.call_tool("discourse_delete_group", arguments={
  "id": 0
})

Parameters

idintegerrequired

Add Group Members by Username

discourse_add_group_members_by_username

Add group members using canonical usernames. This tool accepts only this identifier type, avoiding ambiguous selector precedence.

Add Group Members by Username

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_add_group_members_by_username",
    "arguments": {
        "id": 0,
        "usernames": [
          "string"
        ],
        "notify_users": true
      }
  }
}

const result = await client.callTool({
  "name": "discourse_add_group_members_by_username",
  "arguments": {
    "id": 0,
    "usernames": [
      "string"
    ],
    "notify_users": true
  }
});

result = await session.call_tool("discourse_add_group_members_by_username", arguments={
  "id": 0,
  "usernames": [
    "string"
  ],
  "notify_users": true
})

Parameters

idintegerrequired

usernamesArray<string>required

Canonical usernames of existing users; do not provide user IDs or email addresses

notify_usersboolean

Notify users added as members or owners

Add Group Members by User ID

discourse_add_group_members_by_user_id

Add group members using numeric user IDs. This tool accepts only this identifier type, avoiding ambiguous selector precedence.

Add Group Members by User ID

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_add_group_members_by_user_id",
    "arguments": {
        "id": 0,
        "user_ids": [
          0
        ],
        "notify_users": true
      }
  }
}

const result = await client.callTool({
  "name": "discourse_add_group_members_by_user_id",
  "arguments": {
    "id": 0,
    "user_ids": [
      0
    ],
    "notify_users": true
  }
});

result = await session.call_tool("discourse_add_group_members_by_user_id", arguments={
  "id": 0,
  "user_ids": [
    0
  ],
  "notify_users": true
})

Parameters

idintegerrequired

user_idsArray<integer>required

Numeric IDs of existing users; numbers must not be quoted as strings

notify_usersboolean

Notify users added as members or owners

Add Group Members by Email

discourse_add_group_members_by_email

Add group members using email addresses belonging to existing accounts. This tool accepts only this identifier type, avoiding ambiguous selector precedence.

Add Group Members by Email

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_add_group_members_by_email",
    "arguments": {
        "id": 0,
        "user_emails": [
          "user@example.com"
        ],
        "notify_users": true
      }
  }
}

const result = await client.callTool({
  "name": "discourse_add_group_members_by_email",
  "arguments": {
    "id": 0,
    "user_emails": [
      "user@example.com"
    ],
    "notify_users": true
  }
});

result = await session.call_tool("discourse_add_group_members_by_email", arguments={
  "id": 0,
  "user_emails": [
    "user@example.com"
  ],
  "notify_users": true
})

Parameters

idintegerrequired

user_emailsArray<string>required

Email addresses that already belong to user accounts; use the invitation tool for unknown addresses

notify_usersboolean

Notify users added as members or owners

Invite Group Members by Email

discourse_invite_group_members_by_email

Add existing accounts immediately when an address matches, and invite unknown addresses to the forum with this group preassigned. Use add_group_members_by_email when every address is known to belong to an account.

Invite Group Members by Email

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_invite_group_members_by_email",
    "arguments": {
        "id": 0,
        "emails": [
          "user@example.com"
        ],
        "skip_email": true
      }
  }
}

const result = await client.callTool({
  "name": "discourse_invite_group_members_by_email",
  "arguments": {
    "id": 0,
    "emails": [
      "user@example.com"
    ],
    "skip_email": true
  }
});

result = await session.call_tool("discourse_invite_group_members_by_email", arguments={
  "id": 0,
  "emails": [
    "user@example.com"
  ],
  "skip_email": true
})

Parameters

idintegerrequired

emailsArray<string>required

Email addresses to invite to the forum and add to this group after redemption

skip_emailboolean

Create invitations without sending invitation email

Remove Group Members by Username

discourse_remove_group_members_by_username

Remove group members using canonical usernames. This tool accepts only this identifier type, avoiding ambiguous selector precedence.

Remove Group Members by Username

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_remove_group_members_by_username",
    "arguments": {
        "id": 0,
        "usernames": [
          "string"
        ]
      }
  }
}

const result = await client.callTool({
  "name": "discourse_remove_group_members_by_username",
  "arguments": {
    "id": 0,
    "usernames": [
      "string"
    ]
  }
});

result = await session.call_tool("discourse_remove_group_members_by_username", arguments={
  "id": 0,
  "usernames": [
    "string"
  ]
})

Parameters

idintegerrequired

usernamesArray<string>required

Canonical usernames of existing users; do not provide user IDs or email addresses

Remove Group Members by User ID

discourse_remove_group_members_by_user_id

Remove group members using numeric user IDs. This tool accepts only this identifier type, avoiding ambiguous selector precedence.

Remove Group Members by User ID

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_remove_group_members_by_user_id",
    "arguments": {
        "id": 0,
        "user_ids": [
          0
        ]
      }
  }
}

const result = await client.callTool({
  "name": "discourse_remove_group_members_by_user_id",
  "arguments": {
    "id": 0,
    "user_ids": [
      0
    ]
  }
});

result = await session.call_tool("discourse_remove_group_members_by_user_id", arguments={
  "id": 0,
  "user_ids": [
    0
  ]
})

Parameters

idintegerrequired

user_idsArray<integer>required

Numeric IDs of existing users; numbers must not be quoted as strings

Remove Group Members by Email

discourse_remove_group_members_by_email

Remove group members using email addresses belonging to existing accounts. This tool accepts only this identifier type, avoiding ambiguous selector precedence.

Remove Group Members by Email

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_remove_group_members_by_email",
    "arguments": {
        "id": 0,
        "user_emails": [
          "user@example.com"
        ]
      }
  }
}

const result = await client.callTool({
  "name": "discourse_remove_group_members_by_email",
  "arguments": {
    "id": 0,
    "user_emails": [
      "user@example.com"
    ]
  }
});

result = await session.call_tool("discourse_remove_group_members_by_email", arguments={
  "id": 0,
  "user_emails": [
    "user@example.com"
  ]
})

Parameters

idintegerrequired

user_emailsArray<string>required

Email addresses that already belong to user accounts; use the invitation tool for unknown addresses

Add Group Owners by Username

discourse_add_group_owners_by_username

Add group owners using canonical usernames. This tool accepts only this identifier type, avoiding ambiguous selector precedence.

Add Group Owners by Username

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_add_group_owners_by_username",
    "arguments": {
        "id": 0,
        "usernames": [
          "string"
        ],
        "notify_users": true
      }
  }
}

const result = await client.callTool({
  "name": "discourse_add_group_owners_by_username",
  "arguments": {
    "id": 0,
    "usernames": [
      "string"
    ],
    "notify_users": true
  }
});

result = await session.call_tool("discourse_add_group_owners_by_username", arguments={
  "id": 0,
  "usernames": [
    "string"
  ],
  "notify_users": true
})

Parameters

idintegerrequired

usernamesArray<string>required

Canonical usernames of existing users; do not provide user IDs or email addresses

notify_usersboolean

Notify users added as members or owners

Add Group Owners by User ID

discourse_add_group_owners_by_user_id

Add group owners using numeric user IDs. This tool accepts only this identifier type, avoiding ambiguous selector precedence.

Add Group Owners by User ID

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_add_group_owners_by_user_id",
    "arguments": {
        "id": 0,
        "user_ids": [
          0
        ],
        "notify_users": true
      }
  }
}

const result = await client.callTool({
  "name": "discourse_add_group_owners_by_user_id",
  "arguments": {
    "id": 0,
    "user_ids": [
      0
    ],
    "notify_users": true
  }
});

result = await session.call_tool("discourse_add_group_owners_by_user_id", arguments={
  "id": 0,
  "user_ids": [
    0
  ],
  "notify_users": true
})

Parameters

idintegerrequired

user_idsArray<integer>required

Numeric IDs of existing users; numbers must not be quoted as strings

notify_usersboolean

Notify users added as members or owners

Add Group Owners by Email

discourse_add_group_owners_by_email

Add group owners using email addresses belonging to existing accounts. This tool accepts only this identifier type, avoiding ambiguous selector precedence.

Add Group Owners by Email

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_add_group_owners_by_email",
    "arguments": {
        "id": 0,
        "user_emails": [
          "user@example.com"
        ],
        "notify_users": true
      }
  }
}

const result = await client.callTool({
  "name": "discourse_add_group_owners_by_email",
  "arguments": {
    "id": 0,
    "user_emails": [
      "user@example.com"
    ],
    "notify_users": true
  }
});

result = await session.call_tool("discourse_add_group_owners_by_email", arguments={
  "id": 0,
  "user_emails": [
    "user@example.com"
  ],
  "notify_users": true
})

Parameters

idintegerrequired

user_emailsArray<string>required

Email addresses that already belong to user accounts; use the invitation tool for unknown addresses

notify_usersboolean

Notify users added as members or owners

Remove Group Owners by Username

discourse_remove_group_owners_by_username

Remove group owners using canonical usernames. This tool accepts only this identifier type, avoiding ambiguous selector precedence.

Remove Group Owners by Username

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_remove_group_owners_by_username",
    "arguments": {
        "id": 0,
        "usernames": [
          "string"
        ]
      }
  }
}

const result = await client.callTool({
  "name": "discourse_remove_group_owners_by_username",
  "arguments": {
    "id": 0,
    "usernames": [
      "string"
    ]
  }
});

result = await session.call_tool("discourse_remove_group_owners_by_username", arguments={
  "id": 0,
  "usernames": [
    "string"
  ]
})

Parameters

idintegerrequired

usernamesArray<string>required

Canonical usernames of existing users; do not provide user IDs or email addresses

Remove Group Owners by User ID

discourse_remove_group_owners_by_user_id

Remove group owners using numeric user IDs. This tool accepts only this identifier type, avoiding ambiguous selector precedence.

Remove Group Owners by User ID

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_remove_group_owners_by_user_id",
    "arguments": {
        "id": 0,
        "user_ids": [
          0
        ]
      }
  }
}

const result = await client.callTool({
  "name": "discourse_remove_group_owners_by_user_id",
  "arguments": {
    "id": 0,
    "user_ids": [
      0
    ]
  }
});

result = await session.call_tool("discourse_remove_group_owners_by_user_id", arguments={
  "id": 0,
  "user_ids": [
    0
  ]
})

Parameters

idintegerrequired

user_idsArray<integer>required

Numeric IDs of existing users; numbers must not be quoted as strings

Remove Group Owners by Email

discourse_remove_group_owners_by_email

Remove group owners using email addresses belonging to existing accounts. This tool accepts only this identifier type, avoiding ambiguous selector precedence.

Remove Group Owners by Email

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_remove_group_owners_by_email",
    "arguments": {
        "id": 0,
        "user_emails": [
          "user@example.com"
        ]
      }
  }
}

const result = await client.callTool({
  "name": "discourse_remove_group_owners_by_email",
  "arguments": {
    "id": 0,
    "user_emails": [
      "user@example.com"
    ]
  }
});

result = await session.call_tool("discourse_remove_group_owners_by_email", arguments={
  "id": 0,
  "user_emails": [
    "user@example.com"
  ]
})

Parameters

idintegerrequired

user_emailsArray<string>required

Email addresses that already belong to user accounts; use the invitation tool for unknown addresses

Handle Group Membership Request

discourse_handle_group_membership_request

Approve or deny one pending group membership request. Approval adds the requester to the group; denial only removes the request.

Handle Group Membership Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_handle_group_membership_request",
    "arguments": {
        "id": 0,
        "user_id": 0,
        "action": "approve"
      }
  }
}

const result = await client.callTool({
  "name": "discourse_handle_group_membership_request",
  "arguments": {
    "id": 0,
    "user_id": 0,
    "action": "approve"
  }
});

result = await session.call_tool("discourse_handle_group_membership_request", arguments={
  "id": 0,
  "user_id": 0,
  "action": "approve"
})

Parameters

idintegerrequired

user_idintegerrequired

actionstringapprovedenyrequired

Request Group Membership

discourse_request_group_membership

Request membership in a visible group that allows requests, sending the reason to its owners.

Request Group Membership

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_request_group_membership",
    "arguments": {
        "name": "string",
        "reason": "string"
      }
  }
}

const result = await client.callTool({
  "name": "discourse_request_group_membership",
  "arguments": {
    "name": "string",
    "reason": "string"
  }
});

result = await session.call_tool("discourse_request_group_membership", arguments={
  "name": "string",
  "reason": "string"
})

Parameters

namestringrequired

reasonstringrequired

Join Group

discourse_join_group

Join a visible group that allows public admission as the authenticated user.

Join Group

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_join_group",
    "arguments": {
        "id": 0
      }
  }
}

const result = await client.callTool({
  "name": "discourse_join_group",
  "arguments": {
    "id": 0
  }
});

result = await session.call_tool("discourse_join_group", arguments={
  "id": 0
})

Parameters

idintegerrequired

Leave Group

discourse_leave_group

Leave a group that allows public exit as the authenticated user.

Leave Group

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_leave_group",
    "arguments": {
        "id": 0
      }
  }
}

const result = await client.callTool({
  "name": "discourse_leave_group",
  "arguments": {
    "id": 0
  }
});

result = await session.call_tool("discourse_leave_group", arguments={
  "id": 0
})

Parameters

idintegerrequired

Docs by Sourcey