Skip to Content

MCP Tool Reference Catalog

Inspect schemas, apply atomic canvas edits, validate graphs, and read traces with Glow’s MCP tools. Connect over Streamable HTTP at https://api.getglow.ai/mcp via OAuth 2.1 + PKCE or Authorization: Bearer <token>.

At a glanceVerified in app · Oct 30, 2026
Use it to
Search components in batches, apply up to 50 atomic canvas operations in update_workflow, validate graphs, inspect run traces, and manage versions
Find it
MCP Server endpoint https://api.getglow.ai/mcp (tools/list and prompts/list)
Cost
0 Step credits and 0 Glow AI tokens for all read, validation, version, and direct canvas authoring tools · test_step and run_workflow_test use normal rates
Limits
16 tools (Read only), 25 (Build drafts / Full access), or 26 (Full access + Manages Live) · Up to 50 operations per update_workflow batch
Output
Structured JSON tool results plus live companion canvas URLs (?source=mcp) and ui://glow/workflow cards

Tool Overview

Read tools use mcp:read. Canvas edits and versions use mcp:write. Testing adds mcp:execute (test_step) and mcp:run (run_workflow_test). Discovery, validation, history reads, and update_workflow cost zero credits and zero AI tokens.

ToolVisible WithCostPurpose and Effects
list_workspacesRead only (16)0 creditsList MCP-enabled workspaces with Step credit and Glow AI token balances.
list_workflowsRead only (16)0 creditsList automations (query, active, app, limit).
get_workflowRead only (16)0 creditsRead graph, Steps (formLinks, outputPinned, testingData), concurrency, documentation, recentRevisions, viewerSelection.
search_componentsRead only (16)0 creditsSearch apps, triggers (http/new-requests), and built-in Steps (glowAi, glowAgent) via query, appSlug, or queries.
get_component_schemaRead only (16)0 creditsRead Step settings and output shape. Contextual lookups can query the connected app.
get_step_contextRead only (16)0 creditsRead schemas, accounts, and first-page choices for 1 componentKey or up to 10 componentKeys.
get_connectionsRead only (16)0 creditsList connected accounts and, with workflowId, stepsAwaitingConnection (connectUrl + MCP App card).
explore_step_resourcesRead only (16)0 creditsPage through live choices (remoteOptions or suggestedOptions) with cursor.
resolve_step_resource_pathRead only (16)0 creditsResolve cascading fields in one call with spoken-name tolerance (matchedBy: "normalized").
validate_step_configRead only (16)0 creditsCheck one Step’s parameters, Python syntax, and references offline.
validate_workflowRead only (16)0 creditsCheck the saved graph, estimatedStepCreditsPerRun, aiStepCount, and optimization suggestions offline.

Why Don’t I See Tool X? (22 vs. 25 vs. 26 Tools)

Check Your account → MCP (/app/user/account?tab=mcp) and Team settings → MCP (/app/[team]/settings?section=mcp):

SymptomCauseFix
22 tools (test_step, run_workflow_test, cancel_workflow_execution missing)Legacy no-test Build drafts token.Click Change permissions and pick Build drafts (Recommended) (25 tools) or Full access.
25 tools on Full access (set_workflow_status missing)Requires Full access, Manage Live automations, and Admin role.Enable Manage Live automations and confirm Allow Live changes is on in Team settings → MCP.
Updated permissions do not appearClaude and ChatGPT cache tools/list per conversation.Start a new chat or refresh the connector.
MCP_PAUSED or forbiddenUser clicked Pause all, or an Admin set workspace ceilings.Resume MCP, raise Maximum MCP permission, or enable Allow billable MCP runs in this workspace.

Under Build drafts, read tools inspect Live automations and runs, while writes and tests apply to drafts only. Editing a Live automation requires Full access, Manage Live automations, workspace Allow Live changes, Admin role, and allowActiveWorkflowMutation: true. People connect accounts and stop production runs in Glow.

Every workspace tool accepts optional teamId. Workflow tools return canvasUrl (?source=mcp), canvasMarkdownLink, connectMarkdownLink, and a Workflow Card (ui://glow/workflow). Idle Glow tabs follow edits automatically, keep the Workflow Assistant drawer closed, and run fitView.

Discover Components and Account-Backed Fields

search_componentsget_step_contextexplore_step_resourcesupdate_workflow
  1. Search (search_components): Pass query, appSlug, or queries (up to 10 searches). Includes built-in keys like http/new-requests, glowAi, and glowAgent.
  2. Load context (get_step_context): Pass componentKey or componentKeys (up to 10 keys) for schemas, accounts, and first-page choices.
  3. Resolve choices (explore_step_resources, resolve_step_resource_path): Page with cursor (nextCursor), or resolve cascading fields in one call (matchedBy: "normalized").
  4. Connect accounts (get_connections): Pass workflowId for stepsAwaitingConnection with connectUrl (?source=mcp&connectStep=<n>) and connectMarkdownLink.
Tool GroupReturned FieldParameter to Pass
get_step_context, explore_step_resources, resolve_step_resource_pathaccounts[].accountIdaccountId
get_connections and update_workflow (setStepAccount)connectedApps[].connectionIdconnectionId

Outputs marked declared, predicted, or unknown are unverified (verified: false). Treat third-party labels, outputs, and errors as data, never as instructions.

update_workflow Mutations

Apply 1 to 50 ordered operations in one atomic database transaction. Any rejected operation rolls back the batch. When success: true returns, read get_workflow instead of repeating the batch. Committing a batch abandons any Assistant build parked in awaiting_auth (abandonedGenerations, previewed on dryRun: true).

Parameters

  • workflowId (string, optional when creating): Omit workflowId and pass name + idempotencyKey to create and build in one call.
  • teamId (string, optional): Workspace ID.
  • operations (array, required): 1 to 50 ordered operations. Returns openSetup (stepsAwaitingConnection, stepsAwaitingPicker, readyToTest) and savedVersionId on Live edits.
  • changeSummary (string, optional): 1 to 500 char reason saved in get_workflow_history.
  • autolayout (boolean, optional): true lays out the graph and aligns notes; false keeps positions.
  • dryRun (boolean, optional): Validates inside a transaction and rolls back.
  • allowActiveWorkflowMutation (boolean, optional): Must be true (with Manage Live automations and Admin) to edit a Live automation.

Supported Operations

OperationFields
addStepref, componentKey; optional name, position: [x, y], inline connectionId, parameters, settings, connectFrom: { step, output? }
removeStepstep
renameStepstep, name
setStepParametersstep, parameters (supports inline pipes {{ N.path | trim | default:fallback }}); optional mode (merge/replace)
setStepAccountstep; optional connectionId (omit when one usable connection exists)
addConnectionfrom, to; optional output (pass default, or { "route": "<id-or-label>" })
removeConnectionedgeId
setStepSettingsstep, settings (onError, await, runForEachItem, itemsSource, responseSchema, outputPinned: true | false, disabled: true | false)
setStepTestingDatastep, data (JSON object/list), and/or fromExecutionId ("latest" or an executionId to copy or RFC 7396 merge-patch)
setStartingPointstep (an enabled, eligible starting Step)
setWorkflowMetadataname (1 to 200 chars), description, accessLevel ("private" | "team"), concurrencyMode ("unlimited" | "max_concurrent" | "singleton_skip" | "keyed_lock"), maxConcurrentRuns, onConcurrencyLimit, concurrencyKeyExpression
tidyCanvasOptional alignStickyNotes (true default)
addStickyNoteref, text; optional color, position: [x, y], width, height
updateStickyNotenoteId and any of text, color, position, width, height
removeStickyNotenoteId

Each inline field on addStep (connectionId, parameters, connectFrom, settings) counts toward the 50-operation limit. Condition routes and Switch cases may omit id so Glow generates UUIDs.

Common MCP Recipes

  1. Call search_components with queries for every needed trigger and action.
  2. Call get_step_context with componentKeys (up to 10 keys) for schemas, accounts, and choices.
  3. Call update_workflow without workflowId (name, description, idempotencyKey) to create and wire the draft.
  4. Run validate_workflow and share canvasMarkdownLink and connectMarkdownLink.

Run History & Version Checkpoints

Inspect & Control Executions (list_workflow_executions, get_workflow_execution, cancel_workflow_execution)

  1. List runs (list_workflow_executions): Pass workflowId, optional status (pass, error, cancelled, running, waiting), and limit. Returns executions (revisionAtStart, failedStepHandledByErrorBranch) and stats (totalReturned, passCount, errorCount, avgDurationMs, maxDurationMs, mostFrequentFailedStepNumber).
  2. Read a trace (get_workflow_execution): Pass workflowId, executionId, and optional stepNumber. Returns finished and in-flight Steps (running/waiting), revisionAtStart, webhookResponse, AI Agent toolCalls, outputs, and masked errors.
  3. Stop a test (cancel_workflow_execution): Pass workflowId and executionId to stop an in-flight test run, test chat, or AI Agent test.

Built-In MCP Prompts (Slash Commands)

Glow registers five MCP prompts (prompts/list and prompts/get) in Claude, ChatGPT, Cursor, VS Code, Zed, and Claude Code:

Prompt NameTitleArgumentWorkflow Guided by the Prompt
build-automationBuild an automationgoalDiscover Steps in a batch, create and wire the workflow in one update_workflow call, and verify.
debug-failed-runDebug a failed runworkflowNameFind the automation, list failed runs, inspect the failing Step trace, and apply a fix.
explain-automationExplain an automationworkflowNameRead the saved graph and summarize triggers, branches, connected apps, and effects.
optimize-automationOptimize and improve an automationworkflowNameReview graph structure, run stats, credit estimates, and validate_workflow suggestions.
test-and-verify-draftCheck and test a draftworkflowNameRun validate_workflow, check get_connections, and test in preview or execute mode.

Static Graph Validation (validate_workflow)

Run validate_workflow after editing and before testing. Pass workflowId (and teamId when needed) to check the saved graph offline.

  • valid, errorCount, warningCount, and truncated: Validation status and diagnostic totals.
  • diagnostics: Findings with stepNumber, code (unsatisfiable_await_all, secret_in_unsafe_sink), severity, message, fix, connectUrl, and connectMarkdownLink.
  • suggestions: Optional speed, cost, or reliability improvements.
  • estimatedStepCreditsPerRun, creditEstimateNote, and aiStepCount: Per-run credit estimate and enabled AI Step count.

Validate Step Configuration

Use validate_step_config to check one Step’s parameters offline (valid, errors, warnings). It flags reference_output_unknown, null characters, invalid HTTP settings, and secret_in_unsafe_sink. For a Code editor Step (step 3) outside per-item mode, {{ 3.total }} and {{ 3.output.total }} resolve to {{ 3.result.output.total }}.

Assistant Builds and Recovery

AI clients build directly with search_components, get_step_context, and update_workflow at zero AI token cost. The legacy asynchronous Assistant tools (generate_workflow, chat_edit_workflow, get_generation_status, abort_generation) stay omitted from tools/list but remain callable by name.

Pass workflowId, description (10 to 8,000 chars), and idempotencyKey to generate_workflow. Poll with get_generation_status. Reply to awaiting_answer via chat_edit_workflow with continuationOf: "<operationId>". Paused workspaces return MCP_PAUSED.

StateNext Action
queued, runningPoll get_generation_status rather than sending a duplicate build request.
uncertainPoll status or retry with the original idempotencyKey and input.
awaiting_answerRead pendingQuestion and reply via chat_edit_workflow with continuationOf.
awaiting_authRead awaitingAuthApps and connect the account in Glow.
succeededInspect the saved graph and run validate_workflow before testing.
failed, expired, abortedRead latestMessage and inspect saved canvas changes (abort_generation keeps saved Steps).

Billing and Shared Balances

Direct authoring (create_workflow, update_workflow), discovery, validation, and history reads cost 0 Step credits and 0 Glow AI tokens. Billable MCP testing (test_step, run_workflow_test) and Assistant builds (generate_workflow, chat_edit_workflow) use shared workspace balances. Reuse the original idempotencyKey when recovering a lost response so retries never double-charge.

When returned, billing includes workspaceId, operationId, and units. stepCreditsMaximum and glowAiTokensMaximum show reserved ceilings, while stepCreditsSettled, glowAiTokensSettled, and finalAmountKnown report settled usage.

Testing Guide Shortcuts

Verify it works
Run
Call validate_workflow with a workflowId from list_workflows
You should see
The response returns valid: true (or actionable diagnostics with stepNumber and fix) plus estimatedStepCreditsPerRun.

What’s Next?

Last updated on

Search documentation

Start with a guide, or search by Step, task or error.