# Heymarket MCP for AI Agents AI Agent Connect > Heymarket MCP lets you manage business SMS and MMS through your AI client. It connects your shared inbox to your agent so you can send texts, manage team assignments, and update customer profiles without switching tabs. It handles two-way conversations and tracks delivery status automatically. ## Overview - **Category:** communication-messaging - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_dQrBWdsdzf9wue1XTyAYsauKiMCyQde117avLGgJ/ai-agent-connect - **Tags:** business-sms, mms-messaging, shared-inbox, customer-communication, text-marketing, real-time-messaging ## Description This Connector connects your Heymarket account to your AI agent so you can run your business text messaging through a single chat interface. Instead of jumping between different tabs to check your shared inbox or manually typing out replies, you can just tell your agent what to do. It handles the heavy lifting of managing customer relationships and team coordination. For instance, you can ask your agent to find a specific customer, check their recent message history, and send a follow-up text based on those details. This setup turns your AI into a communication coordinator that can handle high-volume text queues while keeping your data clean. You'll find this is a huge time saver when you're trying to stay on top of leads or support tickets across a large team. It removes the friction of manual data entry and ensures no customer message falls through the cracks. Because it's listed on the Vinkius catalog, you can get this connected to any of your preferred AI clients in minutes to start moving messages faster. You won't have to worry about the technicalities of API calls or message routing; you just talk to your agent like a teammate and it executes the actions in Heymarket for you. It's about getting your team out of the inbox and back into the work that actually matters. ## Tools ### create_contact Register a new customer in your database. This helps keep your CRM updated with every new lead. ### get_chat_history Pull up past messages to see the context of a conversation. It's great for getting up to speed on a new ticket. ### get_message_details Look up specific info for a single message. Use this to check delivery status or timestamps. ### list_active_chats See every conversation currently happening in your shared inbox. This helps you spot urgent requests quickly. ### list_contacts Find specific customers by searching their phone numbers. It's the fastest way to locate a lead. ### list_team_members See who is currently on your staff. Use this to double-check who is available for assignments. ### send_sms_message Send an SMS or MMS to a customer. This is how you actually communicate with your audience. ### update_chat_status Change the state or assignment of a conversation. Use this to move a ticket from pending to resolved. ### update_contact_profile Change the details of an existing customer. This keeps your contact info accurate as relationships evolve. ## 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** **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 SMS or MMS messages Send texts to customers using specific member IDs. ### Monitor active chat threads See what conversations are currently happening in the shared inbox. ### Create new contact profiles Register new customers into your database. ### Update existing customer info Modify details for contacts already in your system. ### View conversation history Look back at past messages to understand context. ### Manage team assignments Route messages to specific staff members. ### Track message delivery Check if your texts actually reached the customer. ## Use Cases ### Handling a surge in support tickets A support lead asks the agent to see all active threads, identifies three urgent issues, and assigns them to the available team. ### Automating lead follow-ups A sales rep tells the agent to find a customer by phone number and then send a personalized update. ### Updating customer records An ops manager asks the agent to update a customer's profile, ensuring the database stays current without manual entry. ### Reviewing past interactions A new agent joins a thread and asks the agent to pull up the history to understand the previous months of conversation. ## Benefits - Stop switching tabs by managing your entire shared inbox directly inside your AI client. - Keep your CRM clean by automatically creating and updating contact records. - Reduce response times by quickly identifying and prioritizing urgent customer texts. - Improve team coordination by routing messages to the right person and checking staff availability. - Get better context on leads by reviewing past interactions before replying. - Monitor your outreach accurately by verifying if messages were actually delivered. ## How It Works The bottom line is you get to manage your entire business SMS flow from one chat window. 1. Subscribe to this Connector on Vinkius and grab your API Key from the Heymarket Dashboard under Administration. 2. Paste that key into your AI client's configuration settings. 3. Start asking your agent to send texts or check the shared inbox. ## Frequently Asked Questions **Can I use the Heymarket MCP to manage my company's shared SMS inbox?** Yes, you can use it to monitor active threads and manage team-based conversations in real-time. It lets your agent see what's happening across all your business numbers. **How does the Heymarket MCP help with customer data?** It lets your agent create and update contact profiles directly. This means your customer database stays accurate without you having to manually type in details every time you send a text. **Can my AI agent send MMS messages through Heymarket?** Yes, the Connector supports both SMS and MMS. You can send texts or rich media messages to your customers using your shared business numbers. **How do I route messages to different team members using the Heymarket MCP?** Your agent can look up your staff directory and update the status or assignment of a chat. This makes it easy to move conversations to the right person. **Is the Heymarket MCP good for high-volume customer support?** It's built for that. It helps you manage large text queues and view conversation histories so you can provide faster, more informed support. **Can I check if my messages were actually delivered?** Yes, your agent can pull the details for any specific message. This lets you verify delivery status and keep track of your outbound communication. **How do I generate an API Key for Heymarket?** Log in to your Heymarket account, navigate to **Administration** > **Integrations** > **API**, and click **Create Key** to generate your unique identifier. **Can the agent send images or media via SMS (MMS)?** Yes! If you provide a public media URL in the message tool, Heymarket will automatically deliver it as an MMS to the recipient. **How do I find the correct Member ID to send messages from?** Use the `list_team_members` tool. It will return all staff members in your workspace along with their unique `id`, which you can then use as the sender.