What the MCP server can do

Connect the server first — see Install the MCP server.

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 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 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. The token is returned once.
`secret_request_revoke`	Revokes a pending secret request.

See Secrets & 2FA.

Executions

Tool	What it does
`workflow_execute_post`	Starts an execution of the published version.
`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 lists the statuses these tools return. Debug your workflows 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_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 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 for how to connect to one.

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.

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.

Get Started

Reference

Context and docs

Workflows

Profiles

Profile groups

Secrets

Executions

Versions

Files and validation

Live environments

Next

Build a workflow over MCP

Schedules and queued runs

Batches

Tags

Reference data

​Context and docs

​Workflows

​Profiles

​Profile groups

​Secrets

​Executions

​Versions

​Files and validation

​Live environments

​Next

Build a workflow over MCP

​Schedules and queued runs

​Batches

​Tags

​Reference data

Context and docs

Workflows

Profiles

Profile groups

Secrets

Executions

Versions

Files and validation

Live environments

Next

Schedules and queued runs

Batches

Tags

Reference data