> ## Documentation Index
> Fetch the complete documentation index at: https://docs.asteroid.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# What the MCP server can do

> Every tool the Asteroid MCP server exposes, grouped by what it acts on.

Connect the server first — see [Install the MCP server](https://docs.asteroid.ai/mcp/install.md).

## Context and docs

| Tool | What it does |
| :- | :- |
| `get_context` | Returns your user context, including organization IDs and names. Call it first — most tools need an organization UUID. |
| `search_docs` | Searches these docs. |

## Workflows

| Tool | What it does |
| :- | :- |
| `workflow_list` | Lists the workflows in an organization. |
| `workflow_create` | Creates a workflow. With a graph, it publishes the graph as version 1. Without one, version 1 starts blank and stays editable. |
| `workflow_rename` | Renames a workflow. The name takes 1 to 100 characters. |
| `workflow_delete` | Deletes a workflow and its versions. Every execution must be terminal first. |
| `workflow_get` | Reads one workflow with its published version and version history. |
| `workflow_duplicate` | Copies a workflow into an organization. |
| `workflow_execution_stats` | Returns execution counts and outcomes over time for one workflow. |

## Profiles

| Tool | What it does |
| :- | :- |
| `profiles_list` | Lists the [login profiles](https://docs.asteroid.ai/concepts/profiles.md) in an organization. |
| `profiles_create` | Creates a profile. |
| `profile_get` | Reads one profile. |
| `profile_update` | Changes a profile. |
| `profile_delete` | Deletes a profile. |
| `profile_clear_browser_cache` | Clears the browser state a profile has kept. |
| `profile_duplicate` | Copies a profile with its settings, attached secrets, and cookies. |
| `profile_inbox_emails_list` | Lists the emails a profile's inbox received. |
| `profile_inbox_email_get` | Reads one of those emails. |

## Profile groups

| Tool | What it does |
| :- | :- |
| `profile_groups_list` | Lists the [profile groups](https://docs.asteroid.ai/concepts/profiles.md#profile-groups) in an organization. |
| `profile_groups_create` | Creates a profile group. |
| `profile_group_get` | Reads one profile group. |
| `profile_group_update` | Changes a profile group's name or selection settings. |
| `profile_group_delete` | Deletes a profile group. Its profiles are kept. |
| `profile_group_members_list` | Lists the profiles in a profile group. |
| `profile_group_members_add` | Adds profiles to a profile group. |
| `profile_group_members_remove` | Removes profiles from a profile group. |

## Secrets

Secret values are never returned. Reference fields in instructions as `##ITEM_KEY.FIELD##`. Attach secrets to a profile with `profile_update` (`secretIdsToAdd`). The old profile `credentials*` fields are deprecated.

| Tool | What it does |
| :- | :- |
| `secrets_list` | Lists organization secrets. Values are omitted. |
| `secrets_create` | Creates a secret. Pass `templateId` or `kind` and `fields`, plus `values`. Omit `itemKey` and the server derives it from the name. Many secrets may share a key. |
| `secret_get` | Reads one secret. Values are omitted. |
| `secret_update` | Changes the name, the item key, or both. A rename leaves the key unchanged. |
| `secret_delete` | Deletes a secret. |
| `secret_rotate` | Replaces field values in one write. |
| `secret_field_add` | Adds a non-required field. |
| `secret_field_remove` | Removes a field the secret type does not require. |
| `secret_versions_list` | Lists WorkOS versions. Does not decrypt. |
| `secret_templates_list` | Lists organization secret templates. |
| `secret_templates_create` | Creates an organization secret template. |
| `secret_template_get` | Reads one template. |
| `secret_template_update` | Changes a template. |
| `secret_template_delete` | Deletes a template. |
| `secret_template_duplicate` | Copies a template into an organization. |
| `secret_requests_list` | Lists secret requests. The token is never listed. |
| `secret_requests_create` | Creates a secret request. Omit `itemKey` and the server derives it from the name. Returns `recipientUrl`, the page to send the recipient. It and the token are returned once. |
| `secret_request_revoke` | Revokes a pending secret request. |
| `secret_request_delete` | Deletes a secret request in any state. The secret a completed request created is kept. |

See [Secrets & 2FA](https://docs.asteroid.ai/concepts/credentials.md).

## Executions

| Tool | What it does |
| :- | :- |
| `workflow_execute_post` | Starts an execution of the published version. Pass `tempFiles` to start it with files. |
| `temp_files_upload_base64` | Stages files to start an execution with. Send each file's `name` and `contentBase64`. Returns `tempFiles` for `workflow_execute_post`. Use it within 60 minutes. |
| `executions_list` | Lists runs, with filters and pagination. |
| `execution_get` | Returns everything about one execution. |
| `execution_view` | Draws an execution viewer in the chat, with status, activity, and result. |
| `execution_activities_get` | Returns the timeline of tool calls, messages, and events. |
| `execution_files_get` | Lists an execution's files, grouped by directory: uploads, downloads, workspace, shared, and debug for admins. |
| `execution_file_signed_url` | Returns a short-lived URL for reading one of those files. |
| `execution_context_file_signed_url` | Returns a short-lived URL for reading a file attached to an execution. |
| `execution_context_files_get` | Lists the files attached to an execution. |
| `execution_user_messages_add` | Sends a message to a running workflow. |
| `execution_pause` | Pauses a running execution. |
| `execution_resume` | Resumes a paused execution. |
| `execution_cancel` | Cancels an execution. It cannot be resumed. |
| `execution_rerun` | Runs an earlier execution again on the same version, with its inputs, profile and metadata. |
| `executions_status_counts` | Counts executions by status, with the same filters as `executions_list`. |
| `executions_metadata_keys` | Lists the metadata keys used on an organization's executions. |

[Executions and statuses](https://docs.asteroid.ai/concepts/executions.md) lists the statuses these tools return.
[Debug your workflows](https://docs.asteroid.ai/operate/debug.md) covers how to read a failure.

## Versions

| Tool | What it does |
| :- | :- |
| `workflow_versions_list` | Lists the versions of a workflow. |
| `workflow_version_get` | Loads one version: graph, rules, and settings. |
| `workflow_version_create` | Creates a version. Set `parentId` to record where it came from. It stays unpublished. |
| `workflow_version_publish` | Publishes a version, so new executions use it. |
| `workflow_version_execute` | Runs one specific version, published or not. Use it to test a draft. |
| `workflow_version_delete` | Deletes an unpublished version that has no executions. |
| `workflow_version_inputs_get` | Lists the input names a version accepts. |
| `workflow_version_output_schemas_get` | Returns the output schemas on a version's output nodes. |
| `workflow_head_publish` | Publishes the editable head as the next version. |
| `workflow_head_validate` | Lists the errors and warnings publish and run would report for the editable head. |
| `workflow_head_snapshot` | Pins the editable head so `workflow_version_execute` can run it unpublished. |
| `workflow_head_revert` | Makes an earlier version the editable head again. |

## Files and validation

A workflow's graph and its files are the same thing, viewed two ways. Node instructions, settings, and
scripts all show up as files. Editing the editable head lands in place. Editing a published or
already-executed version forks a new one instead. See [Workflow filesystem](https://docs.asteroid.ai/concepts/filesystem.md) for where
the files land at run time.

| Tool | What it does |
| :- | :- |
| `workflow_files_list` | Lists the workflow's editable head as files. Returns a `rev`, which you pass back as `baseRev` to write. |
| `workflow_version_files_list` | Lists the same files for one pinned, immutable version instead of the editable head. |
| `workflow_files_patch` | Writes or deletes files on the editable workflow in one call. |
| `workflow_version_file_signed_url` | Returns a short-lived URL for reading a file. |
| `schema_validate` | Checks a JSON schema before you put it on an output node. |
| `workflow_spec_validate` | Checks a graph before `workflow_create` creates anything. |
| `workflow_version_validate` | Runs the same check against a workflow that already exists. |

## Live environments

| Tool | What it does |
| :- | :- |
| `environment_start` | Starts a standalone environment and returns its connection details, including a proxied CDP URL. |
| `environments_list` | Lists an organization's currently-running standalone environments. |
| `environment_get` | Reads one environment: its status and its CDP URL. |
| `environment_stop` | Stops a running environment. |

See [Live environments](https://docs.asteroid.ai/concepts/environments.md#live-environments) for how to connect to one.

## Next

> [card] [Build a workflow over MCP](https://docs.asteroid.ai/build/from-your-coding-agent.md#build-a-workflow-over-mcp)
>
> See these tools used together, start to finish.

## Schedules and queued runs

| Tool | What it does |
| :- | :- |
| `schedules_list` | Lists the cron schedules on a workflow. |
| `schedule_create` | Creates a cron schedule with a time zone and inputs. |
| `schedule_get` | Reads one schedule. |
| `schedule_update` | Changes a schedule, or disables it. |
| `schedule_delete` | Deletes a schedule. |
| `scheduled_executions_list` | Lists a workflow's queued runs: one-off, batch items, and runs waiting for capacity. |
| `scheduled_execution_create` | Queues one run for a future time. |
| `scheduled_execution_cancel` | Cancels a queued run. |
| `scheduled_execution_reschedule` | Gives a cancelled run a new time. |

## Batches

| Tool | What it does |
| :- | :- |
| `execution_batches_list` | Lists a workflow's batches. |
| `execution_batch_get` | Reads one batch with its status counts. |
| `execution_batch_pause` | Pauses a batch. Untriggered items wait. |
| `execution_batch_resume` | Resumes a paused batch. |
| `execution_batch_cancel` | Cancels a batch and its untriggered items. |

## Tags

| Tool | What it does |
| :- | :- |
| `workflow_tag_groups_list` | Lists an organization's tag groups. |
| `workflow_tags_list` | Lists an organization's tags with workflow counts. |
| `workflow_tags_create` | Creates a tag in a group. |
| `workflow_tag_update` | Renames a tag or changes its portal link. |
| `workflow_tag_delete` | Deletes a tag from every workflow that carries it. |
| `workflow_tags_get` | Lists the tags on a workflow. |
| `workflow_tags_patch` | Adds and removes tags on a workflow, creating missing ones by name. |
| `workflowTagsSet` | Replaces the tags on a workflow. |

## Reference data

| Tool | What it does |
| :- | :- |
| `models_list` | Lists the model slugs a node's `model` setting accepts. |
| `available_tools_list` | Lists the browser tools a node can use at run time. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.