# Ometria Email Events MCP > Ometria Email Events tracks and analyzes every interaction with your email campaigns—opens, clicks, bounces, and unsubscribes. Connects Ometria data directly to your AI agent so you can query real-time marketing performance metrics instantly. You get a full picture of deliverability health, contact engagement history, and campaign attribution without leaving your chat window. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** event-tracking, email-analytics, deliverability, marketing-insights, real-time-events ## Description You can connect Ometria's raw event data directly to your agent. This server lets your AI client read everything that happens in your email campaigns, giving you real-time marketing metrics without leaving your chat window. You won't have to jump between dashboards just to figure out why a campaign isn't hitting its marks. **Monitoring Campaign Health and Deliverability** You wanna check your sending health? You can use `list_email_bounces` to pull a list of every bounce event, so you know exactly which addresses are dead ends. For sender reputation, running `list_email_complaints` gives you records of spam complaints—you gotta track those fast. If you just need a general overview of everything happening across your whole account right now, use `list_recent_email_events`. You can also pull a broad set of all recorded activity using `list_email_events`. **Tracking Core User Engagement** Want to know who opened the emails? Use `list_email_opens` for those basic metrics. To see what links people actually clicked, run `list_email_clicks`; this gives you a log of every user interaction with specific content. You can track audience drop-off by running `list_email_unsubscribes`, keeping your list clean and compliant. **You'll** also get the full picture of any general engagement events using `list_events_by_campaign` if you want to filter all activity tied to a single marketing tag. **Deep Diving into Specific Data Sets** You need history for one person? Use `list_events_by_contact` and you'll get the complete email interaction timeline for that specific customer ID. If you only care about a particular campaign, **you can** limit your search using `list_events_by_campaign` with just the tag name. For maximum detail on any single piece of activity, use `get_event_details`. This pulls all the metadata and timestamps associated with one unique event ID so you know exactly what happened and when. To get a full audit trail for every single thing that’s ever clicked or bounced, **you can** run specialized queries: `list_email_clicks` tracks every link click, while `list_email_bounces` collects all the bad addresses. ## Tools ### get_event_details Gets full metadata for a single email event using its unique ID. ### list_email_bounces Lists all email bounce events recorded by Ometria, helping you clean up bad addresses. ### list_email_clicks Lists every email click event from Ometria, tracking user interest in specific links. ### list_email_complaints Lists all spam complaint events to monitor your sender reputation and detect issues fast. ### list_events_by_campaign Lists engagement events specific to a given marketing campaign tag. ### list_events_by_contact Lists all recorded email events for one specific customer or contact ID. ### list_email_events Lists a comprehensive set of general email engagement events from Ometria. ### list_email_opens Lists all email open events, giving you basic metrics on who viewed the message. ### list_recent_email_events Lists the most recent general email activity across your entire account. ### list_email_unsubscribes Lists all unsubscribe events from Ometria, tracking audience opt-out trends. ## Prompt Examples **Prompt:** ``` List all email open events from the last hour. ``` **Response:** ``` Retrieving recent opens... I found 45 open events in the last hour. Most activity is coming from the 'Holiday Special' campaign. Would you like to see which specific links were clicked as well? ``` **Prompt:** ``` How many bounces occurred in campaign 'camp_98765'? ``` **Response:** ``` Checking campaign events... Campaign camp_98765 recorded 12 bounces. 8 were 'Permanent' (hard bounces) and 4 were 'Transient'. Shall I list the contact emails that hard bounced so you can clean your list? ``` **Prompt:** ``` Show me the email engagement history for 'john@example.com'. ``` **Response:** ``` Fetching contact history... John Smith (john@example.com) has a very active history: 12 opens and 5 clicks across 3 campaigns in the last 30 days. He recently clicked a link in the 'Loyalty Rewards' email. Would you like the full timestamped log? ``` ## Capabilities ### Get Specific Event Details Retrieves full metadata and timestamps for one specific email interaction using a unique event ID. ### List Email Bounces Gathers a list of all recorded email bounce events, helping you identify invalid contacts. ### List Email Clicks Pulls a log of every click event to track which links users interacted with. ### List Spam Complaints Retrieves records of email spam complaints, critical for monitoring sender reputation. ### List All Email Events Lists a comprehensive set of all recorded email engagement events from Ometria. ### List Email Opens Gathers data on which users opened the emails, providing basic engagement metrics. ### List Unsubscribes Tracks and lists all email unsubscribe events, keeping your audience list clean and compliant. ### Get Events by Campaign Filters and lists engagement events associated with a single marketing campaign tag. ### Get Events by Contact Retrieves the complete email interaction history for one specific customer or contact ID. ### List Recent Email Events Fetches a list of the most recent general email events to track live campaign launches quickly. ## Use Cases ### Why did Campaign Alpha perform poorly? A marketer notices low engagement on a new campaign. They ask their agent to run `list_events_by_campaign`. The agent quickly pulls all events, showing that while opens were high, the click rate is near zero. This tells the marketer they need to rewrite the CTA copy immediately. ### Need proof of communication for a client call. A CSM needs to confirm if a key account executive saw the product update email before their meeting. They prompt the agent with 'Show me the email engagement history for [executive]@corp.com'. The agent uses `list_events_by_contact` and confirms not only that it was opened, but also when. ### Cleaning up a stale lead list. A CRM manager needs to segment out inactive users. They ask the agent to combine data from `list_email_bounces` and `list_email_unsubscribes`. The agent processes both lists, giving them a clean, actionable subset of contacts for re-engagement. ### Tracking live launch success. The marketing team launches a sale email. They ask the agent to run `list_recent_email_events`. The real-time feed streams in activity, allowing them to see if clicks are coming through right away and spot any immediate deliverability roadblocks. ## Benefits - Pinpoint the issue instantly. Instead of sifting through logs, you can ask your agent to run `list_email_bounces` to immediately identify which contacts need cleaning up. It's instant list hygiene. - Understand customer intent. Use `list_events_by_contact` to pull a single user’s entire interaction history. You see if they opened the welcome email but never clicked the pricing link, telling you exactly where to guide them next. - Measure campaign performance by tag. Running `list_events_by_campaign` lets you compare Campaign A vs. Campaign B side-by-side—you get all opens and clicks grouped instantly without manual filtering. - Protect your sender score. Accessing spam complaints via `list_email_complaints` means you don't wait for a report; the data is right there when you need to react, keeping your emails inbox-safe. - Keep track of list health. The agent handles `list_email_unsubscribes`, making sure you always know who opted out and why. It keeps your compliance records solid. ## How It Works The bottom line is that you talk to your agent in natural language, and it pulls the complex marketing data for you. 1. Subscribe to this server and provide your Ometria API Key (X-Ometria-Auth). 2. Ask your AI client for the data. For example: 'Show me all click events from campaign X.' 3. The agent uses the appropriate tool, fetches the raw event logs, and formats the findings into a readable response. ## Frequently Asked Questions **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. **How do I use `list_events_by_contact` to view a single user's activity history?** It returns all recorded events for one specific ID. You provide the contact's unique identifier, and the agent pulls every open, click, or bounce linked to that account. This gives you a complete timeline of their engagement. **What information does `get_event_details` pull when I input an event ID?** It retrieves the full metadata log for that single incident. You'll get precise timestamps, source IP addresses, and any specific campaign identifiers tied to it. This is useful for deep forensic analysis. **If my campaign was huge, are there rate limits when calling `list_email_events`?** Yes, like all external APIs, the server enforces standard rate limits. For massive datasets, focus on filtering by date range or running smaller batches of requests. The agent will guide you if a limit is hit. **How can I compare opens and clicks for one campaign using `list_events_by_campaign`?** You run two separate calls: one for opens and one for clicks, both filtered by the campaign ID. Your AI client then compares the lists and tells you the ratio or total activity count. **What happens if I forget a required parameter when calling `list_email_bounces`?** The call fails, and your agent will immediately report an error. It won't proceed until you provide the missing data—like a specific date range or campaign name. The system requires proper context to run.