How to Use the Kizeo Forms MCP in Mastra AI

Q: How do I configure Kizeo Forms with Mastra AI?

You initialize the MCPClient with the server URL provided by Vinkius, then register it in your Mastra agent's tool list. Mastra handles transport detection automatically, letting your workflows access all nine endpoints right away.

Q: Can I require human approval before Mastra AI modifies Kizeo Forms users?

Yes, you can use the requireToolApproval setting in Mastra. This pauses the workflow and alerts an admin before tools like deleteaccountuser or updateexistinguser execute.

Q: How do I pull a list of all active forms in a workflow?

You call listallforms within your step logic. This returns a clean list of available form schemas that your agent can then use to dynamically route incoming submissions.

Build self-healing workflows that sync Kizeo Forms data and manage users automatically with Mastra AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Kizeo Forms MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate user syncs with this MCP Server

Keeping your mobile workforce directory aligned with your main HR system is a headache. With this integration, you can build Mastra workflows that fetch your current team list using `list_account_users` and compare it against your internal database. If the workflow finds a discrepancy, it fires off `create_new_user` or `update_existing_user` to fix it. If an employee leaves, the workflow automatically runs `delete_account_user` to revoke access. This keeps your field licensing costs under control without manual weekly audits.

Resilient form data ingestion

Field data can be messy, and network drops happen. When your workflows ingest submissions, they can use `search_form_data` to pull recent updates. This MCP integration lets your agent handle the complex querying in the background. Once the data is verified, you can use `get_form_entry_data` to parse individual fields. The workflow engine handles the branching logic, routing specific form payloads to different departments based on what the field worker filled out.

Programmatic form dispatching

Sometimes you need to pre-populate forms for workers before they head out to a job site. You can trigger workflows that call `get_form_definition` to map the correct fields, then inject pre-filled details using `push_data_to_form`. This ensures technicians arrive on-site with their mobile apps already loaded with customer details and job history. It cuts down on manual entry errors and keeps field operations moving.

Setup guide

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

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

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

You initialize the `MCPClient` with the server URL provided by Vinkius, then register it in your Mastra agent's tool list. Mastra handles transport detection automatically, letting your workflows access all nine endpoints right away.

Yes, Mastra's workflow engine includes built-in exponential backoff. If a heavy query like `search_form_data` hits an API limit, the system pauses and retries automatically instead of failing the run.

Yes, you can use the `requireToolApproval` setting in Mastra. This pauses the workflow and alerts an admin before tools like `delete_account_user` or `update_existing_user` execute.

You call `list_all_forms` within your step logic. This returns a clean list of available form schemas that your agent can then use to dynamically route incoming submissions.

Your credentials and user account details are isolated inside secure, sandboxed environments. The MCP connection uses single-token authentication, meaning your master API keys are never exposed to the running agent or external networks.

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