What the MCP server can do

Connect the server first — see Install the MCP server.

Context and docs

Tool	What it does
`getContext`	Returns your user context, including organization IDs and names. Call it first — most tools need an organization UUID.
`searchDocs`	Searches these docs.

Workflows and profiles

Tool	What it does
`agentList`	Lists the workflows in an organization.
`agentCreate`	Creates a workflow with its first graph, and publishes that graph as version 1.
`agentRename`	Renames a workflow. The name takes 1 to 100 characters.
`agentDelete`	Deletes a workflow and its versions. Every execution must be terminal first.
`agentGet`	Reads one workflow with its published version and version history.
`agentDuplicate`	Copies a workflow into an organization.
`agentExecutionStats`	Returns execution counts and outcomes over time for one workflow.
`agentProfilesList`	Lists the agent profiles in an organization.
`agentProfilesCreate`	Creates a profile.
`agentProfileGet`	Reads one profile.
`agentProfileUpdate`	Changes a profile.
`agentProfileDelete`	Deletes a profile.
`agentProfileClearBrowserCache`	Clears the browser state a profile has kept.
`agentProfileDuplicate`	Copies a profile with its settings, credentials, and cookies.
`agentProfileInboxEmailsList`	Lists the emails a profile’s inbox received.
`agentProfileInboxEmailGet`	Reads one of those emails.
`agentProfilePoolsList`	Lists the profile pools in an organization.
`agentProfilePoolsCreate`	Creates a pool.
`agentProfilePoolGet`	Reads one pool.
`agentProfilePoolUpdate`	Changes a pool’s name or selection settings.
`agentProfilePoolDelete`	Deletes a pool. Its profiles are kept.
`agentProfilePoolMembersList`	Lists the profiles in a pool.
`agentProfilePoolMembersAdd`	Adds profiles to a pool.
`agentProfilePoolMembersRemove`	Removes profiles from a pool.

Executions

Tool	What it does
`agentExecutePost`	Starts an execution of the published version.
`executionsList`	Lists runs, with filters and pagination.
`executionGet`	Returns everything about one execution.
`executionView`	Draws an execution viewer in the chat, with status, activity, and result.
`executionActivitiesGet`	Returns the timeline of tool calls, messages, and events.
`executionFilesGet`	Lists the files an execution produced, grouped by directory.
`executionFileSignedUrl`	Returns a short-lived URL for reading one of those files.
`executionContextFileSignedUrl`	Returns a short-lived URL for reading a file attached to an execution.
`executionDebugFileSignedUrl`	Returns a short-lived URL for a debug file. Admins only.
`executionContextFilesGet`	Lists the files attached to an execution.
`executionStatusUpdate`	Pauses, resumes, or cancels an execution.
`executionUserMessagesAdd`	Sends a message to a running workflow.
`executionsStatusCounts`	Counts executions by status, with the same filters as `executionsList`.
`executionsMetadataKeys`	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
`workflowsList`	Lists the versions of a workflow.
`workflowGet`	Loads one version: graph, rules, and settings.
`workflowCreate`	Creates a version. Set `parentId` to record where it came from. It stays unpublished.
`workflowPublish`	Publishes a version, so new executions use it.
`workflowExecute`	Runs one specific version, published or not. Use it to test a draft.
`workflowDelete`	Deletes an unpublished version that has no executions.
`workflowInputsGet`	Lists the input names a version accepts.
`workflowOutputSchemasGet`	Returns the output schemas on a version’s output nodes.
`workflowHeadPublish`	Publishes the editable head as the next version.
`workflowHeadSnapshot`	Pins the editable head so `workflowExecute` can run it unpublished.
`workflowHeadRevert`	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
`workflowFilesList`	Lists the agent’s editable workflow as files. Returns a `rev`, which you pass back as `baseRev` to write.
`workflowFilesListByVersion`	Lists the same files for one pinned, immutable version instead of the editable head.
`workflowFilesPatch`	Writes or deletes files on the editable workflow in one call.
`workflowAgentFileSignedUrl`	Returns a short-lived URL for reading a file.
`schemaValidate`	Checks a JSON schema before you put it on an output node.
`workflowSpecValidate`	Checks a graph before `agentCreate` creates anything.
`workflowValidate`	Runs the same check against a workflow that already exists.

Live environments

Tool	What it does
`environmentStart`	Starts a standalone environment and returns its connection details, including a proxied CDP URL.
`environmentsList`	Lists an organization’s currently-running standalone environments.
`environmentGet`	Reads one environment: its status and its CDP URL.
`environmentStop`	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
`schedulesList`	Lists the cron schedules on a workflow.
`scheduleCreate`	Creates a cron schedule with a time zone and inputs.
`scheduleGet`	Reads one schedule.
`scheduleUpdate`	Changes a schedule, or disables it.
`scheduleDelete`	Deletes a schedule.
`scheduledExecutionsList`	Lists a workflow’s queued runs: one-off, batch items, and runs waiting for capacity.
`scheduledExecutionCreate`	Queues one run for a future time.
`scheduledExecutionCancel`	Cancels a queued run.
`scheduledExecutionReschedule`	Gives a cancelled run a new time.

Batches

Tool	What it does
`executionBatchesList`	Lists a workflow’s batches.
`executionBatchGet`	Reads one batch with its status counts.
`executionBatchPause`	Pauses a batch. Untriggered items wait.
`executionBatchResume`	Resumes a paused batch.
`executionBatchCancel`	Cancels a batch and its untriggered items.

Tool	What it does
`workflowTagGroupsList`	Lists an organization’s tag groups.
`workflowTagsList`	Lists an organization’s tags with agent counts.
`workflowTagsCreate`	Creates a tag in a group.
`workflowTagUpdate`	Renames a tag or changes its portal link.
`workflowTagDelete`	Deletes a tag from every workflow that carries it.
`agentTagsList`	Lists the tags on a workflow.
`agentTagsPatch`	Adds and removes tags on a workflow, creating missing ones by name.
`agentTagsSet`	Replaces the tags on a workflow.

Reference data

Tool	What it does
`modelsList`	Lists the model slugs a node’s `model` setting accepts.
`availableToolsList`	Lists the browser tools a node can use at run time.

Get Started

Reference

Context and docs

Workflows and profiles

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 and profiles

​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 and profiles

Executions

Versions

Files and validation

Live environments

Next

Schedules and queued runs

Batches

Tags

Reference data