How to Use Birdeye MCP Server with Mastra AI using Vinkius
Give Mastra AI instant access to 6 tools to Create Customer, Customer Checkin, Get Customer Details, and more using Vinkius.
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Birdeye through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The Birdeye MCP Server for Mastra AI is a standout in the Customer Support category, giving your AI agent 6 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Geminiimport { 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: {
"birdeye-alternative": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Birdeye Agent",
instructions:
"You help users interact with Birdeye " +
"using 6 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Birdeye?"
);
console.log(result.text);
}
main();
* Every connection is hosted and maintained by Vinkius. We handle the security, updates, and infrastructure so you don't have to write code or manage servers. See our infrastructure
About Birdeye MCP Server
Connect your Birdeye account to any AI agent and take full control of your online reputation management and customer experience workflows through natural conversation.
Mastra separates what most frameworks conflate: the intelligence layer from the infrastructure layer. Connect Birdeye through Vinkius and 6 tools slot into Mastra's workflow engine with conditional branching, automatic retries, and parallel execution paths. The agent decides what to do. The workflow engine ensures it actually happens. One command deploys the entire pipeline to Vercel, Railway, Fly.io, or your own infrastructure. No Docker. No Kubernetes. No excuses.
What you can do
- Review Orchestration. List and manage customer reviews across multiple platforms (Google, Facebook, etc.) programmatically, retrieving detailed high-fidelity comments and ratings in real-time
- Automated Check-ins. Programmatically trigger review requests (check-ins) via SMS or Email to coordinate high-fidelity feedback collection from your recent visitors
- Sentiment Intelligence. Access complete customer profiles and retrieve detailed sentiment history to maintain a perfectly coordinated overview of your brand health
- Survey & Feedback Architecture. Programmatically dispatch custom surveys to specific customers and monitor their high-fidelity responses directly through your agent
- Multi-Location Visibility. Retrieve complete directories of all your business branches and locations to coordinate your organizational reputation programmatically
The Birdeye MCP Server exposes 6 tools through Vinkius. Connect it to Mastra AI in under two minutes. Fully managed, no infrastructure to provision, no vendor lock-in.
6 tools included
Explore every tool Birdeye exposes to Mastra AI through Vinkius.
Connect Birdeye to Mastra AI via MCP
Follow these steps to connect Birdeye to Mastra AI. The setup takes under two minutes and requires no coding or server hosting.
Get your Vinkius Access Token
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 Birdeye MCP Server
Mastra AI provides unique advantages when paired with Birdeye through the Model Context Protocol.
Birdeye tools from Vinkius slot into Mastra's workflow engine with conditional branching, automatic retries, and parallel execution. Not just agent logic. Real orchestration
TypeScript-native: full type inference for every Birdeye tool response through Vinkius. IDE autocomplete and compile-time error checking across the entire pipeline
One command deploys your Birdeye workflows from Vinkius to Vercel, Railway, Fly.io, or your own infrastructure. No Docker. No Kubernetes. No ops overhead
Clean separation: Mastra handles workflow orchestration, Vinkius handles Birdeye connection infrastructure, your code handles business logic. Each layer does one thing well
Birdeye + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Birdeye MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Birdeye, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Birdeye as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Birdeye on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Birdeye tools alongside other MCP servers
Example Prompts for Birdeye in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Birdeye immediately.
"List the latest 5-star reviews for my business in Birdeye."
"Send a review request to 'John Smith' (john@example.com)."
"Show the sentiment profile for customer ID '12345'."
Troubleshooting Birdeye MCP Server with Mastra AI
Common issues when connecting Birdeye to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpBirdeye + Mastra AI FAQ
Common questions about integrating Birdeye 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.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Over 4,000 integrations ready for AI agents
Explore a vast library of pre-built integrations, optimized and ready to deploy.
Connect securely in under 30 seconds
Generate tokens to authenticate and link external services in a single step.
Complete visibility into every agent action
Audit live requests, latency, success rates, and active security compliance policies.
Optimize spending and track token ROI
Analyze real-time token consumption and cost metrics detailed by connection.
Explore our live AI Agents Analytics dashboard to see it all working
This dashboard is included when you connect Birdeye using Vinkius. You will never be left in the dark about what your AI agents are doing with your tools.
Connect Birdeye with your favorite client
Also available for these clients and frameworks:
Connect Birdeye to Mastra AI
One click to install, 6 tools ready instantly. Fully managed, no API key setup required.