How to Use the Formbricks MCP in Mastra AI

Q: How do I connect the Formbricks MCP Server to Mastra AI?

Install @mastra/mcp@latest. Create a new MCPClient instance and pass your endpoint URL to the servers object. Mastra auto-detects if it's SSE or Streamable HTTP.

Q: Can Mastra AI require human approval for Formbricks surveys?

You can set requireToolApproval on the client. The workflow pauses before creating or deleting surveys until an admin signs off.

Automate your user feedback workflows and conditional retries using Mastra AI and Formbricks.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Formbricks MCP to Mastra AI

Create your Vinkius account to connect Formbricks 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 Formbricks with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated Feedback via MCP

Mastra AI agents use `create_survey` to automatically deploy feedback prompts when specific conditions are met. You map out a workflow. If a user hits a paywall and bounces, the agent triggers a targeted survey. Here's the thing about automated outreach. It fails sometimes. Mastra's built-in exponential backoff means if the API rate limits your request, the agent waits and retries. You check `list_surveys` to confirm the deployment without writing custom retry logic.

Webhook Driven Workflows

Your workflow engine needs to know what's happening in your app, so it reads `list_action_classes` to understand user behaviors. The agent monitors these actions. When a high-value action fires, it branches the workflow. You don't want blind spots in your pipeline. The `list_webhooks` tool lets the agent verify that survey triggers are properly connected to your backend over the MCP connection. If a webhook is missing, Mastra alerts your engineering channel and halts the workflow.

Response Triage & Retry

Complex triage requires deep context, which agents pull using `list_responses` and `get_person`. A user submits a bug report through a survey. The agent reads the response, checks the user's tier, and decides how to route the ticket. If the user is on an enterprise plan, Mastra takes the `get_response` data and escalates it immediately. If it's a free user, it logs the feedback to a database. You build the conditional logic once, and the MCP Server handles the routing.

Setup guide

Set up Formbricks 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 Formbricks 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: "formbricks-alternative-mcp-client",
  servers: {
    "formbricks-alternative-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent Formbricks 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 Formbricks. 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 Formbricks 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 Formbricks MCP in Mastra AI

Install `@mastra/mcp@latest`. Create a new `MCPClient` instance and pass your endpoint URL to the servers object. Mastra auto-detects if it's SSE or Streamable HTTP.

You can set `requireToolApproval` on the client. The workflow pauses before creating or deleting surveys until an admin signs off.

The framework uses built-in exponential backoff. If a tool fails to fetch data, Mastra automatically retries the operation based on your workflow configuration.

Yes. You pull data with the response tools and use Mastra's conditional branching to route high-priority feedback to different agents.

Your instance processes sensitive survey answers and PII tied to the `get_person` tool. Mastra connects via a single endpoint token. The zero-trust V8 Isolate Sandbox guarantees your survey data never leaks across unauthorized sessions.

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