# Ometria Email Events MCP for AI Agents AI Agent Connect > Ometria Email Events MCP lets you track email engagement directly through your AI agent. Monitor opens, clicks, bounces, and unsubscribes in real-time to manage your marketing campaigns and maintain your sender reputation without switching tabs. ## Overview - **Category:** marketing-automation - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_oUVtQGCjkq9PDFBkPHf9A6unZJpuQbI99YRlUxsP/ai-agent-connect - **Tags:** event-tracking, email-analytics, deliverability, marketing-insights, real-time-events ## Description Imagine you're halfway through a campaign launch and need to know if people are actually clicking the links or if your emails are hitting the spam folder. Usually, this means digging through a complex dashboard, filtering by campaign ID, and squinting at rows of data while your audience waits. With this Connector, you just ask your AI agent for the latest status. You can pull up a contact's entire history to see how they've interacted with your brand over months or check if a specific campaign is triggering a spike in unsubscribes. It turns your email marketing data into a conversation. Because Vinkius hosts this Connector, you can plug it into your existing workflow and get these insights instantly. It's about getting the answers you need to make quick decisions without the friction of manual data retrieval. Instead of having multiple tabs open to cross-reference campaign IDs with click rates, you get a single source of truth. You can identify which specific links are driving the most traffic and which ones are being ignored. This lets you pivot your strategy on the fly, whether you're adjusting your messaging or cleaning up your distribution list. It's about moving from looking at data to actually using it to improve your reach. ## Tools ### get_event_details Pulls the full metadata and timestamp for a specific email event using its unique ID. Use this to see the exact details of a single interaction. ### list_email_bounces Lists all email bounce events to help you identify delivery failures. This helps you spot hard bounces that need immediate attention. ### list_email_complaints Lists email spam complaints to help you protect your sender reputation. Monitoring these is key to staying out of the junk folder. ### list_events_by_campaign Lists all engagement events tied to a specific marketing campaign. Use this to see the overall performance of a specific initiative. ### list_email_clicks Lists all email click events so you can see which links are performing best. Use this to measure your call-to-action success. ### list_recent_email_events Lists the most recent email events for real-time campaign monitoring. This is perfect for checking live launches. ### list_email_unsubscribes Lists email unsubscribe events to keep your audience lists clean. Use this to spot patterns in audience fatigue. ### list_events_by_contact Lists all engagement events for a specific customer or contact ID. This gives you a complete history of a person's journey. ### list_email_events Lists all engagement events from your Ometria account. This provides a broad overview of all recent activity. ### list_email_opens Lists all email open events to track your reach. Use this to see how many people are actually seeing your content. ## Prompt Examples **Prompt:** ``` How many people opened our last newsletter? ``` **Response:** ``` Checking your recent activity... I found 1,240 opens for the 'Weekly Roundup' campaign. Here is a summary of the engagement: | Metric | Count | | :--- | :--- | | **Total Opens** | 1,240 | | **Unique Clicks** | 312 | | **Bounces** | 14 | Would you like to see a list of the specific links that were clicked? ``` **Prompt:** ``` Did John Smith open the last email? ``` **Response:** ``` Checking John Smith's history... Yes, he opened the 'Loyalty Rewards' email 2 hours ago. He has also clicked 3 other links in our last 30 days. **Recent Activity:** - **Loyalty Rewards**: Opened (2 hours ago) - **Monthly Update**: Clicked (Yesterday) - **Welcome Series**: Opened (Last month) ``` **Prompt:** ``` Show me the bounce rate for campaign camp_98765. ``` **Response:** ``` Analyzing campaign camp_98765... There were 12 total bounces recorded for this campaign: - **Hard Bounces**: 8 (Permanent failures) - **Soft Bounces**: 4 (Temporary issues) I can list the specific emails that hard bounced if you want to clean your list. ``` ## Capabilities ### Track real-time email opens See how many people are viewing your emails as they happen. ### Identify specific link clicks Find out which parts of your email content are driving the most engagement. ### Monitor bounce statuses Get a clear view of delivery failures to keep your list healthy. ### Audit spam complaints Watch for complaints to protect your sender reputation. ### Review unsubscribe trends Track how many people are opting out to identify audience fatigue. ### Pull individual contact histories See every interaction a specific customer has had with your emails. ### Fetch campaign-specific engagement Get a full breakdown of how a specific marketing campaign performed. ## Use Cases ### Checking a live launch A marketer asks the agent for recent opens to see if the 'Flash Sale' is hitting the target audience. The agent pulls the data instantly using list_recent_email_events. ### Pre-call verification A success lead asks if a specific client opened the 'Getting Started' guide before a scheduled demo. The agent checks the history via list_events_by_contact. ### List cleaning A CRM manager identifies hard bounces using list_email_bounces to remove dead emails from the database, keeping the mailing list healthy. ### Campaign autopsy A team analyzes list_events_by_campaign to see which specific links got the most traction after a newsletter, helping them plan the next one. ## Benefits - Stop manual dashboard hunting by using list_recent_email_events to see what's happening right now without logging into a portal. - Protect your sender reputation by quickly auditing list_email_complaints and list_email_bounces to spot issues before they escalate. - Get a 360-degree view of a customer's journey using list_events_by_contact to see every interaction they've had with your brand. - Measure campaign success accurately with list_events_by_campaign to see which tactics actually work for your audience. - Keep your lists healthy by monitoring list_email_unsubscribes to identify audience fatigue before it becomes a major problem. ## How It Works The bottom line is you get instant access to your email marketing data through a natural chat interface. 1. Connect your Ometria account to the Connector through the Vinkius dashboard. 2. Provide your X-Ometria-Auth API key to authorize the connection. 3. Ask your agent to check campaign stats, list recent opens, or pull contact history. ## Frequently Asked Questions **Can Ometria Email Events MCP show me clicks?** Yes, you can use it to see exactly which links are being clicked in your campaigns. It provides a clear view of your call-to-action performance. **How do I use Ometria Email Events MCP for deliverability?** You can use it to monitor bounce rates and spam complaints in real-time. This helps you identify issues with your sender reputation as they happen. **Can Ometria Email Events MCP track unsubscribes?** Yes, it tracks unsubscribe events so you can monitor audience fatigue and keep your mailing lists clean and compliant. **Does Ometria Email Events MCP work with Claude?** Yes, it works with Claude and any other MCP-compatible client. You can ask your agent for your email data just like you're talking to a teammate. **How does Ometria Email Events MCP help with list cleaning?** It helps by listing hard bounces and unsubscribe events. This makes it easy to identify which contacts should be removed from your active mailing list. **Can I see contact history with Ometria Email Events MCP?** Yes, you can pull the full engagement history for any specific contact. This shows every open and click that person has ever made with your emails. **How do I get an Ometria API Key?** You can generate an API key in the Ometria settings dashboard under the API tab. This key is used for the `X-Ometria-Auth` header. **Can I see who marked an email as spam?** Yes! Use the `list_email_complaints` tool to retrieve a list of events where users marked your emails as spam, including contact identifiers. **Does this support SMS events?** This implementation specifically targets email engagement events (opens, clicks, bounces, etc.). For SMS tracking, please check if your Ometria instance exports these through the same events endpoint.