# Happierleads MCP

> Happierleads connects your AI agent directly to Happierleads data. It gives you immediate insights into B2B lead intelligence, letting you track specific website visitor activity and pull contact details for decision-makers. Your agent can summarize today's lead pipeline health without you ever leaving the chat window.

## Overview
- **Category:** crm-sales
- **Price:** Free
- **Tags:** automation, integrations

## Description

This MCP connects your AI client directly to Happierleads, transforming how you qualify leads. Instead of jumping through multiple dashboards or digging into raw Google Analytics reports, your agent pulls all necessary data right where you work. You can ask it for a summary of today's lead activity—like identifying the top accounts viewing pricing pages and suggesting who needs immediate outreach. It tracks everything from unique B2B visitors to specific company details in the software industry.

It also finds key decision-makers at target companies, giving you names, roles, and direct contact emails. You can feed this rich profile data back into your workflow. Since Vinkius hosts this MCP within the catalog, connecting it is straightforward: just plug in your preferred AI agent client and start asking questions about prospect health.

## Tools

### happierleads_info
Retrieves comprehensive lead intelligence from Happierleads, summarizing activity and providing detailed company information.

## Prompt Examples

**Prompt:** 
```
Show recent website visitors from the software industry.
```

**Response:** 
```
I found 12 companies in the software industry that visited your site in the last 24 hours. The top visitors by page views are Acme Corp, Beta Software, and Cloud Solutions Inc.
```

**Prompt:** 
```
Find contact details for decision makers at Acme Corp.
```

**Response:** 
```
Here are the top decision makers at Acme Corp: 
1. John Doe (CEO) - john.doe@acme.com
2. Jane Smith (VP of Marketing) - jane.smith@acme.com
```

**Prompt:** 
```
Summarize today's lead activity.
```

**Response:** 
```
Today, your website received 150 unique B2B visitors. 45 matches were identified, with 12 highly engaged accounts viewing pricing pages. I recommend prioritizing outreach to AlphaTech and ZetaData.
```

## Capabilities

### Summarize lead activity
Get a single summary of daily visitor counts, identified B2B matches, and highly engaged accounts viewing pricing pages.

### Identify website visitors by industry
List specific companies that visited your site in the last 24 hours, filtered by their industry sector, like software or finance.

### Find decision-maker contact details
Retrieve names and direct emails for key personnel—CEOs, VPs of Marketing, etc.—at specific target companies.

## Use Cases

### Client X is showing high interest in pricing
The agent was asked to summarize today's activity. It quickly reported 12 accounts viewing the pricing page and recommended prioritizing outreach to AlphaTech and ZetaData, allowing the sales team to follow up immediately.

### Need to find the VP of Marketing at Acme Corp
A rep asks for decision-maker contacts. The MCP finds John Doe (CEO) and Jane Smith (VP of Marketing), giving them both specific emails so the rep can start a targeted campaign.

### Need to know what types of companies are visiting
The agent is prompted to show recent website visitors. It immediately lists 12 companies in the software industry, allowing the user to focus sales efforts on that specific vertical.

## Benefits

- Stop guessing who to call. Happierleads finds the top decision-makers at a company, giving you specific names and their direct email addresses right in your chat.
- Get instant pipeline summaries. The MCP tells you exactly how many unique B2B visitors came today and which highly engaged accounts need immediate follow-up.
- Target smarter. Instead of generalized outreach, the tool lets you filter visitor data by industry (like software) so your agent only shows relevant leads.
- Cut down reporting time. You no longer have to manually aggregate daily website traffic metrics; the MCP summarizes everything for you instantly.
- Focus on selling, not searching. By automating lead scoring and prospect research with Happierleads, agents give you actionable intelligence without manual data pulls.

## How It Works

The bottom line is that instead of copying and pasting data from multiple dashboards, your agent gives you the answer instantly.

1. You tell your AI agent to pull lead data from Happierleads. You specify the criteria, maybe 'Show me software industry visitors' or 'Summarize today's activity'.
2. The MCP calls the necessary tool and pulls the raw intelligence—like visitor lists or contact details—into a structured format.
3. Your AI agent receives this organized data and presents it to you in plain English, giving immediate answers about your lead pipeline.

## Frequently Asked Questions

**What is Happierleads?**
Happierleads is a B2B website visitor identification tool that reveals which companies are visiting your website and provides contact details for decision makers.

**Where do I find my API key?**
You can generate and access your API key in the Happierleads dashboard under your Account Settings or Developer settings.

**Can I filter visitors by industry or company size?**
Yes, you can easily query and filter your website visitors by various attributes including industry, country, and employee count.

**What data format does `happierleads_info` return?**
The tool returns structured JSON data that includes key metrics like visitor counts, identified company names, and engagement scores. The response is always organized to make it easy for your AI client to parse immediately.

**What should I do if `happierleads_info` encounters a rate limit?**
If you hit a rate limit, the tool will provide an explicit error code and recommend a waiting period. Your agent should implement exponential backoff logic to retry the call automatically after a short delay.

**Can `happierleads_info` access data from multiple sources?**
Yes, this MCP pulls combined insights from various parts of your Happierleads account. It aggregates both website traffic metrics and identified decision-maker contact details into one response.

**If I get an error when running `happierleads_info`, what are the common codes?**
Common errors include '401 Unauthorized' if your connection token is expired, or '400 Bad Request' if required parameters like date ranges are missing. Always check your credentials first.

**Is there a time limit on the data retrieved by `happierleads_info`?**
The tool allows you to specify historical periods, but typically focuses on recent activity for accuracy. You must define the start and end dates within your prompt to get the desired range of visitor information.