Create Writeup

Description

Creates a new AttackForge writeup (also called a writeup template) which seeds the title/description/remediation of vulnerabilities created from it.

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

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

Any rich-text field must use the AttackForge richtext format from the richtext_format block. On success the new writeup 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_writeup and click Add

Example Prompts

• Create a new writeup for "Insecure Direct Object Reference" with a remediation recommendation.

• Add a writeup to the Main library describing weak TLS configuration.

• Create a reusable writeup for CWE-89 SQL Injection with CVSS v3.1 scoring.

Parameters

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

Example Response

{
  "id": "656168055d7035a12ade4cb3"
}