# Hullo MCP > Hullo connects your AI agent directly to your coworking space data. It lets you manage member communications, track conversation history, and handle full membership lifecycle management—all without leaving your chat window. Quickly list all members or create a new profile, then send targeted messages to get people engaged right away. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** member-engagement, community-management, direct-messaging, workspace-tools, profile-management ## Description Managing a modern workspace means more than just booking desks; it means community engagement. This MCP lets you manage member communications by integrating Hullo directly with your preferred AI client. Need to onboard someone? You can use the agent to create new profiles and instantly send them a customized welcome message. It's about centralizing data flow. If you ever find yourself switching between your dashboard, your CRM, and your messaging app just to check on one person, this is for you. Once connected through Vinkius, your agent handles all that comms complexity. You can view every conversation thread or pull up a specific member's full history with natural language prompts. It turns managing people into simple conversations. ## Tools ### create_member Generates a new member profile within the system using provided contact data. ### get_conversation Retrieves all messages and details for an existing conversation thread. ### get_member Fetches the specific record and details for one member ID. ### list_conversations Provides a summary list of all active or past conversation threads. ### list_members Returns a complete roster listing every member currently registered in the system. ### send_message Delivers a custom message to a specified member's account. ## Prompt Examples **Prompt:** ``` Show all members and send a welcome message to the newest one. ``` **Response:** ``` 42 members total. Newest: Ana Costa (member_042, ana@example.com, joined today). Other recent: James Rodriguez (member_041, joined yesterday), Lisa Park (member_040, joined 3 days ago). Welcome message sent! ✅ To: Ana Costa (member_042). Content: 'Welcome to our community, Ana! We're glad to have you. Feel free to reach out if you have any questions.' Message type: welcome. Delivery: confirmed. Would you like to view conversations or create another member? ``` **Prompt:** ``` Show all active conversations and the full thread for the latest one. ``` **Response:** ``` 18 active conversations. Latest: Conversation with Ana Costa (conv_089, started 30 min ago, 3 messages). Thread: [System 30 min ago]: Welcome message delivered. [Ana 20 min ago]: 'Thanks! Quick question — how do I set up my profile preferences?' [You 10 min ago]: 'You can access profile settings from the menu in the top-right corner. Let me know if you need help!' Other recent: Conv with James Rodriguez (conv_088, 5 messages, last activity 2 hours ago). Conv with Lisa Park (conv_087, 8 messages, last activity yesterday). Would you like to reply to Ana or view another conversation? ``` **Prompt:** ``` Create a new member for 'Carlos Mendes' and send him a welcome message. ``` **Response:** ``` Member created! Name: Carlos Mendes, Email: carlos@example.com, Phone: +55 11 9876-5432, ID: member_043. You now have 43 members. Welcome message sent! ✅ To: Carlos Mendes (member_043). Content: 'Welcome to our community, Carlos! We're excited to have you aboard. Here are some resources to get you started...' Delivery: confirmed. A new conversation has been created (conv_090). Would you like to view his profile or list all conversations? ``` ## Capabilities ### Onboard new members Create complete profiles for new occupants, including all necessary contact details. ### Check member status Pull up a specific individual's entire record to verify their current membership status or details. ### Send targeted messages Dispatch custom messages to any listed member, regardless of whether they have opened the app recently. ### Review communication history View all active or past conversation threads and inspect their full message sequence. ### Audit entire membership roster Get a comprehensive list of every person currently registered in the system. ## Use Cases ### New hire needs immediate setup An operations coordinator receives a new member's details. They prompt their agent to first use `create_member` with the provided data, and then immediately send a welcome message using `send_message`. This ensures the person is added and greeted in two steps. ### Investigating service complaints A customer success agent needs to check why a member was upset. They ask their AI client to use `get_conversation` on that member's ID, giving them the full context needed before responding. ### Running a weekly audit A community manager wants a current snapshot of everyone in the building. They prompt for all members and receive the list using `list_members`, allowing them to spot inactive accounts immediately. ## Benefits - Audit your entire membership roster instantly. Instead of running reports in a separate portal, you can use `list_members` to see everyone registered right here. - Stop losing track of context. Need to know what was discussed last week? Use `get_conversation` to view the full thread history for any member pair. - Rapidly onboard new staff. You can call `create_member` and immediately follow up by sending a welcome message using `send_message`, all in one prompt. - Never guess who you're talking to again. Use `get_member` to instantly pull the full contact details for any person, saving lookup time. - Keep track of every touchpoint. If you need to see what conversations are active or dormant, running `list_conversations` gives you the overview you need. ## How It Works The bottom line is, your chat interface becomes a complete operational dashboard for your entire member base. 1. First, subscribe to this MCP and enter your Hullo API Key into your Vinkius settings. 2. Next, reference member data or conversation needs directly within your AI client's prompt. 3. Your agent executes the necessary tool calls (like `list_members` or `send_message`) against Hullo and returns the required information to you. ## Frequently Asked Questions **How do I use `list_members` with Hullo MCP?** To see everyone, simply ask your agent to list all members. The tool returns a full roster of IDs and basic contact info so you know who's in the system. **Can I use `send_message` without knowing the member ID?** No. You must first confirm the target member's identity, usually by using `get_member` to retrieve their full details and specific ID number before sending anything. **`list_conversations` vs `get_conversation`, what’s the difference?** Use `list_conversations` for an overview, seeing who talked to whom. Use `get_conversation` when you need to dive into one specific thread and read the full message history. **Is using `create_member` mandatory?** No, but it's best practice for new people. If a member isn't in your database, you can't use their ID to send messages or check their details successfully. **What happens if I use `create_member` with incomplete or incorrect data?** The tool returns a specific error code. You must check the API response for missing fields—like an email address or phone number—and correct your input before trying again. **Does `send_message` only work if the member is currently active in Hullo?** No, you can send messages even if a member's account status changes. The tool targets communication based on the Member ID, regardless of their current activity level. **Are there rate limits when I use `list_conversations`?** Yes, Vinkius applies rate limits to protect the API. If your agent runs too many calls in a short time, you’ll receive an error code indicating you need to slow down. **What type of data does `get_member` retrieve?** It fetches the core profile details for any member. You can expect names, contact information (email and phone), and the unique internal Member ID. **Can I send messages to members through the AI agent?** Yes. The `send_message` tool sends a direct message to a member. Provide a JSON payload with the `member_id`, `content` (the message text), and `type` (message type). Use `list_members` first to find the member ID. **Can I view the full conversation history with a member?** Yes. Use `list_conversations` to see all active conversations, then `get_conversation` with a specific conversation ID to retrieve the full message thread including sender, timestamp, and content for each message. **Can I create new member profiles and manage their contact information?** Yes. Use `create_member` with a JSON payload containing `first_name`, `last_name`, `email`, `phone`, and other contact details. Use `list_members` to browse existing members and `get_member` to inspect a specific profile.