MCP tools and workflows

Adam exposes focused tools for projects, tasks, conversations, and files. Your client only sees tools allowed by the permissions granted during authentication.

Context and models

Tool	What it does	Main input	Permission
`adam_get_context`	Returns the connected user, workspace, credential type, and granted permissions.	None	Always available
`adam_list_models`	Lists model slugs available to the workspace. Use it before selecting a task model.	None	Always available

Billing and integrations

Tool	What it does	Main input	Permission
`adam_get_billing_summary`	Returns the workspace subscription, effective plan, and high-level usage summary without payment details or internal IDs.	None	`billing:read`
`adam_list_integrations`	Lists available integrations and shows which are connected for the authenticated user.	None	`integrations:read`
`adam_get_integration`	Gets one integration and its connection status by stable slug.	`integrationSlug`	`integrations:read`

Automations

Tool	What it does	Main input	Permission
`adam_list_automations`	Lists automations visible to the authenticated user.	None	`automations:read`
`adam_get_automation`	Gets one automation, its trigger, schedule, status, and latest run summary.	`automationId`	`automations:read`
`adam_create_automation`	Creates a recurring, one-time, or webhook-triggered automation.	Name, prompt, trigger-specific fields; optional `idempotencyKey`	`automations:write`
`adam_update_automation`	Edits an automation’s name, prompt, effort, schedule, or visibility.	`automationId` and at least one field to change	`automations:write`
`adam_pause_automation`	Pauses future fires without deleting the automation.	`automationId`	`automations:write`
`adam_resume_automation`	Resumes and re-arms a paused automation.	`automationId`	`automations:write`
`adam_delete_automation`	Permanently deletes an automation after confirmation.	`automationId` and `confirm: true`	`automations:write`

Projects

Tool	What it does	Main input	Permission
`adam_list_projects`	Lists projects in cursor-paginated pages.	Optional `limit` and `cursor`	`projects:read`
`adam_get_project`	Gets one project.	`projectId`	`projects:read`
`adam_create_project`	Creates a project.	`name`; optional description, visibility, memory scope, and idempotency key	`projects:write`
`adam_update_project`	Changes a project’s name, description, visibility, or memory scope.	`projectId` and at least one field to change	`projects:write`
`adam_delete_project`	Permanently deletes an owned project. Its tasks and files become ungrouped.	`projectId` and `confirm: true` after user confirmation	`projects:write`

Tasks and conversations

Tool	What it does	Main input	Permission
`adam_list_tasks`	Lists cursor-paginated tasks, optionally filtered by project or status.	Optional `projectId`, `status`, `limit`, and `cursor`	`tasks:read`
`adam_get_task`	Gets a task, its messages, status, and pending interaction.	`taskId`	`tasks:read`
`adam_list_task_messages`	Lists structured message parts, including file references, tool calls, and tool results.	`taskId`; optional `limit` and `cursor`	`tasks:read`
`adam_create_task`	Creates and asynchronously starts a task.	`prompt`, `model`, and `idempotencyKey`; optional title, project, and attachment upload IDs	`tasks:write`; `files:write` with attachments
`adam_update_task`	Changes a task title or moves it into or out of a project.	`taskId` and a title or `projectId`	`tasks:write`
`adam_send_message`	Adds a user message and asynchronously continues a task.	`taskId`, `content`, and `idempotencyKey`; optional model and attachment upload IDs	`tasks:write`; `files:write` with attachments
`adam_answer_interaction`	Answers a pending question or approval.	`taskId`, `interactionId`, `response`, and `idempotencyKey`	`tasks:write`
`adam_cancel_task`	Cancels queued, running, or awaiting-input work. Repeated calls are safe.	`taskId`	`tasks:write`
`adam_delete_task`	Permanently deletes an owned task and its message history.	`taskId` and `confirm: true` after user confirmation	`tasks:write`

The model object contains the model slug, the fast option, and an optional effort of low, medium, high, or xhigh. Call adam_list_models instead of guessing a model slug.

Files

Tool	What it does	Main input	Permission
`adam_list_files`	Lists a cursor-paginated page of files for exactly one task or project.	Either `taskId` or `projectId`; optional `limit` and `cursor`	`files:read` plus the matching task or project read permission
`adam_get_file`	Gets file metadata and a short-lived resource link for the current contents.	`fileId`	`files:read`
`adam_upload_attachment`	Uploads base64-encoded content and returns an upload ID for a task or message.	`name`, `mediaType`, and `contentBase64`	`files:write`
`adam_upload_project_file`	Uploads base64-encoded content as a durable shared project file.	`projectId`, `name`, `mediaType`, and `contentBase64`	`files:write` and `projects:write`
`adam_delete_project_file`	Removes a durable shared file from a project after confirmation. Task files and message attachments remain immutable.	`projectId`, `fileId`, and `confirm: true` after user confirmation	`files:write` and `projects:write`

Use adam_upload_attachment, then pass the returned upload ID in the attachments array of adam_create_task or adam_send_message. Upload IDs expire after 24 hours. For durable shared inputs, use adam_upload_project_file instead. Use adam_delete_project_file only after the user confirms which shared project file to remove.

Run a task reliably

Inspect the connection

Use adam_get_context when the client needs to confirm the connected user, workspace, or permissions.

Resolve IDs instead of guessing

Use the list tools to find project IDs and model slugs. Adam validates project and task IDs as UUIDs.

Create the task once

Pass a new UUID as idempotencyKey to adam_create_task. Reuse that key only when retrying the exact same operation.

Poll at a sensible interval

Call adam_get_task until the status is completed, failed, cancelled, or awaiting_input. Do not start a duplicate task while the first one runs.

Handle input or collect files

Answer a pending interaction with adam_answer_interaction. After completion, use adam_list_files to find the resulting files and adam_get_file to retrieve a resource link.

Example requests

Continue a task that needs input

Review completed project work

Update and continue existing work

Getting started

Work in Adam

CAD and integrations

Teams and billing

MCP

API reference

Help

MCP tools and workflows

Context and models

Billing and integrations

Automations

Projects

Tasks and conversations

Files

Run a task reliably

Example requests

​Context and models

​Billing and integrations

​Automations

​Projects

​Tasks and conversations

​Files

​Run a task reliably

​Example requests

Context and models

Billing and integrations

Automations

Projects

Tasks and conversations

Files

Run a task reliably

Example requests