Thoughtly MCP Server for Mastra AIGive Mastra AI instant access to 11 tools to Create Contact, Delete Contact, Get Call History, and more
Mastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Thoughtly through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this App Connector for Mastra AI
The Thoughtly app connector for Mastra AI is a standout in the Communication category — giving your AI agent 11 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
import { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"thoughtly": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Thoughtly Agent",
instructions:
"You help users interact with Thoughtly " +
"using 11 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Thoughtly?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Thoughtly MCP Server
Connect your Thoughtly voice AI platform to any text-based AI agent to seamlessly bridge the gap between text commands and real-world phone calls.
Mastra's agent abstraction provides a clean separation between LLM logic and Thoughtly tool infrastructure. Connect 11 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
What you can do
- Trigger Phone Calls — Instantly instruct your AI Voice Agents (Interviews) to dial any contact and execute conversational phone workflows
- Contact Management — Query your Thoughtly CRM directory, register new leads with phone numbers, and manage their details
- Call Logs & Transcripts — Retrieve detailed call histories, metadata, and full transcripts of conversations conducted by your voice agents
- Agent Fleet Control — List and inspect all your active AI Voice Agents to deploy the right persona for each outbound campaign
The Thoughtly MCP Server exposes 11 tools through the Vinkius. Connect it to Mastra AI in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 11 Thoughtly tools available for Mastra AI
When Mastra AI connects to Thoughtly through Vinkius, your AI agent gets direct access to every tool listed below — spanning voice-ai, agents, crm, and more. Every call is secured with network, filesystem, subprocess, and code evaluation entitlements inside a sandboxed runtime. Beyond a simple connection, you get a full AI Gateway with real-time visibility into agent activity, enterprise governance, and optimized token usage.
Optionally includes first name, last name, email. Create a new Thoughtly contact
Delete a Thoughtly contact
Get details and transcript for a specific call
Get specific Thoughtly contact details
Get details for a specific Thoughtly Voice Agent
Get Thoughtly user details
List past phone calls (Call logs)
List Thoughtly contacts
List Thoughtly Voice Agents (Interviews)
Trigger an AI outbound phone call
Update an existing Thoughtly contact
Connect Thoughtly to Mastra AI via MCP
Follow these steps to wire Thoughtly into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind the Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the Thoughtly MCP Server
Mastra AI provides unique advantages when paired with Thoughtly through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Thoughtly without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every Thoughtly tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
Thoughtly + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Thoughtly MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Thoughtly, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Thoughtly as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Thoughtly on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Thoughtly tools alongside other MCP servers
Example Prompts for Thoughtly in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Thoughtly immediately.
"List all my available Voice Agents in Thoughtly."
"Create a new contact with the phone number +1234567890 and tell the Sales SDR Voice Agent to call them."
"Get the call transcript for the latest interaction with Call ID CAL-554."
Troubleshooting Thoughtly MCP Server with Mastra AI
Common issues when connecting Thoughtly to Mastra AI through the Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpThoughtly + Mastra AI FAQ
Common questions about integrating Thoughtly MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.