Create Project

Description

Creates a new AttackForge project. This is a write operation: it allocates one project credit against the tenant licence and persists a new project record.

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="create_project") to retrieve the current JSON Schema for args.

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

Common top-level groups are details, access, and notifications, but the authoritative list comes from the schema. Preconditions: the caller must have permission to create projects and the tenant must be within its project-creation licence limit. On success the new 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 create_project and click Add

Example Prompts

• Create a new project called "Q3 External Pentest" starting next Monday for two weeks.

• Set up a project for the ACME web app engagement with reporting and retesting enabled.

• Create a project and add my team to it.

Parameters

Parameter	Type	Required	Description
args	object	Yes	The project-creation payload. Build it to satisfy get_args_schema_for_tool(tool="create_project").

Example Response

{
  "id": "685500711d6a44e61f90db4e"
}