MCP Tools Reference

Complete reference for all tools exposed by the AgentLed MCP server. Available from Claude Code, Cursor, Windsurf, Codex, and any MCP-compatible client.

Workflows

Tool	Description
list_workflows	List all workflows in the workspace
get_workflow	Get full workflow definition by ID
create_workflow	Create a new workflow from pipeline JSON
update_workflow	Update workflow-level fields (use update_step for step edits)
add_step	Add a step with automatic positioning and next-pointer rewiring
get_step	Read a single step (~1KB) — call before editing dictionary-shaped fields
update_step	Edit one step with three explicit verbs: updates / replace[] / unset[]
update_workflow_context	Surgical edit of context.* and metadata.* — same three verbs
remove_step	Remove a step with automatic next-pointer rewiring
move_step	Reposition a step in the chain
delete_workflow	Permanently delete a workflow
validate_workflow	Validate pipeline structure, returns errors per step
publish_workflow	Change workflow status (draft, live, paused, archived)
export_workflow	Export a workflow as portable JSON
import_workflow	Import a workflow from exported JSON

Step Editing — Explicit Merge Ops

update_step and update_workflow_context take three explicit verbs instead of a single deep-merge blob. Pick the verb that matches your intent — the server returns a diff + warnings on every call.

Verb	Semantics
updates	One-level deep-merge. Top-level shallow, nested objects merged. Send null to remove a field.
replace[]	Wholesale path replacement. Use for user-data dictionaries (stepInputData.fieldUpdates, pipelineStepPrompt.responseStructure, knowledgeSync.fieldMapping) — call get_step first, modify locally, send the full new object.
unset[]	Delete the value at one or more dot-paths.

// Change a prompt template — one-level merge
update_step({
  workflowId, stepId: "score",
  updates: { pipelineStepPrompt: { template: "New prompt..." } }
})

// Replace an entire dictionary wholesale (the safe path for user-data shapes)
update_step({
  workflowId, stepId: "save",
  replace: [{ path: "stepInputData.fieldUpdates", value: { score: "{{steps.score.total}}" } }]
})

// Remove a field
update_step({
  workflowId, stepId: "score",
  unset: ["entryConditions"]
})

Immutable: step.id and step.type can't change — use remove_step + add_step instead. For shape conversions (e.g. AI step → email step), call get_step_schema for the canonical JSON.

Drafts & Snapshots

Tool	Description
get_draft	Get the current draft version of a workflow
promote_draft	Promote a draft to the live version
discard_draft	Discard the current draft
create_snapshot	Create a manual config snapshot
delete_snapshot	Delete a specific config snapshot
list_snapshots	List version snapshots for a workflow
restore_snapshot	Restore a workflow to a previous snapshot

Executions

Tool	Description
start_workflow	Start a workflow execution with input
list_executions	List executions for a workflow (paginated via nextToken)
get_execution	Get execution details with step results
list_timelines	List step execution records for an execution (paginated)
get_timeline	Get a single timeline by ID with full step output
stop_execution	Stop a running execution
retry_execution	Retry a failed step — auto-detects most recent failure if no timeline ID
rerun_step	Rerun or retry any step by timelineId — works for failed AND succeeded steps, disambiguates loop iterations.

Apps & Testing

Tool	Description
list_apps	List available apps and integrations
get_app_actions	Get action schemas for an app
test_app_action	Test an app action without creating a workflow
test_ai_action	Test an AI prompt without creating a workflow
test_code_action	Test JavaScript code in the same sandboxed VM as production
get_step_schema	Get allowed PipelineStep fields grouped by category

Knowledge & Data

Tool	Description
get_workspace	Get workspace info and settings
list_knowledge_lists	List knowledge lists in the workspace
get_knowledge_rows	Get rows from a knowledge list (max 50, filtered by list key)
get_knowledge_rows_by_ids	Fetch specific rows by ID (max 200) — use after query_kg_edges
get_knowledge_text	Get text content from a knowledge entry
query_kg_edges	Query knowledge graph edges — returns targetNodeIds for entity lookups
get_scoring_history	Get scoring history for an entity

Branding (White-Label)

Tool	Description
get_branding	Get workspace white-label branding config
update_branding	Update displayName, logo, colors, favicon, tagline, badge visibility

Conversational Agent

Tool	Description
chat	Send a message to the AgentLed AI agent. Build workflows via natural language. Supports multi-turn conversations via session_id.
do	Natural language intent router — describe what you want and it selects and executes the right tool

n8n Import

Tool	Description
preview_n8n_import	Preview an n8n workflow import (dry run)
import_n8n_workflow	Import an n8n workflow into AgentLed

Installation

# Claude Code
claude mcp add agentled \
  -e AGENTLED_API_KEY=wsk_... \
  -- npx -y @agentled/mcp-server

# Cursor / Windsurf (add to MCP settings JSON)
{
  "mcpServers": {
    "agentled": {
      "command": "npx",
      "args": ["-y", "@agentled/mcp-server"],
      "env": { "AGENTLED_API_KEY": "wsk_..." }
    }
  }
}

Get your API key from agentled.app > Workspace Settings > Developer.