Count Assets

Description

Returns the number of AttackForge Assets matching the optional filter, scoped to the asset library indicated by asset_library_key. Use this when you only need a total - call find_assets for the records. Requires the Assets module to be enabled; otherwise returns an error.

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

Example Prompts

• How many assets do I have?

• How many assets did I create (my library)?

• How many production assets are there?

• How many uncatalogued assets exist?

Parameters

Parameter	Type	Required	Description
asset_library_key	string	No	Scope of asset libraries to count from. Built-in keys: "all" (every accessible library, also the default), "my" (assets created by the calling user), "uncatalogued" (assets not in any library). A 24-char hex string targets one specific custom library by its id. Do NOT filter on library membership via filter - use this parameter.
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
name	string
asset_type	string
external_asset_id	string
custom_fields	array of { key: string, value: string or array }

Example Response

{
  "count": 248
}