# HypeAuditor MCP MCP

> HypeAuditor lets you analyze influencers and retrieve deep audit reports by connecting directly to its API. Need to vet a creator for a brand campaign? This MCP searches across Instagram, YouTube, and TikTok, providing detailed metrics on authenticity, engagement, and reach. It's built for anyone serious about data-driven marketing or protecting brand reputation from bad actors online.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** influencer-marketing, social-analytics, audience-insights, brand-safety, campaign-reporting, creator-economy

## Description

You need reliable data when vetting influencers. HypeAuditor gives your AI agents a direct line to industry-leading analytics covering Instagram, YouTube, and TikTok. Instead of relying on guesswork or surface-level metrics, you can search for creators using specific filters like country, platform, or category. When you find a potential partner, the system retrieves detailed audit reports that show actual performance data. This means your agent knows exactly how engaged an account is and if it meets brand safety standards before anyone signs a contract. All these capabilities are managed through Vinkius, making HypeAuditor accessible to any MCP-compatible client you use.

It’s designed for the marketing team that can't afford to guess. You get full control over your account insights and audit history—all in one place.

## Tools

### get_account_info
Retrieves specific details about your HypeAuditor account setup and usage status.

### get_influencer_report
Pulls a detailed, multi-metric audit report for any given influencer ID.

### get_rate_limit
Checks and reports the current status of your API usage limits and remaining credits.

### list_categories
Provides a list of recognized influencer niche categories (e.g., fashion, gaming).

### list_countries
Lists all geographical regions the API can filter influencers by.

### list_influencer_types
Provides a list of recognized influencer account types (e.g., macro, nano).

### list_languages
Lists all languages supported for filtering content or audience demographics.

### list_platforms
Shows which social media sites (like TikTok or YouTube) the API supports searching on.

### list_reports
Retrieves a list of all historical audit reports that have been saved to your account.

### search_influencers
Searches the database for influencers by combining various filters (location, platform, type).

## Prompt Examples

**Prompt:** 
```
Search for fashion influencers in France on Instagram.
```

**Response:** 
```
I'll fetch the list of fashion influencers from HypeAuditor for you.
```

**Prompt:** 
```
Get an audit report for influencer ID 'xyz-123'.
```

**Response:** 
```
I'll retrieve the detailed audit report for that influencer.
```

**Prompt:** 
```
Check my current API rate limit and credits.
```

**Response:** 
```
I'll check your HypeAuditor account status and rate limits.
```

## Capabilities

### Search Influencers
Find potential brand partners by applying multiple filters, such as country or social platform.

### Generate Audit Reports
Retrieve comprehensive performance reports for a specific influencer ID.

### Check Account Status
Verify your current API access level and usage limits to prevent service interruptions.

### List Metadata
Get lists of supported options, like available social media platforms or influencer types, for filtering searches.

## Use Cases

### Need to vet creators for a new product launch in Germany.
The agent uses `list_countries` (Germany) and combines it with `search_influencers`, filtering by the 'Fashion' category. It then runs `get_influencer_report` on the top results to confirm their engagement rate before presenting them to the client.

### A campaign needs to focus only on professional gaming accounts.
The agent first calls `list_influencer_types` to ensure 'Gaming' is a valid type. It then runs `search_influencers` using this filter and combines it with `list_platforms` (Twitch) to pull the ideal list for the creative team.

### The client needs to know if they can run 50 searches today.
Instead of running into an error, the agent first checks the API status using `get_rate_limit`. This prevents wasted time and informs the user exactly how many more queries are possible.

### We need to compare results from last quarter's campaign.
After a successful run, the agent calls `list_reports` to get a structured list of all previous reports. This allows the user to easily retrieve and compare historical data sets for performance analysis.

## Benefits

- Stop guessing about reach. Use `get_influencer_report` to pull detailed, verified metrics on an influencer's engagement rate and audience authenticity.
- Filter massive datasets instantly. Combine calls like `list_countries` with `search_influencers` to find exactly who you need in a specific region.
- Stay operational always. Run `get_rate_limit` before big pulls so your agent knows when it needs to slow down or wait for credits.
- Expand search options quickly. Use metadata tools like `list_platforms`, `list_categories`, and `list_influencer_types` to build complex, precise queries.
- Keep records clean. Call `list_reports` after a campaign run to get a structured list of all the audit data you collected for billing or review.

## How It Works

The bottom line is, you tell your AI what kind of creator you need, and it pulls all the necessary background reports for review.

1. Start by checking your API rate limit using the `get_rate_limit` tool to ensure you have credits before running any large queries.
2. Use `search_influencers` and combine it with metadata calls, like listing countries via `list_countries`, to narrow down your target audience profile.
3. Once an influencer is identified, call `get_influencer_report` to pull the full audit data set into your agent's context.

## Frequently Asked Questions

**How do I find influencers who talk about tech and live in Canada using HypeAuditor MCP?**
Use `search_influencers` by combining the filters. First, call `list_countries` to confirm 'Canada', then use that list alongside your desired niche category from `list_categories`.

**Do I need a special tool for checking rate limits with HypeAuditor MCP?**
Nope. You just call the built-in `get_rate_limit` tool. This tells your agent exactly how many queries you have left, so you don't waste credits on failed searches.

**What if I want to find influencers across multiple platforms?**
You can use the `list_platforms` tool to see all options. Then, include that list when running `search_influencers` to ensure your search covers every required social media site.

**Can I get a report for an influencer using HypeAuditor MCP?**
Yes. You pass the specific ID into the `get_influencer_report` tool, and it pulls all the detailed audit metrics you need in one go.

**How do I check my HypeAuditor account status before running searches using get_account_info?**
You call the `get_account_info` tool to confirm your credentials. This action verifies your connection details and checks if your API key is active, ensuring you're ready for complex queries.

**Which specific filters or criteria are available when I use list_categories?**
You can call `list_categories`, `list_countries`, and `list_influencer_types` to get a complete, up-to-date rundown of all valid parameters. This ensures your search requests always match the API's current structure.

**How do I see a history of all the audit reports I’ve generated using HypeAuditor MCP?**
Use the `list_reports` function. It retrieves a comprehensive list detailing every report ID and date associated with your account within the system, giving you full access to your data archive.

**If I use search_influencers with complex filters, how does the MCP handle potential errors or zero results?**
The MCP returns a clear error code if your request fails due to invalid parameters. If no influencers match your criteria, it simply provides an empty dataset rather than failing the entire call.

**How do I get HypeAuditor API credentials?**
You can find your API token in the HypeAuditor dashboard under 'API Settings'. You may need an enterprise plan to access the API.

**Which platforms are supported?**
The HypeAuditor API supports Instagram, YouTube, and TikTok for influencer search and reporting.

**Can I see my credit balance?**
Yes, the get_account_info tool provides details about your current plan and remaining credits.