How do I add Hub Planner tools to Mastra AI?

Register the server URL in your agent config. The framework automatically detects the available tools for your workflow.

How to Use the Hub Planner MCP in Mastra AI

Build complex resource workflows in Mastra AI using Hub Planner tools for automated scheduling and 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 Hub Planner MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated Scheduling with Mastra AI

Create agent workflows that check for unassigned tasks using `list_unassigned`. If a project lacks a lead, your agent can trigger a retry or flag it for manual review. This keeps your projects on track without constant human oversight. The agent handles the logic while you define the policy.

Workflow Branching for Resource Planning

Use `list_teams` and `list_categories` to route tasks to the right group. Your agent decides the next step based on real-time capacity data. It removes the guesswork from team distribution. Your workflow reacts to the current state, not a static spreadsheet.

Resilient Execution for Hub Planner

The framework handles retries automatically when calling `list_events`. You don't need to write custom loops for intermittent API failures. It keeps your operations running smoothly. If a network blip occurs, the agent simply tries again.

Setup guide

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

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

const result = await agent.generate(
  "List recent Hub Planner 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 Hub Planner. 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.