# Heymarket MCP > Heymarket controls your business text messaging and CRM data through a shared number. It lets you send, receive, and track two-way SMS messages programmatically while maintaining detailed contact profiles. Use it to manage high-volume communications and keep team workflows organized without leaving your agent interface. ## Overview - **Category:** communication-messaging - **Price:** Free - **Tags:** business-sms, mms-messaging, shared-inbox, customer-communication, text-marketing, real-time-messaging ## Description Your AI client takes over the job of coordinating all your business text messaging. Instead of logging into a separate app or manually checking shared inboxes, you interact directly with your communication system through natural conversation. You can automatically create new contacts when someone texts in, keep records up-to-date every time you speak to them, and even track full message histories for auditing purposes. When connected via Vinkius, this MCP makes managing customer conversations simple: your agent handles the sending of SMS messages, monitors active threads, and ensures all data—from chat history to contact details—stays synchronized in one place. It's like having a dedicated communications coordinator that lives inside your AI workflow. ## Tools ### create_contact Adds a completely new contact profile into the system. ### get_chat_history Retrieves all messages exchanged within an active conversation thread. ### get_message_details Provides specific metadata about a single text message. ### list_active_chats Lists all ongoing conversations in the shared inbox. ### list_contacts Retrieves existing contacts, with the ability to filter by phone number. ### list_team_members Lists all staff members who work within your Heymarket workspace. ### send_sms_message Sends a new SMS or MMS message to a specified number using an assigned team member's account. ### update_chat_status Changes the status or assignment of an active chat thread for team routing. ### update_contact_profile Modifies details, notes, or any other information on an existing contact record. ## Prompt Examples **Prompt:** ``` Send an SMS 'Your order is ready!' to '+15551234567' using member 'M123'. ``` **Response:** ``` Message sent! I've successfully delivered your update to '+15551234567' via Heymarket. The message ID is 'msg_98765'. ``` **Prompt:** ``` List all active chat conversations from the shared inbox. ``` **Response:** ``` I've retrieved 5 active threads. Notable conversations include 'Support Request #402' and 'New Lead Inquiry'. Would you like to read the latest messages for any of these? ``` **Prompt:** ``` Update contact 'C456' with first name 'John' and add a note. ``` **Response:** ``` Contact 'C456' updated! I've set the first name to 'John' and added your note to their profile in Heymarket. Their profile is now up to date. ``` ## Capabilities ### Send automated text alerts Dispatch SMS or MMS messages using specific team members and recipient phone numbers. ### View current chat activity List all ongoing conversations in the shared inbox so you know where to focus your attention. ### Track message details Get granular information about a specific message, including delivery status and content. ### Manage contact records Create new customer profiles or modify existing ones with updated details and notes. ### Review conversation history Pull the full, chronological text thread for any given chat to understand context instantly. ## Use Cases ### A new sales lead texts asking about pricing. The agent detects the inquiry, uses `list_contacts` to check if the number exists. If not, it calls `create_contact`. Then, it sends a follow-up using `send_sms_message`, all without leaving the chat window. ### A customer support ticket gets escalated. The agent uses `list_active_chats` to identify the thread. It then calls `update_chat_status` to reassign ownership, ensuring the next available team member can jump right into the conversation. ### A contact record is missing critical details. The agent receives a request from an internal user and uses `get_message_details` combined with `update_contact_profile`. This ensures the CRM data matches the most recent communication context. ## Benefits - Automate lead follow-ups with `send_sms_message`. You can send bulk messages or single alerts directly via your agent, turning a simple prompt into an immediate action. - Never lose context again. Need to know what happened last week? Use the MCP to pull full conversation history using `get_chat_history` and review everything in one shot. - Keep your CRM clean without manual entry. When you interact with a customer, the AI can automatically use `update_contact_profile` to log new details or add notes. - Centralize visibility across your team. Instantly view what's happening by calling `list_active_chats`, so no one misses an urgent lead in the shared inbox. - Save time on data lookup. Instead of flipping through spreadsheets, you can use `list_contacts` to filter and find specific customer records instantly. ## How It Works The bottom line is you interact with a single prompt in your AI client and the MCP executes complex messaging and data tasks for you. 1. Subscribe to this MCP and retrieve your API key from your Heymarket dashboard. 2. Connect the credentials to your preferred AI client (Claude, Cursor, etc.) via Vinkius. 3. Start sending messages or querying contact data using natural conversation prompts. ## Frequently Asked Questions **How do I use Heymarket MCP to send an SMS?** You initiate a prompt asking the agent to send the message. The tool then uses `send_sms_message`, requiring you to specify the recipient number and which team member should send it. **Can I use Heymarket MCP to find old conversations?** Yes, you can retrieve past messages by asking for the conversation history. The agent calls `get_chat_history` using a specific chat thread ID. **Does Heymarket MCP handle team assignments?** Absolutely. You can use `list_active_chats` to see what's happening, and then use `update_chat_status` to reassign the conversation to a different staff member. **What if I need to add a new client record?** You just ask the agent to create one. It uses the `create_contact` tool, which registers all necessary fields for you in the system. **How does Heymarket MCP keep my data accurate?** It ensures accuracy by allowing you to modify existing records using `update_contact_profile`, guaranteeing that any new information gathered during a chat is immediately logged.