How to Use the Aha! MCP in Mastra AI

Q: How do I register the Aha! MCP Server tools inside a Mastra AI agent?

You initialize the MCPClient and spread the output of mcpClient.listTools() into your agent's tool configuration. The framework automatically registers the schemas. This makes the tools immediately available for your agent's decision-making loops.

Q: Can I require human approval before Mastra AI updates an Aha! feature?

Yes, you can use the requireToolApproval setting in your workflow configuration. This pauses execution and alerts a human operator before any MCP tool modifies your roadmap data. It ensures absolute control over your official backlog.

Build automated product management workflows by connecting Mastra AI agents to your Aha! roadmap.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Aha! MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated Idea Triaging

The `list_ideas` tool retrieves pending customer suggestions so your Mastra AI workflows can evaluate and categorize them automatically. Your agent reads the raw backlog, applies your custom product rubric, and decides which items deserve immediate attention. You can build a multi-step workflow that triggers whenever a new idea lands. If the agent flags an idea as high priority, it can automatically trigger subsequent steps to update your development boards.

Programmatic Feature Extraction

The `get_feature` tool fetches granular details about specific development items to keep your engineering and product teams aligned. Your workflow engine uses this tool to pull requirements, status updates, and assignee details on demand. By spreading `mcpClient.listTools()` into your Mastra agent, the model gains immediate access to your roadmap structure. If a network request fails, Mastra's built-in exponential backoff retries the call to prevent broken runs.

Automated Release Verification MCP Server

The `list_releases` tool scans your upcoming launch schedules to verify that all dependencies and features are on track. Your agents run this check daily, flagging delayed items before they impact your launch date. This automated auditing prevents human error in tracking complex launch plans. You get a reliable, hands-off system that keeps your strategic goals aligned with actual development progress.

Setup guide

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

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

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

You initialize the `MCPClient` and spread the output of `mcpClient.listTools()` into your agent's tool configuration. The framework automatically registers the schemas. This makes the tools immediately available for your agent's decision-making loops.

Yes, you can use the `requireToolApproval` setting in your workflow configuration. This pauses execution and alerts a human operator before any MCP tool modifies your roadmap data. It ensures absolute control over your official backlog.

The framework features a built-in workflow engine with automatic exponential backoff. If an API call hits a rate limit or network glitch, the system retries the step. Your long-running automation runs finish without manual intervention.

You write standard TypeScript logic within your workflow steps to inspect the tool output. For example, if a release status is set to delayed, you route the workflow to alert the team. Otherwise, you proceed with standard updates.

Vinkius processes all requests through zero-trust, ephemeral MCP environments that do not persist your roadmap data. Your feature specifications, release timelines, and product ideas remain strictly within your active execution memory. No logs or data payloads are saved after the tool execution completes.

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