Find Project Groups

Description

Lists the AttackForge Groups linked to one project. Linking a group gives its members access to the project at their group access level. Use this to read the project's current links before changing them with patch_project_groups - call find_groups to discover groups that are not linked yet, and find_project_members with source "group" to list the users the links bring in. Archived groups are left out.

The caller must have at least View access to the project. Admins, Project Coordinators and the project's owner see every linked group; other callers see only the linked groups they belong to. Results are ordered by id and paginated (default 10 per page, max 50).

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 find_project_groups and click Add

Example Prompts

• Which groups are linked to project X?

• Is the Red Team group linked to the ACME project?

• List the groups that have access to this project.

Parameters

Parameter	Type	Required	Description
project_id	string	Yes	The id (24-hex) of the project whose linked groups you want to list. Obtain it from find_projects. The caller must have View access or higher.
fields	array	No	Fields to include (id is always returned). Supported values are listed below.
limit	integer	No	Maximum records to return in this page. Default 10, max 50.
skip	integer	No	Number of records to skip (offset). Default 0.

Supported fields values:

Field	Type
id	string
name	string

id is the group id - the value patch_project_groups takes to unlink the group.

Example Response

{
  "data": [
    {
      "id": "65b1f0a28cade68ca7bc71a4",
      "name": "Red Team"
    }
  ],
  "count": 1,
  "total": 1
}