How to Use the Guru MCP in Mastra AI

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

Install @mastra/mcp and instantiate the client pointing to your Vinkius URL. Retrieve the tools using mcpClient.listTools() and spread them directly into your agent configuration.

Q: How does Mastra AI search Guru knowledge collections?

Your agent uses searchknowledgebase within its workflow steps to find relevant context. It can branch its logic based on whether it finds a matching card or needs to create a new one.

Build resilient, multi-step knowledge workflows with Mastra AI and your Guru wiki.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Guru MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Resilient knowledge syncing

This MCP Server integration uses the `create_knowledge_card` tool to run documentation updates with automatic retries. Documentation processes fail when APIs blink. You can build pipelines that check your connection using `verify_api_connection` before attempting any heavy writes. If the check passes, the agent proceeds; if it fails, it alerts your team.

Automated wiki curation and cleanup

The `list_knowledge_cards` tool on this MCP Server lets you audit your boards to find and clean up stale documentation. Stale documentation is worse than no documentation. If a card is flagged as completely obsolete, the agent can trigger `delete_knowledge_card` automatically. For minor issues, it fires `update_knowledge_card` to refresh the content based on your latest product logs.

Multi-step taxonomy alignment via MCP Server

Use `list_knowledge_collections` to inspect your wiki hierarchy before importing new data. When importing new documentation, you need to put it in the right place. The agent evaluates where the new card fits best, creates it, and verifies the placement. You get clean, structured knowledge without having to manually organize folders.

Setup guide

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

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

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

Install `@mastra/mcp` and instantiate the client pointing to your Vinkius URL. Retrieve the tools using `mcpClient.listTools()` and spread them directly into your agent configuration.

Yes. You can configure Mastra to require approval before executing destructive actions like `delete_knowledge_card`. The workflow pauses until a human approves the change.

Your agent uses `search_knowledge_base` within its workflow steps to find relevant context. It can branch its logic based on whether it finds a matching card or needs to create a new one.

Mastra's workflow engine catches the error and retries the operation. It can run `verify_api_connection` to confirm the API is back online before resuming.

Your wiki cards, user groups, and card details are processed entirely within a secure, isolated sandbox on Vinkius using the secure MCP gateway on Vinkius. We never cache your wiki content, and it is never used to train models.

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