# HappierLeads MCP > HappierLeads MCP Server. Turns anonymous website traffic into actionable B2B leads. Connect your AI agent to identify visiting companies, filter by industry, and analyze deep browsing sessions. It gives you visitor data, segment insights, and real-time alerts for warm outbound prospecting. ## Overview - **Category:** sales-automation - **Price:** Free - **Tags:** visitor-identification, b2b-prospecting, intent-data, website-tracking, lead-qualification, real-time-alerts ## Description Yo, connect your AI agent to HappierLeads, and you'll turn anonymous website traffic into actionable B2B leads. You gotta know who's checking out your site, and this tool lets you nail that down. You can run `check_happier_status` to make sure the connection's up and running. Need to see what's happening overall? Use `get_analytics` to pull a summary of site traffic, getting you the total visitor count, how many companies you identified, and the conversion rates. If you want a deep dive, you can get a list of all visitors using `list_visitors`, and even narrow that down using `list_visitors_by_country` to only see people from a specific country, or run `search_visitors` with keywords, domains, or other criteria. When you're ready to focus on leads, you can use `list_leads` to see every identified B2B lead in the system, or you can use `list_qualified_leads` to pull only the leads that meet your specific qualification criteria. To narrow it down further, run `list_leads_by_industry` to filter all leads by an industry vertical. To get the nitty-gritty on a single prospect, you can grab all the details for one lead using `get_lead`, or pull specific data points for one visitor using `get_visitor`. Want to track how people are actually using your site? You can pull a list of all pages viewed by visitors over a set time period with `list_page_views`, or you can get a list of all pages that got the most views from everyone using `get_top_pages`. For a specific person, `get_session` gives you every detail for that one visitor's browsing session, including the page-by-page path and how long they spent on each page. You can also run `list_sessions` to get a list of multiple visitor sessions that happened. If you're doing targeted outreach, you can use `list_segments` to see all saved visitor segments, and `get_segment` pulls the specific criteria and details for one of those saved groups. You can also check in on any high-value activity using `list_notifications` to get a list of alerts for notable visitor activity. ## Tools ### check_happier_status Verifies if the connection to the HappierLeads service is active. ### get_analytics Pulls a summary of site traffic, including total visitors, identified companies, and conversion rates. ### get_lead Retrieves detailed information about a single identified B2B lead. ### get_segment Gets the specific criteria and details of a saved visitor segment. ### get_session Retrieves all details for a single visitor's browsing session. ### get_top_pages Lists the pages that received the most views from all visitors. ### get_visitor Gets specific data points for a single website visitor. ### list_leads Lists all identified B2B leads found in the system. ### list_leads_by_industry Lists and filters all identified leads based on a specific industry vertical. ### list_notifications Retrieves a list of alerts for high-value or notable visitor activity. ### list_page_views Lists all pages viewed by visitors over a specified time period. ### list_qualified_leads Lists only leads that meet predefined qualification criteria. ### list_segments Lists all saved visitor segments that can be used for targeted analysis. ### list_sessions Lists multiple individual visitor sessions that occurred. ### list_visitors Lists all website visitors recorded in the system. ### list_visitors_by_country Filters the list of visitors to show only those from a specific country. ### search_visitors Searches the visitor database using keywords, domains, or criteria. ## Prompt Examples **Prompt:** ``` Show all qualified leads from this week and the pages they viewed. ``` **Response:** ``` 8 qualified leads this week. Top 3 by engagement: 1) 'Acme Technologies' (SaaS, 250 employees) — 4 sessions, viewed /pricing (3 min), /enterprise (2 min), /demo (1 min). Strong buying signal. 2) 'DataFlow Corp' (Data Analytics, 120 employees) — 3 sessions, viewed /integrations (4 min), /api-docs (6 min), /pricing (2 min). Technical evaluation in progress. 3) 'GreenLogix' (Logistics, 500 employees) — 2 sessions, viewed /case-studies (5 min), /contact (30s). Research phase. Would you like to see their full session paths or filter by industry? ``` **Prompt:** ``` Show the analytics dashboard and which pages drive the most identified companies. ``` **Response:** ``` Analytics overview (last 30 days): Total visitors: 12,400. Identified companies: 342 (2.8% identification rate). Qualified leads: 89. Returning visitors: 156. Top pages by identified company visits: 1) /pricing — 78 companies (22.8%). 2) /features — 65 companies (19%). 3) /blog/ai-tools — 52 companies (15.2%). 4) /case-studies — 44 companies (12.9%). 5) /integrations — 38 companies (11.1%). High-intent signal: 23 companies visited both /pricing and /demo this month. Would you like to see the segments or check real-time notifications? ``` **Prompt:** ``` Search for visitors from 'fintech' companies and show sessions for the most engaged one. ``` **Response:** ``` Found 12 fintech visitors this month. Most engaged: 'PayStream Technologies' (visitor_891, fintech, 180 employees, London). 6 sessions over 3 weeks. Session breakdown: Session 1 (Apr 5): /home → /features → /pricing (8 min total). Session 2 (Apr 9): /blog/payment-apis → /integrations (12 min). Session 3 (Apr 14): /pricing → /enterprise → /security (15 min). Session 4 (Apr 18): /case-studies/fintech → /demo (6 min). Session 5 (Apr 22): /api-docs → /developer (18 min). Session 6 (Apr 25): /contact (2 min). This shows a classic evaluation journey — from research to technical review to contact. High priority for outreach! ``` ## Capabilities ### Identify and filter B2B visitors List all identified B2B visitors, filtering the results by country or searching specifically by company name or domain. ### Analyze specific browsing sessions Pull detailed reports on an individual visitor's session, including the exact page-by-page path and time spent on each page. ### Get performance metrics Retrieve a high-level analytics overview, showing total visitor count, identified companies, and overall conversion rates. ### Focus on high-value leads Filter and list only qualified leads, or list all identified leads, which helps in prioritizing outreach. ### Track visitor engagement over time List all pages viewed by a visitor or track all page views across a group to gauge their interest. ### Manage and narrow lead pools List and inspect saved visitor segments or filter leads by specific industry verticals. ## Use Cases ### A sales rep needs to know if a specific competitor visited. The rep asks the agent: 'Did Acme Corp visit us last week?' The agent runs `search_visitors` and `get_visitor` to pull the details. The result shows Acme's session path, including which pricing pages they viewed, giving the rep an immediate opening for a call. ### Marketing needs to prove which campaign is working. The manager asks the agent to analyze the traffic. The agent uses `get_analytics` and `list_leads_by_industry` to compare the performance of the Q2 campaign against the Q1 baseline, showing a clear lift in high-intent leads from the target vertical. ### Product team wants to find friction points in the user flow. The product manager asks the agent to analyze the site flow. The agent runs `list_page_views` and `get_top_pages` to identify pages that get lots of traffic but don't lead to a high conversion rate, pointing to a needed UX fix. ### Outreach needs to be hyper-focused on high-value regions. The SDR asks the agent to find prospects. The agent uses `list_visitors_by_country` to narrow the list down to only Germany. Then, it uses `list_qualified_leads` to ensure the resulting list is actionable, saving the rep time on low-priority contacts. ## Benefits - See a full traffic overview instantly. The `get_analytics` tool provides total visitor counts, identifies companies, and shows conversion rates without needing to build a custom dashboard. - Prioritize your list with `list_qualified_leads`. This tool filters out noise, showing you only the leads that meet your pre-set high-intent criteria. - Understand the journey with `get_session`. This pulls the page-by-page path and time spent on an individual visitor's session, helping you pinpoint where they dropped off. - Target specific groups using `list_segments`. You can inspect saved segments and refine your outreach to groups based on shared characteristics. - Geo-target your efforts with `list_visitors_by_country`. Filter the entire visitor list to focus only on markets or countries that matter to your business. - Search deep into the data with `search_visitors`. Instead of scrolling through pages, you can search the visitor records using keywords or domains. ## How It Works The bottom line is, your AI client takes the raw data and turns it into a specific, actionable insight without you needing to write complex queries. 1. Subscribe to the HappierLeads server and enter your API Key from your account settings. 2. Your AI agent calls the desired tool (e.g., `get_analytics`) via the MCP protocol. 3. The server executes the query and returns structured data, which your agent uses to perform actions or generate reports. ## Frequently Asked Questions **How do I use the `list_visitors_by_country` tool?** You pass the desired country code (e.g., 'US' or 'UK') to the agent. The tool returns a list of all site visitors who match that country filter, letting you focus your outreach. **What is the difference between `list_visitors` and `search_visitors`?** The `list_visitors` tool gives you a full list of every visitor. `search_visitors` lets you narrow that list down using specific criteria like a domain name or keywords. **Can I find out what pages a specific lead viewed using `get_session`?** Yes. If you provide the visitor ID, the `get_session` tool returns the complete page-by-page navigation path and how long they spent on each page. **How does the `get_analytics` tool help with lead generation?** It provides a high-level view, showing total visitor counts and the percentage of identified companies, giving you the top-level metrics to gauge overall performance. **Which tool should I use to see only my most promising leads? (list_qualified_leads)** Use `list_qualified_leads`. This tool specifically filters the entire pool of visitors and companies to show only those that meet your predefined high-intent criteria. **How do I use the `list_leads_by_industry` tool?** This tool filters your identified leads based on a specific industry vertical. You can narrow down your prospecting list by filtering for sectors like 'Finance' or 'Tech' to focus your outreach. **What does `get_segment` show me?** The `get_segment` tool provides details on predefined visitor groupings. This lets you check the criteria used to create a segment, ensuring your targeted analysis is based on accurate parameters. **When should I use `list_notifications`?** Use `list_notifications` to access real-time alerts about high-value visitor activity. This is your quickest way to know when a key account or target company hits the site. **Can I identify which companies are visiting my website?** Yes! The `list_visitors` tool retrieves all identified B2B website visitors with company name, industry, employee count, and visit details. Use `search_visitors` to find specific companies by name or domain, and `list_visitors_by_country` to filter by geographic region. Use `get_visitor` for the full company profile. **Can I see which pages each company visited and how long they stayed?** Yes. Use `list_sessions` with a Visitor ID to see all browsing sessions, then `get_session` for page-by-page navigation paths with time spent per page. Use `list_page_views` to get all pages viewed by a specific visitor. This reveals purchase intent — visitors spending time on pricing or demo pages are warm leads. **Can I focus only on high-intent qualified leads?** Yes. The `list_qualified_leads` tool retrieves only leads that meet your qualification criteria (e.g., multiple visits, pricing page views, minimum session duration). Use `list_leads_by_industry` to further filter by vertical. Use `list_notifications` for real-time alerts when high-value visitors are on your site.