Activepieces MCP connector

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.