How to Use the Heymarket MCP in Mastra AI

Q: How do I handle Heymarket rate limits in my Mastra AI workflows?

Mastra's workflow engine manages this by wrapping calls to sendsmsmessage with automatic exponential backoff. If the API returns a rate-limit error, the step pauses and retries without crashing your run.

Q: Can a Mastra AI agent assign incoming texts to specific team members?

Yes, by combining listteammembers with updatechatstatus. Your agent checks the active team list, identifies the correct agent, and updates the chat assignment programmatically.

Build automated, multi-step SMS workflows in Mastra AI using the Heymarket MCP server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Heymarket MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Multi-Step Conversation Routing

The `list_active_chats` tool acts as the trigger for your Mastra workflow engine to evaluate unassigned customer conversations. Your agent pulls the list of active threads and runs conditional checks to determine which department needs to handle the inquiry. Once the destination is set, the agent executes `update_chat_status` to assign the conversation to the correct team member. If the assignment fails due to network issues, Mastra's built-in retry logic backs off and attempts the update again automatically.

Mastra AI Workflows for Contact Syncing

The `create_contact` tool registers new customers in your database as soon as they text your shared number. This MCP server exposes the contact creation endpoint directly to your Mastra agents, allowing them to parse incoming SMS content for names and emails. If the contact already exists, the agent switches branches to run `update_contact_profile` instead. This ensures your customer records stay accurate without manual data entry or duplicate profiles.

Fail-Safe Outbound Message Queues

The `send_sms_message` tool dispatching outbound SMS requires a valid workspace member ID and a destination phone number. Mastra maps this tool inside your agent's execution step, tracking the status of every text sent to your customers. When a message fails to send, the workflow triggers `get_message_details` to inspect the error payload. You can build a branch that alerts an administrator via `list_team_members` if a high-priority message remains undelivered after three retry attempts.

Setup guide

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

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

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

Mastra's workflow engine manages this by wrapping calls to `send_sms_message` with automatic exponential backoff. If the API returns a rate-limit error, the step pauses and retries without crashing your run.

Yes, by combining `list_team_members` with `update_chat_status`. Your agent checks the active team list, identifies the correct agent, and updates the chat assignment programmatically.

Instantiate the client using @mastra/mcp and pass the Vinkius HTTP URL. Then, list the tools and spread them directly into your Mastra agent definition.

Yes. You can configure Mastra's requireToolApproval setting on the `send_sms_message` tool, forcing the workflow to pause until a human reviews the draft.

No. All contact details processed by this MCP server run in zero-trust, ephemeral environments. Your API keys and customer data exist only in memory during the execution of that specific tool call.

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