Activepieces MCP Server for Mastra AIGive Mastra AI instant access to 32 tools to Add Piece, Apply Flow Operation, Configure Git Repo, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Activepieces through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The Activepieces MCP Server for Mastra AI is a standout in the Productivity category — giving your AI agent 32 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Geminiimport { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"activepieces": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Activepieces Agent",
instructions:
"You help users interact with Activepieces " +
"using 32 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Activepieces?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Activepieces MCP Server
Connect your Activepieces account to any AI agent to orchestrate complex automations and monitor your business workflows through natural language.
Mastra's agent abstraction provides a clean separation between LLM logic and Activepieces tool infrastructure. Connect 32 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
What you can do
- Flow Management — List, create, retrieve, and delete automation flows within your projects using
list_flowsandcreate_flow. - Execution Monitoring — Track flow runs, check statuses, and inspect detailed step results for debugging with
list_flow_runsandget_flow_run. - App Connections — Manage credentials and connections for external services like Slack, Discord, or Google Sheets via
list_app_connections. - Flow Operations — Apply structural changes or status updates to existing flows programmatically using
apply_flow_operation. - Organization — List and manage folders to keep your automation workspace tidy with
list_folders.
The Activepieces MCP Server exposes 32 tools through the Vinkius. Connect it to Mastra AI in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 32 Activepieces tools available for Mastra AI
When Mastra AI connects to Activepieces through Vinkius, your AI agent gets direct access to every tool listed below — spanning workflow-automation, no-code, business-process, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Add piece on Activepieces
Add a custom piece to the platform
Apply flow operation on Activepieces
g., MOVE_ACTION, CHANGE_STATUS). Apply an operation to a flow
Configure git repo on Activepieces
Configure Git sync for a project
Create flow on Activepieces
Create a new flow
Create folder on Activepieces
Create a new folder
Create project on Activepieces
Create a new project
Create project release on Activepieces
Create a project release
Delete app connection on Activepieces
Delete an app connection
Delete flow on Activepieces
Delete a flow by ID
Delete folder on Activepieces
Delete a folder
Delete global connection on Activepieces
Delete a global connection
Delete project member on Activepieces
Remove a member from a project
Get flow on Activepieces
Get a specific flow by ID
Get flow run on Activepieces
Get detailed execution data for a flow run
Get mcp server on Activepieces
Get MCP server configuration for AI assistants
Invite user on Activepieces
Invite a user to the platform or project
List app connections on Activepieces
List app connections
List flow runs on Activepieces
List flow runs
List flows on Activepieces
List automation flows
List folders on Activepieces
List folders
List global connections on Activepieces
List global connections
List project members on Activepieces
List members of a project
List projects on Activepieces
List projects
List records on Activepieces
List records in a table
List tables on Activepieces
List internal data tables
List users on Activepieces
List users
Rotate mcp token on Activepieces
Rotate MCP token for a project
Update folder on Activepieces
Update a folder name
Update project on Activepieces
Update project settings
Update record on Activepieces
Update a specific record
Upsert app connection on Activepieces
Supports SECRET_TEXT, OAUTH2, BASIC_AUTH, CUSTOM_AUTH, etc. Create or update an app connection
Upsert global connection on Activepieces
Create or update a global connection
Connect Activepieces to Mastra AI via MCP
Follow these steps to wire Activepieces into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the Activepieces MCP Server
Mastra AI provides unique advantages when paired with Activepieces through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Activepieces without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every Activepieces tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
Activepieces + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Activepieces MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Activepieces, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Activepieces as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Activepieces on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Activepieces tools alongside other MCP servers
Example Prompts for Activepieces in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Activepieces immediately.
"List all active automation flows in project 'proj_123'."
"Show me the last 5 runs for flow ID 'flow_1'."
"Create a new flow named 'Customer Support Sync' in project 'proj_123'."
Troubleshooting Activepieces MCP Server with Mastra AI
Common issues when connecting Activepieces to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpActivepieces + Mastra AI FAQ
Common questions about integrating Activepieces MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
Shippo
12 toolsGet the best shipping rates from top carriers, print labels, and track deliveries with an API that simplifies e-commerce shipping.
TopOn / Mobvista
8 toolsAd mediation and monetization platform for mobile games — monitor revenue, manage waterfalls, and optimize eCPM via AI.
Ecwid
10 toolsManage e-commerce stores via Ecwid — search products and orders, handle inventory, track customers, and audit store profiles directly from any AI agent.
ServiceM8
9 toolsRun your field service business with job scheduling, quoting, invoicing, and GPS tracking from your phone or tablet.