Count Groups

Description

Returns the number of AttackForge Groups matching the optional filter. Use this when you only need a total (for reporting, paging decisions, or sanity checks) and do NOT need the group records themselves - call find_groups for that. Callers who can create projects or action project requests count every group; other callers count only the groups they belong to. Archived groups are excluded unless an administrator sets include_archived.

How To Enable

1. Go to Users

2. Select the user you would like to provide access to this tool

3. Click on Access > MCP

4. Click on Add Tools

5. Select the tool count_groups and click Add

Example Prompts

• How many groups are there in AttackForge?

• How many groups have "Red Team" in their name?

• How many groups belong to the EMEA region?

• How many archived groups are there?

Parameters

Parameter	Type	Required	Description
filter	object	No	A MongoDB-style filter. Supported fields are listed below.
include_archived	boolean	No	Include groups that have been archived. Defaults to false. Administrators only - ignored for any other caller. Combine with the is_archived filter field to count only the archived groups.

Supported filter fields (any caller):

Field	Type	Description
id	ObjectId('<24 hex>')	the group id
name	string	the group name
owner	string	the free-text owner recorded on the group
primary_contact_email	string	email address of the group's primary contact
primary_contact_name	string	name of the group's primary contact
primary_contact_number	string	phone number of the group's primary contact
custom_fields	array of { key: string, value: string or array }	the group's custom fields; discover keys via get_field_structure(model="group")

Supported filter fields (administrators only - anyone else is rejected):

Field	Type	Description
is_archived	boolean	whether the group has been archived

Example Response

{
  "count": 12
}