# HappierLeads MCP > HappierLeads MCP turns anonymous website traffic into identified B2B leads for targeted outbound prospecting. Connect your agent to pull visitor data, analyze browsing sessions, and filter down raw web activity into lists of decision-makers ready for outreach. ## Overview - **Category:** sales-automation - **Price:** Free - **Tags:** visitor-identification, b2b-prospecting, intent-data, website-tracking, lead-qualification, real-time-alerts ## Description You know how valuable it is when a potential client lands on your site—but they are anonymous. This MCP solves that problem by connecting your AI agent directly to HappierLeads. It identifies the companies visiting your website and matches them to real, actionable contacts. You stop guessing who’s interested and start talking to people who have already shown high intent. Your agent can pull detailed analytics over time, showing you top pages that drive company visits or identifying specific segments of highly engaged users. Whether you're using Claude, Cursor, or any MCP-compatible client, you get the full picture: which companies are visiting, what they viewed on your site, and when they left. Because this connector is hosted by Vinkius, your agent can access all this visitor data in one place to build targeted campaigns right from your workflow. ## Tools ### check_happier_status Verifies the connection and operational status of your HappierLeads account. ### get_analytics Retrieves a comprehensive overview of site traffic, including visitor counts and identification rates. ### get_lead Fetches detailed profile information for a single identified lead. ### get_segment Retrieves specific details about saved visitor segments you've defined. ### get_session Gets the full breakdown of a particular browsing session for deep analysis. ### get_top_pages Lists and quantifies which pages on your site are receiving the most traffic from identified companies. ### get_visitor Retrieves detailed profile data for a specific website visitor ID. ### list_leads_by_industry Filters the total pool of identified leads to show only those belonging to a chosen industry vertical. ### list_leads Generates a list of all currently identified B2B leads on your site. ### list_notifications Shows you recent alerts for high-value visitor activity that happened in real time. ### list_page_views Lists every page viewed by a set of visitors, useful for understanding content consumption patterns. ### list_qualified_leads Generates a filtered list that only contains leads meeting your defined qualification criteria. ### list_segments Shows you all the saved visitor segments created for targeted analysis. ### list_sessions Retrieves a list of multiple past browsing sessions, allowing comparison across time periods. ### list_visitors_by_country Filters the entire visitor database to show only visitors from a specific geographical location. ### list_visitors Provides a full list of all recorded website visitors with basic identifying information. ### search_visitors Searches the visitor database using keywords or criteria to find specific individuals. ## 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 ### Analyze website traffic metrics Retrieve a high-level overview of site performance, including total visitors and conversion rates. ### Search for specific visitors Find individuals who visited your site by general criteria or filter them based on their country. ### Filter leads by industry vertical Narrow down the list of identified companies to focus only on specific industries, like fintech or healthcare. ### Examine detailed browsing sessions Pull full session paths for a visitor, seeing every page they navigated and how long they spent on each one. ### List high-value contacts Generate filtered lists of leads based on specific qualification criteria or save segments for later targeting. ### Track page view history Get a list of all pages viewed by one visitor, giving context to their interest level. ## Use Cases ### A regional sales effort needs immediate targets The SDR needs to focus only on UK-based fintech companies. They prompt their agent: 'Show me all qualified leads from the UK in the financial services industry.' The agent uses list_visitors_by_country and list_leads_by_industry, giving the SDR a clean list of 15 high-priority contacts for calling. ### Marketing needs to prove content ROI The Marketing Manager wants to know if the new case study page is working. They run an analysis using get_top_pages, which reveals that /case-studies is now driving significantly more identified company visits than any other page. ### An account executive needs context for a cold call The AE wants to talk to 'Acme Technologies,' but doesn't know what they care about. They use get_visitor, which shows Acme spent 12 minutes viewing /pricing and /enterprise, giving the AE immediate talking points beyond just the company name. ### The team needs a quick list of all hot leads During a sprint planning session, the whole team needs to review who showed interest last week. They run list_leads and then use get_analytics to confirm overall site health, making sure they don't miss any high-intent signals. ## Benefits - Prioritize outreach by calling the shots on who to contact. Instead of guessing, use list_qualified_leads to pull only contacts that meet your ideal customer profile criteria. - Understand intent immediately after a visit. Use get_session and list_page_views to see the full path a visitor took through your site, knowing exactly what content caught their eye. - Focus your efforts geographically. With list_visitors_by_country, you can pull lists of potential clients from specific regions instantly, saving time on international prospecting. - Keep track of everything that matters in real-time. Use list_notifications to get immediate alerts when a high-value visitor hits the site, letting your team react fast. - Deep dive into traffic patterns with get_top_pages. This shows you which content pieces are driving the most interest from decision-makers, guiding your marketing budget. ## How It Works The bottom line is you get immediate access to actionable B2B prospect data that normally requires logging into a separate web analytics platform. 1. Subscribe to this MCP and enter your HappierLeads API Key from your account settings. 2. Pass the required parameters (like a specific date range or company name) through your AI client's prompt. 3. Your agent receives structured data containing visitor details, session paths, and qualified lead lists. ## Frequently Asked Questions **How does HappierLeads MCP identify companies from anonymous traffic?** This MCP uses advanced visitor identification tools to match anonymous IPs and cookies to known B2B company profiles. It turns a random web visit into an identified business entity. **Can I use HappierLeads MCP to track leads by industry?** Yes, you can use list_leads_by_industry to filter the total pool of contacts. This lets your agent pull only leads from specific sectors like healthcare or finance. **What is the difference between list_visitors and search_visitors using HappierLeads MCP?** list_visitors provides a comprehensive roster of all people who visited. Search_visitors lets you narrow down that massive list quickly by adding specific keywords or criteria. **Does HappierLeads MCP show me the full history for a visitor?** Yes, using get_session and list_page_views allows your agent to reconstruct the entire browsing path a single visitor took on your site. **Can I use HappierLeads MCP to check if my account is working?** You can run the check_happier_status tool. This confirms connectivity and makes sure your API key is active before you start building prompts.