How to Use the kvCORE MCP in Mastra AI

Q: How do I configure Mastra AI to use kvCORE tools?

Initialize the MCPClient with your Vinkius endpoint URL. Call listTools() and spread the results into your agent's tool array.

Q: Do I need human approval for kvCORE updates in Mastra AI?

You can require it. Set requireToolApproval on the specific update tools, and the workflow will pause until an admin signs off.

Build reliable real estate workflows with Mastra AI and automatic error handling.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect kvCORE MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Lead Routing

The `search_kvcore_leads` tool finds contacts matching your criteria so your workflow can route them. You write the logic that decides where they go. If a lead needs a status change, `update_lead_info` fires off the JSON payload to update the record. Network requests fail. Mastra AI catches those failures and triggers exponential backoff automatically. Your pipeline won't break just because the API dropped a connection during a bulk update.

Sync Marketing Campaigns via MCP Server

The `list_marketing_campaigns` tool pulls every active drip sequence into your workflow engine. You can cross-reference this list against individual lead records using `get_lead_details`. If a lead is missing from a vital sequence, your logic dictates the next step. Adding context matters for sales teams. You can trigger `create_lead_note` to drop a summary of the agent's recent interactions directly into the profile. The framework handles the conditional branching if the lead ID throws a not-found error.

Track Agent Activity

The `list_lead_activity` tool grabs the recent history for any specified prospect. You feed this data into an evaluation step to determine if follow-up is necessary. If the prospect is cold, you branch the workflow to alert the assigned agent. You deploy these pipelines with a single command. The engine manages the state transitions while the MCP Server executes the raw reads and writes. Human-in-the-loop approvals can pause the run before any destructive updates occur.

Setup guide

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

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

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

Initialize the `MCPClient` with your Vinkius endpoint URL. Call `listTools()` and spread the results into your agent's tool array.

Yes. The framework includes built-in exponential backoff. It will automatically pause and retry if you hit API limits during bulk searches.

You can require it. Set `requireToolApproval` on the specific update tools, and the workflow will pause until an admin signs off.

The engine catches the exception. You can configure a fallback branch to notify a Slack channel or retry with different parameters.

Marketing campaign lists and lead notes pass through an ephemeral TLS tunnel. No data persists on disk, and the connection drops entirely once the response transmits.

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