How to Use the Heymarket MCP in CrewAI

Q: How do CrewAI agents collaborate on Heymarket conversations?

One agent uses getchathistory to analyze the context of a conversation, while a second agent uses sendsmsmessage to draft and send the response. They share state using CrewAI's internal memory features.

Q: Can I limit which Heymarket tools a CrewAI agent can use?

Yes. You can use MCPServerHTTP with a toolfilter to only expose tools like listactivechats to your monitoring agent, while restricting sendsmsmessage to your writer agent.

Q: How does the system track which team member sent an SMS?

The sendsmsmessage tool requires a specific memberid. Your agent must first call listteammembers to resolve the correct ID before dispatching the text.

Coordinate teams of autonomous agents using CrewAI and 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 CrewAI

Create your Vinkius account to connect Heymarket to CrewAI 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 CrewAI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous SMS Triage and Escalation

The `list_active_chats` tool allows your triage agent to monitor all incoming SMS traffic across your shared business numbers. This agent reads new messages, summarizes the customer's issue, and writes the summary to the crew's shared memory. A second, specialized agent then uses `update_chat_status` to route the conversation based on priority. High-value accounts are escalated instantly to senior managers, while routine questions get answered automatically.

CrewAI Agents for Team Workload Balancing

The `list_team_members` tool gives your coordinator agent a real-time view of everyone currently available in your workspace. The agent uses this list to balance the workload across your human staff, preventing any single rep from getting overwhelmed. When an agent identifies an idle team member, it uses this MCP server to assign pending conversations to that person. This dynamic routing ensures your customers get replies faster while keeping your team's workload evenly distributed.

Contact Enrichment and Profile Maintenance

The `list_contacts` tool lets your research agent search for existing customer records using their incoming phone number. If the agent finds a match, it retrieves the profile details to give your messaging agents full context before they write a reply. If the profile is missing key details, a specialized enrichment agent uses `update_contact_profile` to save new information gathered during the conversation. This updates your database autonomously without requiring human reps to fill out forms.

Setup guide

Set up Heymarket MCP in CrewAI

Prerequisites

Python 3.10+ installed
crewai package (pip install crewai)
Active Vinkius subscription with a valid endpoint token

1

Install CrewAI
Run pip install crewai to install the framework. MCP support is built-in via the mcps parameter.
2

Add the MCP URL to your agent
Pass your Vinkius endpoint directly to the mcps list. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. CrewAI handles tool discovery and caching automatically.
3

Kick off your crew
Create a Crew with your agent and tasks. Call crew.kickoff() — the agent will automatically invoke Heymarket tools as needed.

crew.py

from crewai import Agent, Task, Crew

agent = Agent(
    role="Heymarket Analyst",
    goal="Access and analyze Heymarket data via MCP.",
    backstory="Expert analyst with direct Heymarket access.",
    mcps=[
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ],
)

task = Task(
    description="List recent Heymarket transactions",
    agent=agent,
    expected_output="A summary of recent activity",
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()
print(result)

Get your connection token →

Prerequisites

Python 3.10+ installed
crewai + crewai-tools packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install crewai crewai-tools. The MCPServerAdapter handles lifecycle management and tool conversion.
2

Connect with MCPServerAdapter
Use MCPServerAdapter as a context manager with SseServerParameters pointing to your Vinkius endpoint. The adapter automatically manages connection lifecycle.
3

Assign tools and run
Pass the returned mcp_tools to your agent's tools parameter. The adapter converts MCP tools to native BaseTool objects compatible with all CrewAI agents.

crew.py

from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
from mcp import SseServerParameters

server_params = SseServerParameters(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

with MCPServerAdapter(server_params) as mcp_tools:
    agent = Agent(
        role="Heymarket Analyst",
        goal="Access and analyze Heymarket data via MCP.",
        backstory="Expert analyst with direct Heymarket access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent Heymarket transactions",
        agent=agent,
        expected_output="A summary of recent activity",
    )

    crew = Crew(agents=[agent], tasks=[task])
    result = crew.kickoff()
    print(result)

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 CrewAI

One agent uses `get_chat_history` to analyze the context of a conversation, while a second agent uses `send_sms_message` to draft and send the response. They share state using CrewAI's internal memory features.

Yes. You can use MCPServerHTTP with a tool_filter to only expose tools like `list_active_chats` to your monitoring agent, while restricting `send_sms_message` to your writer agent.

Pass the Vinkius endpoint URL directly into the mcps list of your Agent definition. The framework automatically discovers and registers the tools for that agent.

The `send_sms_message` tool requires a specific member_id. Your agent must first call `list_team_members` to resolve the correct ID before dispatching the text.

Vinkius isolates your MCP server instance inside a secure sandbox. Your workspace member IDs, customer phone numbers, and chat histories are never stored, ensuring your internal team data remains private.

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