# Robly MCP > Robly MCP Server automates email marketing management through your AI client. Use natural conversation to list contacts, create segmented subscriber lists, update user profiles, or check if an email belongs in a specific campaign group. Stop switching between dashboards; manage your entire audience lifecycle from one chat window. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** subscriber-management, campaign-analytics, list-segmentation, automated-campaigns, contact-metadata, email-automation ## Description **Robly MCP Server - Manage Contacts & Lists with Your Agent** Forget switching between dashboards. You'll manage your whole audience lifecycle right here in chat using your AI client. This server gives your agent direct, conversational access to the core data inside your Robly account, letting you handle everything from list setup to individual profile tweaks without needing a single API call or manual click. **Managing Your Audience Segments** You're gonna run targeted campaigns, right? You need segmented lists. Your agent handles all that. It can generate completely new sub-lists for specific groups (`create_sub_list`). If a campaign goal changes, it lets you rename an existing group without messing up who’s in it (`rename_sub_list`). You can always see every single sub-list you've got by asking your agent to list them out (`list_sub_lists`). Need to clean house? It can remove all contacts from a whole sub-list (`clear_sub_list`), though you gotta be careful with that one. If you wanna trash an entire list permanently, it will delete the sub-list for good (`delete_sub_list`). **Handling Individual Contacts and Membership Status** Dealing with people is where this shines. You can check if a specific email address is already sitting in a particular sub-list (`check_list_membership`). If they're new leads, your agent adds them directly to an existing list using just their email (`add_contact`). Want to pull someone out of all marketing comms immediately? It handles that unsubscribe process instantly for you (`unsubscribe_contact`). **Updating and Finding People** Don't ever assume a contact’s details are up-to-date. Your agent searches for any user by email address, pulling back their full metadata so you know who they are (`search_contact`). Once you find them, it lets you fix things—you can update specific data points like their job title or company name right in the system using `update_contact`. You also get a complete rundown of every single marketing contact in your Robly account with one command (`list_contacts`). **System Checks and Debugging** It's not just about people; it’s about the plumbing, too. If you ever gotta check how your integrations are working, your agent displays all active webhooks set up in your Robly account (`list_webhooks`), which is super useful for debugging connections. Basically, when you use this server, your AI client acts like a dedicated marketing coordinator sitting right next to you. You talk to it naturally—you say, 'Check if John Doe is on the Q3 list and update his job title.' It executes the whole sequence: search, check membership, and then update the profile. No switching windows, no boilerplate code. Just direct control over your entire audience database. ## Tools ### add_contact Adds a specified email address to an existing subscriber list. ### check_list_membership Determines if a given email address is currently listed in a specific sub-list. ### clear_sub_list Removes all contacts from an entire specified sub-list. Use with extreme caution. ### create_sub_list Creates a new, empty subscriber list for segmentation purposes. ### delete_sub_list Permanently deletes an entire sub-list from your account (data loss). ### list_contacts Retrieves a comprehensive list of all marketing contacts in your Robly account. ### list_sub_lists Returns an array of the names and IDs of every sub-list you have created. ### list_webhooks Displays all currently active webhooks set up for your Robly account, useful for debugging integrations. ### rename_sub_list Changes the name of an existing sub-list without affecting its membership or contents. ### search_contact Finds and retrieves detailed metadata for a specific contact using their email address. ### unsubscribe_contact Removes an individual contact's email from all marketing communications immediately. ### update_contact Modifies specific details—like job title or company—for a single, existing contact record. ## Prompt Examples **Prompt:** ``` List all subscriber lists in my Robly account. ``` **Response:** ``` I've retrieved your lists. You have 4 active sub-lists including 'Main Newsletter', 'Premium Customers', and 'Event Leads'. Which one would you like to see contacts for? ``` **Prompt:** ``` Show me the performance analytics for all email campaigns sent this month. ``` **Response:** ``` 12 email campaigns sent this month. Total sent: 45,600. Overall open rate: 28.4% (industry avg: 21%). Click rate: 4.8%. Unsubscribe rate: 0.12%. Top performer: "Flash Sale Alert" with 42% open rate and 8.9% click rate. "Weekly Newsletter #19" reached the largest audience (12,400 recipients). A/B test winner: Subject line B outperformed A by 34% on opens. Robly's OpenGen AI feature re-sent to non-openers and recovered 2,340 additional opens (5.1% recovery). ``` **Prompt:** ``` Create a new email campaign targeting subscribers who have not engaged in the last 30 days. ``` **Response:** ``` Re-engagement campaign created: "We Miss You!". Target segment: 3,456 subscribers with no opens or clicks in 30 days. Subject: "It's been a while - here's 20% off to welcome you back". Content: personalized with last purchased product category, 20% discount code COMEBACK20, and updated product highlights. Send schedule: Tomorrow 10 AM (optimal send time). OpenGen enabled: will auto-resend to non-openers 48 hours later with alternate subject line. Expected recovery: 12-15% re-engagement based on similar campaigns. ``` ## Capabilities ### Manage Subscriptions Create, rename, delete, and list segmented subscriber groups (sub-lists) for targeted campaigns. ### Update Contact Profiles Search for an email address and update specific contact details, like company or job title, directly in the system. ### Manage Membership Status Check if a given email is part of any list, add new contacts to lists, or remove them entirely from your audience. ### Analyze Audience Data Retrieve full lists of contacts and view all existing webhooks for system monitoring. ## Use Cases ### Onboarding a new client list A sales rep signs up 50 leads. Instead of manually uploading them, they ask their agent: 'Take these 50 emails and create a sub-list called 'Q3 New Leads', then add all contacts.' The agent runs `create_sub_list` followed by multiple `add_contact` calls in one go. ### Cleaning up outdated segments The marketing team realizes the 'Event Attendees' list is stale. They ask: 'Show me all contacts in 'Event Attendees' who haven't been updated recently.' The agent runs `list_contacts` and filters, letting the user decide if they need to run `clear_sub_list` or just `delete_sub_list`. ### Updating a key contact detail A sales rep finds an old lead. They ask: 'Find John Doe using his email and update his company name to Acme Inc.' The agent runs `search_contact`, verifies the record, and executes `update_contact` without needing to navigate any forms. ### Auditing list structure The Ops team needs to know exactly what lists exist before a major migration. They simply prompt: 'List all available sub-lists.' The agent runs `list_sub_lists` and provides an immediate, clean inventory. ## Benefits - **Centralized Control:** Instead of jumping between the list creation tab, the contact detail view, and the analytics dashboard, all management happens in one chat session. You can run `list_sub_lists` and then immediately use `add_contact` for a new lead. - **Data Cleaning Power:** Easily manage audience health by calling `unsubscribe_contact` or using `clear_sub_list` when a segment is outdated. Your agent handles the necessary calls so you don't have to build complex multi-step reports. - **Rapid Segmentation:** Need a list of users who changed jobs? You can use `search_contact` on several leads and then run `create_sub_list` with the filtered results, automating what used to take hours. - **Visibility into System State:** Don't get stuck debugging why your webhooks aren't firing. Use `list_webhooks` to check every connection point directly from your chat interface, saving time on manual backend checks. - **Accurate Contact Records:** Before running a campaign, verify data accuracy using `search_contact` and then instantly fix mistakes with `update_contact`. This ensures the right message gets to the right person. ## How It Works The bottom line is that your AI client uses these specific API tools to interact with Robly’s backend, giving you full control over your marketing data through natural language prompts. 1. Subscribe to the Robly MCP Server on Vinkius. 2. Input your unique Robly API ID and API Key into your AI client's configuration settings. 3. Ask your agent a task, like: 'Find all contacts in the 'High Value Leads' list and update their company name to Acme Corp.' The agent calls the necessary tools sequentially. ## Frequently Asked Questions **How do I find out what sub-lists exist using Robly MCP Server?** You run the `list_sub_lists` tool. This instantly gives you a complete, structured list of every segment available in your account, so you know exactly where to target your campaigns. **Can I update contact details with Robly MCP Server?** Yes, use the `update_contact` tool. You simply tell your agent which email and what specific field (like 'job title') needs changing. It handles the API call directly. **What happens if I run `clear_sub_list`?** It removes every single contact from that specified sub-list immediately. This is a destructive action, so double-check your list name before asking for this to prevent data loss. **Does Robly MCP Server help me check if an email is in a list?** Absolutely. Use `check_list_membership` and provide the email and the target list ID. It gives you a simple yes/no answer, which is perfect for validation checks. **What authentication details do I need to use the `list_contacts` tool?** You must provide your Robly API ID and Key when connecting the server. The system uses these credentials to authorize every request before listing contacts. This ensures that only your account can access the data. **If I run `update_contact` with an invalid contact ID, what happens?** The tool will throw a specific API error code indicating the missing record. Your AI client captures this failure and tells you exactly which identifier needs to be corrected. You then fix the ID and rerun the command. **Are there rate limits when using the `add_contact` tool?** Yes, the underlying API enforces rate limits for adding contacts in quick succession. If you hit this threshold, the server returns a 429 error. You'll need to build retry logic with backoff delays into your agent. **Does running `delete_sub_list` impact other lists or data?** No, deleting a sub-list only removes that single segment and its associated contacts. The tool is isolated and won't affect any of your other list structures or metadata. **Can my AI automatically find if a specific email exists in a Robly subscriber list?** Yes! Use the `exists_in_sub_list` tool. Provide the email and the `sub_list_id`, and your agent will return the membership status and subscription details instantly. **How do I find my Robly API ID and API Key?** Log in to your Robly account, go to **My Account** (top right), and you will find your unique **API ID** and **API Key** listed in the account overview.