How to Use the Thoughtly MCP in Mastra AI

Build complex voice workflows in Mastra AI with automated retry logic and conditional branching.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Thoughtly MCP to Mastra AI

Create your Vinkius account to connect Thoughtly to Mastra AI — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Thoughtly with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Automated voice agent workflows

Chain your logic by using `trigger_call` inside a Mastra workflow. If a call fails or hits a busy signal, your agent automatically retries based on your defined policy. This removes the need for manual oversight. Your agent handles the entire lifecycle of the outreach, from dialing to logging the outcome.

Centralized contact lifecycle control

Manage your CRM state through `create_contact`, `update_contact`, and `delete_contact` tools. These operations integrate perfectly with Mastra's state management systems. Your agents maintain an accurate view of every person in your system. You keep the data clean without writing custom middleware for every sync point.

Complex interview and call analysis

Use `list_interviews` to identify active agents and `get_interview` to inspect their configuration. Analyze historical data by piping `list_calls` results into your analytical agents. This gives your crew the context needed to make decisions. They can determine if a lead needs a follow-up call or if the previous interaction was sufficient.

Setup guide

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

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

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

Import the client and spread the tools into your agent configuration. You then call them as part of your step-by-step logic.

Mastra manages the retry logic for you. If a tool call fails, the workflow engine catches it and executes your specified fallback.

Use the tool filter feature in your agent setup. This restricts which operations your agents can perform, providing a safer environment for your logic.

All data stays within the secure Thoughtly environment. You only interact with it through your authorized MCP server connection.

Your call logs are protected by token-based authentication. No other services can access the data retrieved via `get_call_history`.

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