Count Test Cases

Description

Returns the number of AttackForge library test cases matching the optional filter. A library test case is a reusable, taggable unit of testing methodology that belongs to a testsuite - it is NOT a per-project test case (see count_project_testcases for those). Use this when you only need a total - call find_testcases to retrieve the records.

Scope the count to specific testsuites via testsuite_ids. See Test Cases and Methodology.

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

Example Prompts

• How many test cases are in my methodology library?

• How many test cases are in the web application testsuite?

• How many test cases are tagged OWASP Top 10?

• How many test cases mention injection?

Parameters

Parameter	Type	Required	Description
testsuite_ids	array	No	Restrict the count to test cases belonging to these testsuites (array of 24-hex ids). Source: find_testsuites. Omit to count across every testsuite the caller can access.
filter	object	No	A MongoDB-style filter. Supported fields are listed below.

Supported filter fields:

Field	Type / Values
id	ObjectId('<24 hex>')
created, modified	ISO-8601 datetime
title	string
code	string
tags	array of string
sort_order	integer
custom_fields	array of { key: string, value: string or array }
library_id	string
template_testcase_id	ObjectId('<24 hex>')
user_id	ObjectId('<24 hex>')

Do NOT filter on testsuite membership via filter - testsuite_id is disallowed there. Use the testsuite_ids parameter.

Example Response

{
  "count": 412
}