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 an existing workflow |
| add_step | Add a step with automatic positioning and next-pointer rewiring |
| update_step | Deep-merge updates into a single step by ID |
| remove_step | Remove a step with automatic next-pointer rewiring |
| 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 |
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 |
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 |
| get_knowledge_text | Get text content from a knowledge entry |
| query_kg_edges | Query knowledge graph edges |
| 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.