app_builderApp Builder

34 MCP tools.

Machine-readable: /reference/api/tools/app_builder.json

Tools

ab_add_status_update destructive

Add a status update to a project, workstream, or task

category
app_builder (App Builder)

Parameters

content : string
Status update text (max 5000 chars)
project_id : string
UUID of project to attach update to — default: null
workstream_id : string
UUID of workstream to attach update to — default: null
task_id : string
UUID of task to attach update to — default: null
session_id : string
UUID of session creating this update (optional) — default: null
status_snapshot : string
Current status value to capture (e.g., 'in_progress', 'blocked') — default: ""

ab_add_task_dependency destructive

Add a dependency between tasks (task B depends on task A)

category
app_builder (App Builder)

Parameters

task_id : string
UUID of the task that will have the dependency (the blocked task)
depends_on_task_id : string
UUID of the task that must be completed first (the blocking task)

ab_complete_task destructive

Mark a task as done with optional actual hours

category
app_builder (App Builder)

Parameters

task_id : string
UUID of the task to complete
actual_hours : number
Actual hours spent on this task — default: null

ab_create_project destructive

Create a new App Builder project for a development initiative

category
app_builder (App Builder)

Parameters

name : string
Project name (e.g., 'Mobile App MVP', 'API v2 Migration')
description : string
Project description and goals — default: ""
repo_path : string
Local repository path (e.g., 'C:\a7') — default: ""
repo_url : string
Remote repository URL (e.g., 'https://github.com/org/repo') — default: ""

ab_create_subtask destructive

Create a subtask under an existing task

category
app_builder (App Builder)

Parameters

parent_task_id : string
UUID of the parent task
title : string
Subtask title
description : string
Detailed description — default: ""
priority : string
Priority (defaults to parent's priority) — default: null
estimated_hours : number
Estimated hours to complete — default: null

ab_create_task destructive

Create a root-level task in a workstream

category
app_builder (App Builder)

Parameters

workstream_id : string
UUID of the workstream this task belongs to
title : string
Task title
description : string
Detailed description, acceptance criteria, etc. — default: ""
priority : string
Priority: low, medium, high, critical — default: "medium"
estimated_hours : number
Estimated hours to complete — default: null
due_date : string
Due date (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS format) — default: null
tags : array
Tags for categorization (e.g., ['backend', 'api', 'auth']) — default: []

ab_create_workstream destructive

Create a new workstream (parallel work track) within a project

category
app_builder (App Builder)

Parameters

project_id : string
UUID of the project this workstream belongs to
name : string
Workstream name (e.g., 'Backend API', 'Frontend Dashboard')
description : string
Workstream description and scope — default: ""
priority : integer
Priority (1 = highest) — default: 1
color : string
Hex color for UI display (e.g., '#3B82F6') — default: "#3B82F6"
target_completion : string
Target completion date (YYYY-MM-DD format) — default: null

ab_critical_path read-only

Calculate critical path and float for tasks

category
app_builder (App Builder)

Parameters

sprint_id : string
UUID of sprint — default: null
project_id : string
UUID of project — default: null

ab_dependency_analysis read-only

Full dependency graph analysis

category
app_builder (App Builder)

Parameters

sprint_id : string
UUID of sprint — default: null
project_id : string
UUID of project — default: null

ab_generate_sprint_report read-only

Generate a markdown sprint-completion report.

category
app_builder (App Builder)

Parameters

sprint_id : string
UUID of the Sprint to report on.
format : string
Output format (v3 supports markdown only). — default: "markdown"
include_metrics : boolean
Include velocity + burndown numbers. — default: true

ab_get_blocked_tasks read-only

Get all blocked tasks across a project

category
app_builder (App Builder)

Parameters

project_id : string
UUID of project (defaults to most recent active) — default: null

ab_get_my_tasks read-only

Get tasks assigned to the current user across all projects

category
app_builder (App Builder)

Parameters

status : string
Filter by status (default: active tasks only) — default: null
include_completed : boolean
Include completed tasks — default: false
limit : integer
Maximum number of tasks to return — default: 50

ab_get_project_overview read-only

Get comprehensive project overview with workstream tree, stats, and recent activity

category
app_builder (App Builder)

Parameters

project_id : string
UUID of the project
include_tree : boolean
Include ASCII tree visualization — default: true
include_recent_sessions : boolean
Include recent session summaries — default: true

ab_get_task_dependencies read-only

Get all dependencies for a task (what it depends on and what depends on it)

category
app_builder (App Builder)

Parameters

task_id : string
UUID of the task

ab_get_task_tree read-only

Get hierarchical task tree for a workstream

category
app_builder (App Builder)

Parameters

workstream_id : string
UUID of the workstream
include_completed : boolean
Include completed tasks — default: true

ab_get_workstream_burndown read-only

Return up to N daily WorkstreamMetric rows ordered chronologically.

category
app_builder (App Builder)

Parameters

workstream_id : string
UUID of the Workstream.
days : integer
Number of recent daily rows to return. — default: 30

ab_list_at_risk_tasks read-only

Find tasks at risk: due within N days OR blocked >7 days.

category
app_builder (App Builder)

Parameters

project_id : string
UUID of the BuilderProject to scan.
sprint_id : string
Restrict to a specific Sprint (optional). — default: null
days_until_due : integer
Days from now considered 'due soon'. — default: 3

ab_list_pending_handoffs read-only

Return the pending handoff queue (pending / in_progress / recent_resumed buckets).

category
app_builder (App Builder)

Parameters

limit : integer
Maximum items returned per bucket. — default: 50

ab_list_projects read-only

List App Builder projects in the current organization

category
app_builder (App Builder)

Parameters

status : string
Filter by status: active, paused, completed, archived — default: null
limit : integer
Maximum number of projects to return — default: 20
include_stats : boolean
Include workstream/task/session counts — default: true

ab_list_status_updates read-only

List status updates for a project, workstream, or task

category
app_builder (App Builder)

Parameters

project_id : string
UUID of project to list updates for — default: null
workstream_id : string
UUID of workstream to list updates for — default: null
task_id : string
UUID of task to list updates for — default: null
limit : integer
Maximum number of updates to return — default: 20

ab_list_tasks read-only

List tasks in a workstream with optional filtering

category
app_builder (App Builder)

Parameters

workstream_id : string
UUID of the workstream
status : string
Filter by status: todo, in_progress, blocked, done, cancelled — default: null
priority : string
Filter by priority: low, medium, high, critical — default: null
include_subtasks : boolean
Include subtasks in response — default: true
root_only : boolean
Return only root tasks (subtasks nested within) — default: true
limit : integer
Maximum number of tasks to return — default: 50

ab_list_workstreams read-only

List workstreams in a project with optional status filtering

category
app_builder (App Builder)

Parameters

project_id : string
UUID of the project
status : string
Filter by status: not_started, in_progress, blocked, completed — default: null
include_task_counts : boolean
Include task statistics for each workstream — default: true
limit : integer
Maximum number of workstreams to return — default: 20

ab_log_pattern_application destructive

Record that a methodology pattern was applied to a task or workstream.

category
app_builder (App Builder)

Parameters

pattern_id : integer
Pattern number (1-41).
task_id : string
UUID of a WorkstreamTask the pattern was applied to. — default: null
workstream_id : string
UUID of a Workstream the pattern was applied to. — default: null
notes : string
Free-text context / outcome notes. — default: ""
outcome : string
Outcome: applied | success | failed | partial | skipped. — default: "applied"

ab_mark_handoff_ready destructive

Mark a BuilderSession as ready for context handoff and create the HandoffDocument.

category
app_builder (App Builder)

Parameters

session_id : string
UUID of the BuilderSession to mark ready.
summary : string
Brief summary of what the session accomplished.
next_priorities : array
List of next priorities for the resuming session. — default: []
context_size_percent : number
Estimated context-window utilisation (0-100). — default: 0

ab_move_task destructive

Move a task to a different workstream

category
app_builder (App Builder)

Parameters

task_id : string
UUID of the task to move
target_workstream_id : string
UUID of the destination workstream
keep_subtasks : boolean
Move subtasks along with the task — default: true

ab_parallel_lanes read-only

Group tasks into independent parallel execution lanes

category
app_builder (App Builder)

Parameters

sprint_id : string
UUID of sprint — default: null
project_id : string
UUID of project — default: null
include_completed : boolean
Include completed tasks in analysis — default: false

ab_parallelization_score read-only

Calculate parallelization efficiency metrics

category
app_builder (App Builder)

Parameters

sprint_id : string
UUID of sprint — default: null
project_id : string
UUID of project — default: null

ab_ready_tasks read-only

List unblocked tasks ready to start immediately

category
app_builder (App Builder)

Parameters

sprint_id : string
UUID of specific sprint (or active sprint if not specified) — default: null
project_id : string
UUID of project to filter by — default: null
include_backlog : boolean
Include unassigned backlog tasks — default: false
limit : integer
Maximum number of tasks to return — default: 20

ab_remove_task_dependency destructive

Remove a dependency between tasks

category
app_builder (App Builder)

Parameters

task_id : string
UUID of the task that has the dependency
depends_on_task_id : string
UUID of the dependency task to remove

ab_reorder_workstreams destructive

Change display order of workstreams in a project

category
app_builder (App Builder)

Parameters

project_id : string
UUID of project (defaults to most recent active) — default: null
order : array
List of workstream IDs in desired order

ab_suggest_prompt_template read-only

Return top-N PromptTemplate rows matching keywords/category, ranked by match count + usage.

category
app_builder (App Builder)

Parameters

context_keywords : array
Keywords used to rank templates by simple keyword match.
category : string
Restrict to a specific category (design/build/verify/handoff/review/other). — default: null
limit : integer
Maximum number of suggestions to return. — default: 3

ab_update_task destructive

Update task properties (status, priority, description, etc.)

category
app_builder (App Builder)

Parameters

task_id : string
UUID of the task to update
title : string
New title — default: null
description : string
New description — default: null
status : string
New status: todo, in_progress, blocked, done, cancelled — default: null
priority : string
New priority: low, medium, high, critical — default: null
tags : array
New tags (replaces existing) — default: null

ab_update_workstream destructive

Update workstream properties

category
app_builder (App Builder)

Parameters

workstream_id : string
UUID of the workstream to update
name : string
New name for the workstream — default: null
description : string
New description — default: null
status : string
New status: 'not_started', 'in_progress', 'blocked', 'completed' — default: null
color : string
New hex color (e.g., '#3B82F6') — default: null
priority : integer
New priority (1 = highest) — default: null
target_completion : string
Target completion date (ISO format) — default: null