Patch Project Scope

Description

Bulk adds, updates, or removes Project Scope items on a single AttackForge project. A Project Scope item represents one thing within the testing scope of a project (URL, host, application, etc.). One call can mix create/patch/delete operations across multiple scope items - the exact shape of those operations is defined in the args schema.

A two-step workflow is required because the input shape is tenant-specific - see Two-Step Workflow for Write Tools:

1. Call get_args_schema_for_tool(tool="patch_project_scope") to retrieve the current JSON Schema for args.

2. Build args to match that schema and call this tool.

The schema always requires project_id (source: find_projects); it also describes how to target existing scope items (source: find_project_scope) for update/delete and how to declare new items for creation. Preconditions: the caller must have Edit access to the target project. On success the project id 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 patch_project_scope and click Add

Example Prompts

• Add these three URLs to the scope of project X.

• Remove the out-of-scope host from project X.

• Update the details on a scope item in project X.

• Replace the scope of the ACME project with this list of assets.

Parameters

Parameter	Type	Required	Description
args	object	Yes	The project-scope patch payload. Build it to satisfy get_args_schema_for_tool(tool="patch_project_scope"). Always requires project_id; describes create/patch/delete operations on scope items.

Example Response

{
  "id": "656168055d7035a12ade4cb3"
}