How to Use the Formsite MCP in Mastra AI

Q: How do I register the Formsite MCP Server in Mastra AI?

Install the package using npm install @mastra/mcp@latest in your project. Initialize the MCPClient pointing to the Vinkius MCP Server URL, and spread mcpClient.listTools() directly into your Mastra agent's tool configuration.

Q: How do I build a conditional Mastra AI workflow based on Formsite submissions?

Use listresults inside a Mastra workflow step to fetch the latest form entries. You then write a standard TypeScript conditional block that inspects the returned fields, branching your logic depending on the submission values.

Q: Can my agent fetch the specific fields of a form to map database columns?

Yes, listformitems returns a list of all fields, types, and IDs for a given form. Mastra agents use this schema to map incoming submission payloads to your database columns automatically.

Q: Is my Formsite webhook configuration secure when using the Formsite MCP Server on Vinkius?

Yes. All webhook configurations and metadata fetched via listwebhooks are processed in ephemeral, zero-trust memory buffers. Vinkius enforces strict TLS encryption in transit, ensuring no third party can intercept your webhook tokens or form structures.

Build self-healing workflows that process Formsite submissions and manage webhooks using Mastra AI and the Formsite MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Formsite MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Formsite Webhooks in Mastra AI Workflows

`list_webhooks` retrieves all active endpoints configured to receive data from your Formsite forms. Mastra AI's workflow engine uses this tool to inspect existing routes before initiating new automation pipelines, avoiding duplicate data streams. If a connection drops, Mastra's built-in retry logic with exponential backoff ensures your webhook state remains synchronized. You can programmatically re-register endpoints without manual intervention when failures occur.

Conditional Branching on Formsite Submission Data

`list_results` pulls recent submissions from Formsite to feed Mastra AI's decision-making nodes. The workflow engine evaluates specific fields, like checking if a checkbox is marked, to route the data down different processing paths. This allows you to build complex multi-step pipelines, such as dispatching alerts only when a submission contains a high-value budget field. The integration runs natively in TypeScript, making data validation straightforward.

Generate Formsite Reports via Mastra AI MCP Server

`get_form_reports` extracts pre-configured summary statistics and reports directly from your Formsite dashboard. Mastra AI schedules this tool to run at midnight, compiling the metrics into a structured format for your team. The agent processes the raw report numbers, identifies trends, and pushes the summary to your external databases. Because Mastra deploys with one command to the cloud, these scheduled telemetry jobs run reliably without local servers.

Setup guide

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

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

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

Install the package using `npm install @mastra/mcp@latest` in your project. Initialize the `MCPClient` pointing to the Vinkius MCP Server URL, and spread `mcpClient.listTools()` directly into your Mastra agent's tool configuration.

Yes. You can configure Mastra's workflow engine to require approval by setting `requireToolApproval` to true. This pauses execution when the agent attempts to call `create_webhook` or `delete_webhook`, waiting for your manual confirmation.

Use `list_results` inside a Mastra workflow step to fetch the latest form entries. You then write a standard TypeScript conditional block that inspects the returned fields, branching your logic depending on the submission values.

Yes, `list_form_items` returns a list of all fields, types, and IDs for a given form. Mastra agents use this schema to map incoming submission payloads to your database columns automatically.

Yes. All webhook configurations and metadata fetched via `list_webhooks` are processed in ephemeral, zero-trust memory buffers. Vinkius enforces strict TLS encryption in transit, ensuring no third party can intercept your webhook tokens or form structures.

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