Count Project Scope

Description

Returns the number of Project Scope items belonging to one AttackForge project. A Project Scope item represents one thing that is within the testing scope of that project (a URL, host, application, etc.). Use this when you only need a total - call find_project_scope to retrieve the items themselves. The caller must have at least View access to the project; if not, an access-denied error is returned.

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

Example Prompts

• How many scope items are in project X?

• How many scope items in project X are linked to an asset?

• How many in-scope URLs does the ACME project have?

Parameters

Parameter	Type	Required	Description
project_id	string	Yes	The id (24-hex) of the project whose scope you want to count. Obtain it from find_projects. The caller must have View access or higher.
filter	object	No	A MongoDB-style filter. Supported fields are listed below.

Supported filter fields:

Field	Type	Description
id	ObjectId('<24 hex>')	the Project Scope item id
name	string	the scope item name (URL, host, application, etc.)
asset_id	ObjectId('<24 hex>')	id of the linked Asset (only set when the Assets module is enabled and the scope item is linked to an Asset)

Example Response

{
  "count": 12
}