# PredictHQ Event Intelligence MCP for AI Agents AI Agent Connect

> PredictHQ Event Intelligence lets you manage global events like festivals, sports, and conferences using your AI client. You can audit attendance rankings, find specific event types, and pull location data without leaving your chat interface. It turns complex event research into a direct conversation.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_GqQXziO593Ft9b2uEEgPaX0383kgGpQr55jJT1nb/ai-agent-connect
- **Tags:** event-intelligence, demand-forecasting, market-data, attendance-tracking, real-time-data, api-integration

## Description

PredictHQ Event Intelligence turns your AI client into a specialized event consultant. Instead of hunting through different websites to see what's happening in a city or how big a festival really is, you can just ask your agent to pull that data for you. It connects to the data source to give you access to global event trends, attendance rankings, and specific location metadata. You can find out if a concert is a major production or a small local show without ever opening a browser tab. If you're trying to figure out where demand is peaking for a new pop-up, you can query high-resolution location details or browse categories like 'sports' or 'festivals' to see what's currently trending. It's designed to get verified data into your hands quickly so you can stop guessing about market demand and start making decisions based on real numbers. This is a huge help when you're using the Vinkius catalog to build out a suite of research tools for your team. You can monitor the status of your connection to ensure your research pipeline stays active, making it a reliable way to manage large scale event audits or regional operational planning without the manual headache of clicking through multiple portals or copy-pasting data from messy spreadsheets.

## Tools

### list_event_categories
See every event category PredictHQ supports to find the right thematic markers for your audience. This helps you narrow down your search to specific types of events like sports or festivals.

### check_api_status
Verify that the PredictHQ service is up and running for your research workflow. Use this to ensure your automated queries won't be interrupted by service downtime.

### get_event_details
Pull the full metadata and impact ranking for a specific event ID to see its scale. This gives you the exact data needed to understand an event's reach and significance.

### search_predict_events
Find global concerts, sports, and festivals using keywords or specific categories. This allows you to quickly scan for relevant events in a specific geographic area.

## Prompt Examples

**Prompt:** 
```
Search for concerts in 'London' for next month using PredictHQ.
```

**Response:** 
```
I've retrieved several concerts in London for next month! Here are the highlights:

| Artist | Venue | Start Time | Impact Rank |
| :--- | :--- | :--- | :--- |
| **The Echoes** | O2 Arena | Oct 12, 20:00 | 88 |
| **Luna Ray** | Apollo Music Hall | Oct 15, 19:30 | 42 |

Would you like more details on any of these venues?
```

**Prompt:** 
```
What is the impact ranking for event ID '12345'?
```

**Response:** 
```
I've pulled the details for event **12345**:

*   **Impact Rank:** 85
*   **Status:** Major Event
*   **Category:** Music Festival
*   **Attendance Expectation:** High

This event is ranked as a significant industry lead in terms of attendance scale.
```

**Prompt:** 
```
List event categories supported by PredictHQ.
```

**Response:** 
```
Here are the primary event categories supported by the platform:

*   **Concerts**
*   **Sports**
*   **Festivals**
*   **Conferences**
*   **Exhibitions**

I can help you filter your searches by any of these categories.
```

## Capabilities

### Audit global event metadata
Get detailed information on start times, categories, and event types for thousands of global listings.

### Check impact rankings
See the official impact rank for specific events to understand their scale in the industry.

### Browse event categories
Explore different thematic clusters like concerts, sports, and festivals to find relevant audience markers.

### Pull location details
Retrieve high-resolution location metadata for specific events to assist with logistics and site classification.

### Monitor API status
Check if the data service is operational to keep your research workflow running smoothly.

## Use Cases

### Finding concerts in a specific city
A marketing manager asks for all concerts in London for next month. The agent uses search_predict_events to return a list with dates and rankings.

### Checking a festival's scale
A planner needs to know if a local festival is a major draw. They ask for the impact rank of a specific ID, and the agent pulls it via get_event_details.

### Identifying thematic markers
A researcher wants to know what kinds of events a city hosts. The agent uses list_event_categories to show all supported types like sports and festivals.

### Logistics site verification
An operations lead needs precise location data for a series of events. The agent pulls high-resolution metadata for each ID to help with site classification.

## Benefits

- Get instant access to global event metadata without opening extra tabs or navigating complex portals.
- Use search_predict_events to find specific concerts or festivals in seconds.
- Verify the scale of an event using get_event_details to see its official impact rank.
- Identify relevant audience markers by browsing categories with list_event_categories.
- Pull high-resolution location data to help with logistics and site classification.
- Keep your research pipeline running by checking the connection with check_api_status.

## How It Works

The bottom line is you get verified event data in your chat window instead of hunting for it in separate portals.

1. Subscribe to the PredictHQ Event Intelligence MCP
2. Enter your PredictHQ API Key into your AI client
3. Ask your agent to find specific events or pull attendance rankings

## Frequently Asked Questions

**Can I find festivals in a specific city using PredictHQ Event Intelligence?**
Yes, you can ask your agent to search for festivals in any city. It will pull the most current listings, including dates and impact rankings, directly into your chat.

**How do I know if an event is a 'major' one with PredictHQ Event Intelligence?**
You can request the impact rank for any specific event. This tells you how it ranks against others in terms of attendance scale and industry significance.

**Can PredictHQ Event Intelligence provide location metadata for events?**
Yes, it can retrieve high-resolution location details for specific event IDs. This is helpful for logistics planning and understanding regional constraints.

**Does PredictHQ Event Intelligence support sports and concerts?**
It supports a wide range of categories, including concerts, sports, festivals, and conferences, making it useful for diverse market research needs.

**Is the data from PredictHQ Event Intelligence updated in real time?**
The Connector provides access to the latest available data from the PredictHQ platform. You can also check the connection status to ensure your workflow is active.

**Can I use this to find event categories for my audience research?**
Absolutely. You can ask your agent to list all supported categories to see the thematic markers available for your specific audience research.

**How do I find my PredictHQ API Key?**
Log in to your [**PredictHQ control center**](https://control.predicthq.com/), navigate to the 'API' section, and generate a new token. Copy and paste it below.

**What types of events are included?**
PredictHQ includes 19 categories of events, from concerts and sports to public holidays and severe weather events.

**Can the agent show attendance rankings?**
Yes. The `get_event_details` tool retrieves the PredictHQ Rank, which indicates the expected impact and attendance metadata for an event.