How to Use the FutureVault MCP in Mastra AI

Q: How do I add FutureVault tools to a Mastra AI agent?

Initialize the client using @mastra/mcp with your Vinkius URL. Then, call mcpClient.listTools() and spread those tools directly into your Mastra agent's tool configuration.

Q: How do I require human approval before modifying files?

You can configure your Mastra AI workflows with the requireToolApproval setting. This stops the agent before it executes tools like folder creation, requiring a manual click from an administrator.

Q: Can I run parallel document audits across multiple vaults?

Yes, Mastra AI can execute concurrent steps. It can run listvaultfolders on multiple vaults simultaneously, gathering your folder structures in a fraction of the time.

Build automated, multi-step document workflows in Mastra AI using an MCP Server to access your FutureVault digital vaults.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect FutureVault MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build document audit workflows in Mastra AI

`list_digital_vaults` retrieves every vault your account has access to, giving your Mastra agent a starting point for systematic audits. The agent loops through each vault, running this call first to map out the entire organizational structure. Mastra's workflow engine uses this list to trigger parallel runs of `list_vault_folders` across all vaults. If one folder query fails due to a rate limit, Mastra automatically retries the call using exponential backoff, ensuring your audit completes without manual intervention.

Automate folder permissions with this MCP Server

`get_member_details` checks the roles and permissions of a specific user before granting them access to a folder. Your Mastra agent runs this check to verify if a user's profile matches the security requirements of a target vault. Based on the returned metadata, Mastra executes conditional branching. If the member has the correct role, the agent proceeds to list files; if not, the workflow halts and alerts your compliance team.

Run scheduled metadata extractions in Mastra AI

`get_document_metadata` extracts critical file details such as creation dates and system tags from your vaults. Mastra's scheduler triggers this tool nightly to gather updates on all newly uploaded documents. The agent compiles these metadata blocks and saves them to your internal database. Mastra's built-in error handling ensures that any network hiccup during the metadata retrieval is caught and retried automatically by the MCP client.

Setup guide

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

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

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

Initialize the client using `@mastra/mcp` with your Vinkius URL. Then, call `mcpClient.listTools()` and spread those tools directly into your Mastra agent's tool configuration.

Yes, Mastra AI has a built-in workflow engine that automatically retries failed calls. If `search_vault_content` hits a rate limit, Mastra pauses and retries the search until it succeeds.

You can configure your Mastra AI workflows with the `requireToolApproval` setting. This stops the agent before it executes tools like folder creation, requiring a manual click from an administrator.

Yes, Mastra AI can execute concurrent steps. It can run `list_vault_folders` on multiple vaults simultaneously, gathering your folder structures in a fraction of the time.

All API traffic goes through a zero-trust V8 isolate sandbox on Vinkius. Mastra AI executes your workflows locally or in your cloud, meaning sensitive trust and estate document structures are only ever held in temporary memory during tool execution.

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