Forms

atlas_forms_approvals_request

Mark a task as pending approval so a reviewer is prompted to approve or reject it. Use this to route a form-submitted task into the approval workflow. Idempotent per MCP call.

Scope

forms:write

Calls

POST /v1/forms/approvals/{taskId}/request

Example prompt

Send task tsk_a1b2c3 for approval.

Arguments

atlas_forms_approvals_review

Approve or reject a task that is pending approval. Set `approve` to true to approve, false to reject; the decision and reviewer are recorded on the task. Idempotent per MCP call.

Scope

forms:write

Calls

POST /v1/forms/approvals/{taskId}/decide

Example prompt

Approve the pending expense task tsk_a1b2c3.

Arguments

atlas_forms_create

Create an intake form from a name, target project, and an ordered list of fields. `titleField` must reference one of the declared field keys - its answer becomes the created task title. Idempotent per MCP call.

Scope

forms:write

Calls

POST /v1/forms

Example prompt

Create a bug-report intake form in the Support project.

Arguments

atlas_forms_delete

Permanently delete an intake form by id. Existing tasks created from prior submissions are unaffected. Idempotent per MCP call.

Scope

forms:write

Calls

DELETE /v1/forms/{id}

Example prompt

Delete the deprecated Q1 survey form.

Arguments

atlas_forms_list

List up to 100 intake forms visible to the caller tenant, newest first, including field schema, public slug, owner, and enabled state so an MCP host can audit or summarise the forms surface without opening the dashboard.

Scope

forms:read

Calls

GET /v1/forms

Example prompt

Show me all our intake forms and whether they are enabled.

Arguments

This tool takes no arguments.

atlas_forms_update

Update an intake form by id - change its name, description, fields, title field, or enabled state. Supply at least one mutable field alongside the id. Idempotent per MCP call.

Scope

forms:write

Calls

PATCH /v1/forms/{id}

Example prompt

Disable the old vendor-onboarding form.

Arguments