# Activepieces MCP connector

> Connects to Activepieces through Scalekit MCP to build, run, and manage flows, tables, records, and connections.

**URL:** https://caywork.com/learn/docs/node/activepiecesmcp-node

## Content

The **Activepieces MCP Node** connects your AI agent to an Activepieces instance through the Model Context Protocol (MCP) gateway. It lets agents build, run, and manage flows, tables, records, branches, steps, and connections.

## Parameters

### Required Parameters
* **action** (string): The target Activepieces tool action to run. Must be one of the enabled actions:
  * `activepiecesmcp_ap_add_branch`: Add a branch to a flow.
  * `activepiecesmcp_ap_add_step`: Add a step to a flow.
  * `activepiecesmcp_ap_build_flow`: Build a flow from the current draft.
  * `activepiecesmcp_ap_change_flow_status`: Publish or unpublish a flow.
  * `activepiecesmcp_ap_create_flow`: Create a new flow.
  * `activepiecesmcp_ap_create_table`: Create a new table.
  * `activepiecesmcp_ap_delete_branch`: Delete a flow branch.
  * `activepiecesmcp_ap_delete_flow`: Delete an existing flow.
  * `activepiecesmcp_ap_delete_records`: Delete records in a table.
  * `activepiecesmcp_ap_delete_step`: Remove a step from a flow.
  * `activepiecesmcp_ap_delete_table`: Delete a table.
  * `activepiecesmcp_ap_duplicate_flow`: Duplicate an existing flow.
  * `activepiecesmcp_ap_find_records`: Find records in a table.
  * `activepiecesmcp_ap_flow_structure`: Read the structure of a flow.
  * `activepiecesmcp_ap_get_piece_props`: Get properties for a piece action or trigger.
  * `activepiecesmcp_ap_get_run`: Get details of a specific run.
  * `activepiecesmcp_ap_insert_records`: Insert records into a table.
  * `activepiecesmcp_ap_list_ai_models`: List available AI models.
  * `activepiecesmcp_ap_list_connections`: List configured connections.
  * `activepiecesmcp_ap_list_flows`: List flows.
  * `activepiecesmcp_ap_list_runs`: List runs.
  * `activepiecesmcp_ap_list_tables`: List tables.
  * `activepiecesmcp_ap_lock_and_publish`: Lock the flow draft and publish it.
  * `activepiecesmcp_ap_manage_fields`: Add, update, or remove table fields.
  * `activepiecesmcp_ap_manage_notes`: Add or remove flow notes.
  * `activepiecesmcp_ap_read_step_code`: Read the code for a custom step.
  * `activepiecesmcp_ap_rename_flow`: Rename a flow.
  * `activepiecesmcp_ap_research_pieces`: Search for available pieces and actions.
  * `activepiecesmcp_ap_resolve_property_chain`: Resolve a piece property chain.
  * `activepiecesmcp_ap_resolve_property_options`: Resolve property options for a piece.
  * `activepiecesmcp_ap_retry_run`: Retry a failed run.
  * `activepiecesmcp_ap_run_action`: Run a specific piece action.
  * `activepiecesmcp_ap_setup_guide`: Get setup recommendations for a piece.
  * `activepiecesmcp_ap_test_flow`: Test an entire flow.
  * `activepiecesmcp_ap_test_step`: Test an individual step.
  * `activepiecesmcp_ap_update_branch`: Update a flow branch.
  * `activepiecesmcp_ap_update_record`: Update a table record.
  * `activepiecesmcp_ap_update_step`: Update a flow step.
  * `activepiecesmcp_ap_update_trigger`: Update a flow trigger.
  * `activepiecesmcp_ap_validate_flow`: Validate a flow for errors.
  * `activepiecesmcp_ap_validate_step_config`: Validate a step configuration.

### Optional Parameters
* **params** (object): A key-value dictionary of action-specific inputs.

## Practical Use Cases
1. **No-code Automation Builder**: Let the agent draft and publish Activepieces flows from a natural-language prompt.
2. **Run Monitoring & Repair**: List recent runs, inspect failures, retry specific runs, and update broken step configs.