How to Use the ToolJet MCP in Mastra AI

Q: How do I build conditional flows using ToolJet and Mastra AI?

You use querytable to get data first. Then, you wrap the subsequent action (like calling triggerworkflow) in a conditional branch within your Mastra AI workflow. If the query matches criteria X, then run step Y.

Q: What happens if an insert fails using ToolJet and Mastra AI?

Mastra AI automatically detects failures on insertrow calls. It won't just stop; it will retry the operation with increasing delays until the write succeeds or you define a failure path.

Q: Can I use ToolJet to list tables in Mastra AI workflows?

Yes, listtables lets your agent discover all available database structures first. This makes building reliable workflows much easier because the agent can validate its target schema before executing a query.

Q: Is ToolJet better for transactional data updates with Mastra AI?

For transactions, yes. Use insertrow combined with Mastra AI’s guaranteed execution model. This ensures that every piece of data written is committed reliably, handling connection issues along the way.

Q: Does ToolJet support triggering workflows for payment processing in Mastra AI?

The triggerworkflow tool lets your agent initiate any workflow. This is perfect for payments because you can build complex failure logic—like retrying the charge with a different card method if the first one fails.

Build fault-tolerant automation by connecting ToolJet databases with Mastra AI's workflow engine.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect ToolJet MCP to Mastra AI

Create your Vinkius account to connect ToolJet to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup ToolJet with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Execute complex data reads and writes.

The `query_table` tool lets your agent read specific records from a ToolJet Database table. You can build conditional logic around this query; for example, if the SELECT result is null, you trigger an alert. The Mastra AI framework handles these complex data flows gracefully. It ensures that even if a connection hiccup occurs during the read process, your workflow won't just fail—it will retry.

Manage database state reliably.

When you need to record an action, use `insert_row` to add data to a ToolJet Database table. This tool is wrapped in Mastra AI’s workflow engine for guaranteed execution. The setup handles automatic retries with exponential backoff. If the database momentarily rejects the write operation, Mastra ensures it gets tried again until successful.

Automate processes via webhooks.

The `trigger_workflow` tool allows your agent to kick off any ToolJet Workflow using a webhook. This is key for multi-step operations, like 'process payment' which might involve several database writes. Mastra AI’s built-in workflow engine manages this chain of events, allowing you to add branching logic (e.g., if the workflow fails, notify an admin).

Setup guide

Set up ToolJet MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All ToolJet tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "tooljet-mcp-client",
  servers: {
    "tooljet-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "ToolJet Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to ToolJet tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent ToolJet transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by ToolJet. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect ToolJet now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about ToolJet MCP in Mastra AI

You use `query_table` to get data first. Then, you wrap the subsequent action (like calling `trigger_workflow`) in a conditional branch within your Mastra AI workflow. If the query matches criteria X, then run step Y.

Mastra AI automatically detects failures on `insert_row` calls. It won't just stop; it will retry the operation with increasing delays until the write succeeds or you define a failure path.

Yes, `list_tables` lets your agent discover all available database structures first. This makes building reliable workflows much easier because the agent can validate its target schema before executing a query.

For transactions, yes. Use `insert_row` combined with Mastra AI’s guaranteed execution model. This ensures that every piece of data written is committed reliably, handling connection issues along the way.

The `trigger_workflow` tool lets your agent initiate any workflow. This is perfect for payments because you can build complex failure logic—like retrying the charge with a different card method if the first one fails.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript