# Activepieces MCP for AI Agents MCP > Activepieces lets your AI agent manage, monitor, and build complex automation workflows directly from natural language. You can programmatically create new flows, adjust existing connections, and track detailed execution results—all without needing a dedicated UI or jumping between tabs. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** workflow-automation, no-code, business-process, integration-platform, task-automation, self-hosted ## Description You're already using AI agents for writing code or summarizing documents. Activepieces lets you use them to build and maintain automated business processes too. Instead of manually logging into the platform to check if your lead-generation flow broke, you simply ask your agent to check its status. It can list all active workflows, pinpoint exactly which connection failed, and even apply a structural change like moving an entire automation block. It takes complex, multi-step business logic—like 'When X happens in Slack, update the record in Google Sheets, then notify the team'—and lets your agent orchestrate it. All of this power is accessible through Vinkius, letting you connect Activepieces to any MCP-compatible client so you never have to switch context just to manage a routine process. ## Tools ### add_piece Adds a specific custom component or action block to an automation flow. ### delete_app_connection Removes a credential connection for a single external service like Slack or Google Sheets. ### delete_flow Completely removes an automation flow from the platform using its unique ID. ### list_flow_runs Retrieves a list of recent executions for multiple workflows to quickly gauge overall system health. ### update_folder Changes the name or structure of an existing folder in your automation workspace. ### apply_flow_operation Applies structural changes to a flow, such as changing its status or moving it within the project hierarchy. ### configure_git_repo Sets up automatic synchronization between your Activepieces projects and an external Git repository. ### create_flow Generates a brand new, blank automation workflow ready for building out steps. ### create_folder Adds a new organizational folder to keep your project structures clean and segmented. ### upsert_app_connection Creates or modifies an external service connection, supporting various authentication types like OAuth2 or Basic Auth. ### upsert_global_connection Creates or updates a company-wide connection that can be used across multiple projects. ### create_project_release Marks and creates a specific version release point for a project's automation status. ### create_project Establishes an entirely new, dedicated workspace or project container. ### delete_folder Deletes an empty or unused folder structure from your automation environment. ### delete_global_connection Permanently removes a company-wide global connection, revoking access across all projects. ### delete_project_member Removes another team member's account from the current project scope. ### get_flow_run Pulls all the detailed execution data for a single, specific flow run instance. ### get_flow Retrieves the complete blueprint and configuration details of a specific automation workflow by ID. ### get_mcp_server Fetches the current MCP server configuration for use in your AI client setup. ### invite_user Sends an invitation to a specific user's email address to join the platform or project. ### list_app_connections Provides a list of all external service connections currently set up within your active projects. ### list_flows Lists every available automation workflow defined within the current project scope. ### list_folders Retrieves a directory of all organizational folders that structure your projects. ### list_global_connections Lists all the global connections available across every project in your organization. ### list_project_members Shows who is currently a member of the active project and what their roles are. ### list_projects Displays an overview list of every distinct project you have created on the platform. ### list_records Pulls a dataset of entries from a specified internal data table for review. ### list_tables Shows all the available, named internal data tables within your workspace environment. ### list_users Lists every user account that has access to the Activepieces platform. ### rotate_mcp_token Generates a new, refreshed security token for the project's MCP connection. ### update_project Modifies general settings or parameters for an existing automation project. ### update_record Changes specific data points within a single record in one of your internal tables. ## Prompt Examples **Prompt:** ``` I need to check if my main customer support flow is running correctly after the API change. ``` **Response:** ``` **Flow Run Status Report** * **Project:** Customer Support Intake * **Latest Run ID:** `run_abc123` (Succeeded) * **Previous Run ID:** `run_xyz789` (Failed: Timeout Error) Failure Details: The last run failed at the 'Data Validation' step. The error indicates an expired credential for the external database connection. Please review and update the credentials using the proper management tools to resolve this. ``` **Prompt:** ``` Can you list all my active projects and see who is on them? ``` **Response:** ``` I found 3 distinct automation projects: * **Project: Sales Intake:** Members include Alice (Admin), Bob (Editor). * **Project: HR Onboarding:** Members include Carol (Viewer), David (Admin). * **Project: Marketing Sync:** Only you are currently listed as a member. You can invite new users or remove existing ones via the management tools. ``` **Prompt:** ``` Create a new flow to handle incoming support emails and name it 'Email Triage'. ``` **Response:** ``` Success. I've created a blank automation workflow named 'Email Triage.' The ID is `flow_new_101`. You can now begin adding steps, like integrating the email source or defining the routing logic. Do you want me to list all available folder IDs so you know where to put it? ``` ## Capabilities ### Get Flow Details Retrieves the complete blueprint and configuration details of a specific automation workflow by ID. ### List Projects Displays an overview list of every distinct project you have created on the platform. ### List Users Lists every user account that has access to the Activepieces platform. ## Use Cases ### The Marketing Lead Follow-up Failure A marketing specialist notices that leads coming from Discord aren't triggering the correct follow-up sequence. Instead of checking the flow status page, they ask their agent to `list_flows` and then use `get_flow` on the lead router process. The agent reports that a specific conditional step is misconfigured, allowing them to immediately fix it using `apply_flow_operation`. ### Onboarding a New App Integration The Product Ops team needs to connect a brand-new CRM platform. They ask their agent to manage the credentials. The agent uses `upsert_app_connection`, handles all the authentication types (OAuth2, etc.), and confirms the connection is live for use in upcoming workflows. ### Debugging Critical Data Syncing A DevOps engineer finds that a critical sales lead record isn't updating correctly. They ask their agent to check the runs for the relevant flow ID. The agent uses `list_flow_runs` and then `get_flow_run`, showing failure in step 3 because the source data table needed an update, which they fix by manually using `update_record`. ### Restructuring Automation Projects The Product Manager needs to overhaul how their marketing automations are organized. They ask the agent to create a new folder structure and delete old ones. The agent uses `create_folder`, `delete_folder`, and confirms all related flows have been correctly moved or archived. ## Benefits - Full control over workflow definitions: You don't need a GUI. Use `create_flow` or `get_flow` to generate, read, and modify entire automation blueprints via conversational commands. - Instant debugging capability: If something goes wrong, your agent doesn't just say 'failed.' It uses `list_flow_runs` and `get_flow_run` to pull detailed step-by-step logs so you know exactly where the process broke. - Centralized connection management: Stop hunting for API keys. Manage all external services—from Slack credentials to Google Sheets links—in one place using `upsert_app_connection`. - Project and user governance: Easily manage who can do what by listing or removing users (`list_users`, `delete_project_member`) and organizing work with tools like `create_folder`. - Immediate structural changes: Need to pause a flow or change its status? Use `apply_flow_operation` to make those high-level adjustments instantly, without manual clicks. ## How It Works The bottom line is Activepieces turns manual dashboard management into a conversational command for your AI agent. 1. First, subscribe to this MCP and provide your unique Activepieces API Key. 2. Next, connect that credential through Vinkius to any compatible AI client (Cursor, Claude, etc.). 3. Finally, tell your agent what you want done—like 'List all automation flows in the Marketing project'—and it handles the rest. ## Frequently Asked Questions **How does Activepieces MCP help manage complex integrations without logging in?** It lets your agent act like a dedicated operations specialist. You can list and update external credentials, or even create new connections using `upsert_app_connection`, all through chat commands instead of the web UI. **Can I use Activepieces MCP to debug why my automation workflow failed?** Absolutely. If a flow breaks, you don't have to guess. Your agent can list recent runs and pull detailed logs using `get_flow_run`, showing exactly which step threw the error and why. **What if I need to change how my automation works? Can I modify it?** Yes, you can programmatically adjust workflows. You can get a flow's current structure using `get_flow`, and then use tools like `apply_flow_operation` to move blocks or change status without touching the platform interface. **Is Activepieces MCP only for single projects, or can it manage multiple ones?** It manages your entire workspace. You can list all available projects and monitor flows across different business units, ensuring consistency everywhere you need it. **How do I organize my automation flows using Activepieces MCP?** You control the structure by managing folders. Your agent lets you create new folders (`create_folder`), list existing ones, and delete empty organizational containers to keep everything tidy.