Count Projects

Description

Returns the number of AttackForge projects matching the optional filter. Use this when you only need a total (for reporting, paging decisions, or sanity checks) and do NOT need the project records themselves - call find_projects for that. Results are automatically scoped to projects the calling user can access (non-admin users only count projects they have membership in). Archived projects are left out 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_projects and click Add

Example Prompts

• How many projects do I have in AttackForge?

• How many projects are currently in Testing status?

• How many projects were created this year?

• How many projects have retesting enabled?

• How many projects are in the Overrun or On Hold status?

• How many projects have an end date before 2025-06-01?

• How many projects are archived?

Parameters

Parameter	Type	Required	Description
filter	object	No	A MongoDB-style filter. Supported fields are listed below.
include_archived	boolean	No	Include projects 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 projects.

Supported filter fields (any caller):

Field	Type / Values
id	ObjectId('<24 hex>')
created, modified	ISO-8601 datetime
name, code	string
start_date, end_date	ISO-8601 datetime
status	one of 'Waiting to Start', 'Testing', 'On Hold', 'Overrun', 'Completed', 'Retest'
organization_code	string
vuln_code	string
attack_chains_enabled	boolean
reporting_enabled	boolean
retesting_enabled	boolean
summary_enabled	boolean
custom_tags	array of { name: string, value: string }
custom_fields	array of { key: string, value: string or array }

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

Field	Type / Values
is_archived	boolean

Example Response

{
	"count": 15
}