# PredictHQ Event Intelligence MCP > PredictHQ Event Intelligence delivers deep event data research for global demand forecasting. Your agent searches across thousands of festivals, sports matches, and concerts worldwide. It audits attendance rankings, retrieves specific location metadata, and identifies relevant market categories instantly. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** event-intelligence, demand-forecasting, market-data, attendance-tracking, real-time-data, api-integration ## Description Managing large-scale events—whether it's a music festival or an international sporting competition—requires knowing the precise data behind the hype. This MCP gives your agent access to authoritative event intelligence, acting like a real-time consultant that never needs manual searching. Instead of opening multiple portals and cross-referencing spreadsheets, you ask your AI client for what you need: 'What are the top three sports events in Berlin next quarter?' The system immediately searches global databases, pulls detailed metadata, and returns verified results directly into your workflow. When connected via Vinkius, this MCP transforms complex market research into a simple conversation. You get instant access to event data, attendance rankings, and location details without ever touching an external website. ## Tools ### check_api_status Confirms whether the PredictHQ data service is currently operational and ready for queries. ### get_event_details Pulls complete metadata, including the official ranking score, for a single specified event ID. ### list_event_categories Returns a catalog of all common event types (like 'concerts' or 'sports') supported by the system. ### search_predict_events Searches for global events, such as festivals or conferences, using keywords or predefined categories. ## Prompt Examples **Prompt:** ``` Search for concerts in 'London' for next month using PredictHQ. ``` **Response:** ``` I've retrieved several concerts in London! Notable entries include [Artist] at the O2 Arena. I can provide the PredictHQ rank and start time metadata for each of these events if you'd like. ``` **Prompt:** ``` What is the impact ranking for event ID '12345'? ``` **Response:** ``` I've retrieved the details for event 12345! It has a PHQ Rank of 85, identified as a 'Major' event with high attendance expectations. I can assist you with the location and category metadata for this site. ``` **Prompt:** ``` List event categories supported by PredictHQ. ``` **Response:** ``` I've retrieved the category catalog! Notable groups include 'concerts', 'sports', 'festivals', and 'conferences'. I can help you search for specific events in any of these thematic clusters. ``` ## Capabilities ### Search for global events You can search across thousands of worldwide events by keywords or category (concerts, sports, festivals). ### Get specific event details Retrieve full metadata and the official PredictHQ ranking score for any given event ID. ### Determine relevant event categories List all common event types supported by the service, helping you narrow down your research focus. ### Audit operational status Check if the entire PredictHQ data source is currently running and providing accurate information. ## Use Cases ### Determining market viability for a new festival site A business planner needs to know if a proposed city has enough draw. They ask their agent to run `search_predict_events` for 'festivals' in the region and then use `get_event_details` on the top results to audit the attendance rankings, confirming market potential. ### Analyzing a competitor’s event reach A marketing team wants to know what types of events are most popular in Asia. They first run `list_event_categories` to understand the scope, and then use their agent to search for specific 'concerts' to map out potential competitive gaps. ### Quickly checking logistics feasibility A logistics manager needs a location confirmation for an event they only have an ID for. They run `get_event_details` using the event ID, and the agent immediately provides high-resolution location metadata needed for routing. ### Auditing a global sports tournament's potential A demand analyst wants to see all major upcoming sports events. They use `search_predict_events` with 'sports' and the target time frame, getting a comprehensive list of candidates for deep analysis. ## Benefits - Stop guessing about a location's potential. Use the `get_event_details` tool to instantly audit an event’s PredictHQ rank, giving you a clear view of its industry lead in attendance scale. - Never waste time sifting through irrelevant data. Run `search_predict_events` to filter thousands of global events by specific keywords or categories like 'festivals' or 'sports'. - Verify your assumptions before building a plan. The system lets you use `list_event_categories` to get a master list of all supported event types, ensuring your search scope is complete. - Know if the data source is trustworthy. Run `check_api_status` first to confirm that your entire event research workflow remains operational at any moment. - Automate complex queries. Your agent handles gathering detailed metadata and location info for multiple events simultaneously, eliminating manual copy-pasting. ## How It Works The bottom line is you tell your agent what data you need—like location details or attendance rankings—and it pulls it from the global database instantly. 1. Subscribe to this MCP and enter your unique PredictHQ API Key. 2. Connect your preferred AI client (Claude, Cursor, etc.) via the Vinkius Marketplace. 3. Ask your agent a question like 'Search for major festivals in Southeast Asia' to get instant event metadata. ## Frequently Asked Questions **How does PredictHQ Event Intelligence MCP find global events?** It searches across thousands of worldwide sources for events like concerts, sports matches, and festivals. You just use the `search_predict_events` tool to begin. **Can I check if an event is big or small using PredictHQ Event Intelligence MCP?** Yes. After finding an event ID, running `get_event_details` provides the official PredictHQ impact rank for that specific event, letting you grade its scale. **Does PredictHQ Event Intelligence MCP support all types of events?** Not every type. You can use `list_event_categories` to see a catalog of the common themes—like 'festivals' and 'sports'—that the system is designed to audit. **What if I only have an event ID? Can I still get data?** Absolutely. The `get_event_details` tool lets you retrieve full metadata for a specific event using just its unique ID, which is super helpful for logistics planning. **Is PredictHQ Event Intelligence MCP reliable if the service is down?** You can confirm the system's health at any time by running `check_api_status` to ensure your event research workflow stays operational.