PredictHQ Event Intelligence MCP. Audit global event attendance and metadata instantly.
Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
PredictHQ Event Intelligence connects global event data directly into your agent workflow. It lets you search for everything—from local festivals to international sports matches—using natural language.
You can instantly get detailed metadata, check the PredictHQ impact rank of any venue, and audit attendance patterns across specific categories (concerts, sports, conferences).
This server turns complex market research into simple conversation.
What your AI agents can do
Check api status
Checks if the PredictHQ server is currently online and operational.
Get event details
Retrieves full event metadata, including location and ranking, using a specific event ID.
List event categories
Lists all major event categories supported by the server (e.g., 'concerts', 'sports').
The agent searches across all listed types (concerts, sports, festivals) using keywords or categories.
You pass an event ID to retrieve full details, including location data and the PredictHQ impact rank.
The agent queries the system to get a list of supported categories (e.g., 'sports', 'festivals').
You run a simple check to confirm that the PredictHQ service is running correctly.
Ask AI about this MCP
Supported MCP Clients
Waiting for input…
PredictHQ Event Intelligence MCP Server: 4 Tools for Event Analysis
Use these four tools to audit event details, search across categories, list supported types, or check the server's operational status.
019d8470check api status
Checks if the PredictHQ server is currently online and operational.
019d8470get event details
Retrieves full event metadata, including location and ranking, using a specific event ID.
019d8470list event categories
Lists all major event categories supported by the server (e.g., 'concerts', 'sports').
019d8470search predict events
Searches for global events across different types based on provided keywords, location, or date ranges.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with PredictHQ Event Intelligence, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
PredictHQ Event Intelligence hooks your agent right into the global event data stream. Forget jumping through a dozen different ticketing sites or market research portals; this server handles it all for you. It turns massive, messy datasets into structured context your AI client can actually work with.
When you use PredictHQ, your agent doesn't just find an event; it pulls the whole dossier—the metadata, the location specifics, and the current industry impact ranking. You’re not dealing with estimates here; you’re getting actionable data points on everything from local street festivals to massive international athletic tournaments.
The process starts simple: You first confirm connectivity by running check_api_status. This call immediately tells your agent if the PredictHQ server is up and operational, ensuring your workflow doesn't stall because of a downed API. It's a quick check that saves you time when you need speed.
Next, you define your search scope. If you don’t know what kind of event you want to track—say, if you aren't sure whether you're looking at 'concerts,' 'sports,' or maybe 'conferences'—you run list_event_categories. This tool returns a comprehensive list of every major category the system tracks. It lets your agent build its search parameters accurately from the start.
Once the scope is set, you execute a global event search using search_predict_events. You can feed this tool keywords—like 'tech summit' or 'rock festival'—or pin down a general location and date range. The agent doesn't just spit out titles; it searches across all listed types of events globally, giving you an immediate list of potential matches that fit your criteria.
When the search returns a specific event ID that looks promising, you drill down into the specifics using get_event_details. This is where the heavy lifting happens. By feeding just the unique event ID into this tool, your agent retrieves every piece of full metadata available. You get location data, detailed descriptions, and critically, you get the official PredictHQ impact rank for that specific venue or gathering.
This ranking tells you how significant the event's market presence is right now.
If you need to audit attendance patterns across different types of gatherings—like comparing past audience sizes at sports stadiums versus festivals—you use the combined data from search_predict_events and then validate those specific figures by calling get_event_details on each key ID. The server lets your agent process both keyword-driven discovery and deep, structured metadata retrieval in one workflow.
It means you don't have to switch tools or services; the whole event intelligence cycle happens inside your agent context.
How PredictHQ Event Intelligence MCP Works
- 1 Subscribe to the PredictHQ MCP Server and configure your unique API Key.
- 2 Your AI client initiates a call, passing required parameters (e.g., search location, event type) to one of the defined tools.
- 3 PredictHQ processes the request against its database and sends structured JSON data back to your agent for immediate use.
The bottom line is: you stop interacting with external websites and start talking directly to a reliable, centralized event intelligence API.
Who Is PredictHQ Event Intelligence MCP For?
This server is built for the data analysts and operations leads who spend too much time clicking through multiple industry sites just to find one piece of metadata. It’s for the logistics manager whose job hinges on knowing an event's exact location and predicted attendance scale, without manual searching.
Uses search_predict_events to monitor broad event trends across regions and pull official impact metadata into a spreadsheet for comparison.
Calls get_event_details with a specific ID to verify location coordinates or check if an event's attendance patterns fit current operational capacity.
Uses list_event_categories and then search_predict_events to identify new, untapped thematic clusters for future campaign focus.
What Changes When You Connect
- Audit Global Scope: Use
search_predict_eventsto pull data on thousands of events across every category—concerts, festivals, sports. You don't need to open a single external website; the agent gets all the initial leads for you. - Pinpoint Rank: The
get_event_detailstool gives you immediate access to the PredictHQ impact rank. This tells you which events are current industry leaders in attendance scale, letting you filter out low-impact noise. - Deep Location Checks: Don't just get a city name; use event IDs and
get_event_detailsto pull high-resolution location metadata. This is crucial for logistics planning and classification. - Zero Category Guesswork: When you’re unsure what kind of data to look for, run
list_event_categories. It gives you a clean list—'sports', 'festivals', etc.—so your agent knows exactly which thematic cluster to search next. - Instant Verification: Before running any complex analysis, check the server health with
check_api_status. This prevents wasted cycles and keeps your entire event research workflow reliable.
Real-World Use Cases
Analyzing a new market segment
A marketing team needs to know if 'eco-festivals' are growing in the Pacific Northwest. Instead of manually checking five different local directories, the agent first runs list_event_categories to confirm 'festivals' is supported. Then it calls search_predict_events(type='festivals', location='PNW'), retrieving a list of candidates and their associated metadata for rapid review.
Validating competitor event size
A business planner needs to know the predicted scale of a rival's upcoming sports championship. They use search_predict_events first to find the specific event ID, and then immediately call get_event_details(event_id='XYZ'). This pulls the PHQ rank and attendance metrics in two steps, giving them immediate competitive intel.
Troubleshooting a data pipeline
An ops engineer wants to run an automated report but gets connection errors. The first step is running check_api_status. If the status returns 'OK,' they know the problem isn't the server; if it fails, they immediately stop and fix the API key or connectivity.
Building a comprehensive event map
A large-scale organizer needs to build a regional map of all possible events. They use list_event_categories to get the full list, then run targeted searches—e.g., search_predict_events(type='concerts', location='Miami') and another for search_predict_events(type='sports', location='Miami')—to ensure comprehensive coverage.
The Tradeoffs
Trying to search by generic text
Just asking the agent, 'Tell me about big events in Europe.' This is too vague and doesn't specify what kind of data or scale you need.
→
Run search_predict_events with specific parameters. For example: search_predict_events(type='concerts', location='Berlin', date_range='next month'). This forces the agent to query the structured tool, giving precise results.
Ignoring API status checks
Relying on a complex data pull from search_predict_events when the server might be down or experiencing rate limiting.
→
Always start by running check_api_status. This simple initial call verifies connectivity. If it fails, you stop before wasting time building code around bad data.
Over-relying on search results alone
Getting a list of 20 events from search_predict_events but not knowing which ones are actually major players.
→
Use the event IDs you find in the search and pass them individually to get_event_details. This pulls the critical PredictHQ rank, allowing you to prioritize your investigation.
When It Fits, When It Doesn't
You should use this server if your primary need is structured, verifiable data on global events. If you are building a system that requires knowing event location metadata, predicted attendance scale (the PHQ Rank), or cross-category comparisons (e.g., comparing sports vs. festivals in the same city), this toolset is mandatory. Don't use it if you just need general market sentiment or qualitative analysis—that’s for unstructured text models. If your only goal is to read an event brochure, don't bother connecting it; just look at the PDF. However, if that brochure has a unique ID and you want its structured data points (location, rank), then use get_event_details. Never assume the server works without first running check_api_status.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by PredictHQ. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 4 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Finding event data shouldn't feel like an archaeological dig through five different websites.
Today, tracking a single market segment means opening Google, finding the official festival site, cross-referencing it with a sports league page, and then trying to find local news coverage. You spend hours copying event IDs and manually comparing metadata—a process that guarantees missing data points or outdated rankings.
With this server, your agent runs `search_predict_events` once. It instantly pulls the structured data you need: start times, location coordinates, and the PredictHQ rank for every match. You get a clean, actionable JSON payload right in your chat window.
PredictHQ Event Intelligence MCP Server: Get verified event rankings with `get_event_details`.
Without this server, determining if an event is genuinely 'major' requires gut feeling or manual cross-checking against multiple industry sources. You waste time guessing whether the attendance numbers are reliable or just marketing hype.
Now, you pass an ID to `get_event_details`. The agent immediately returns the official PredictHQ rank and verified metadata. You know the current lead in attendance scale without leaving your workflow.
Common Questions About PredictHQ Event Intelligence MCP
What is the difference between `search_predict_events` and `get_event_details`? +
search_predict_events finds multiple potential events based on general criteria (like location or type). get_event_details requires a specific event ID to pull all the deep metadata and rankings for that single item.
Do I need to run `check_api_status` every time? +
It's best practice. Running check_api_status first confirms the server is live before your agent attempts complex searches, saving processing cycles if there's an outage.
How do I find out what event types are available? +
Run list_event_categories. This tool provides a complete list of supported categories like 'concerts', 'sports', and 'festivals', so you know what parameters to pass to the search function.
Can I use PredictHQ Event Intelligence for non-global events? +
No. This server is designed for global event intelligence, pulling data from major international sources. It's not intended for hyper-local or private community events.
What credentials must I provide when using `search_predict_events`? +
You must supply your PredictHQ API Key during setup. This key is necessary for the server to authenticate your requests and access restricted event data.
If I pass a malformed ID, what error does `get_event_details` return? +
The tool returns an explicit 'ID not found' or validation failure message. Always verify that the event ID is correct before running get_event_details to prevent workflow interruption.
Are there usage limits when I run multiple searches with `search_predict_events`? +
Usage rates are governed by your specific PredictHQ subscription tier and API Key. Refer to the PredictHQ developer portal for exact request caps and rate limit details.
How do I ensure I get accurate geographic intelligence from `get_event_details`? +
You must provide a valid event ID, and the resulting metadata object contains high-resolution location fields. These structured data points help classify logistics for your planning.
How do I find my PredictHQ API Key? +
Log in to your PredictHQ control center, 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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Clash Royale Tactical Intelligence
The definitive server for Clash Royale — track chest rotations, analyze battle decks, and monitor clan wars via AI.
Dextools (DeFi Token Data API)
Access real-time DeFi market data, token prices, liquidity pairs, and blockchain information across multiple networks via Dextools.
Statistics Engine
A zero-latency statistical engine to process datasets. Instantly compute the exact mean, median, mode, standard deviation, and percentiles completely local.
You might also like
BibTeX Bibliography Parser
Parse academic .bib bibliography files into structured JSON. Let your AI format citations in APA, IEEE, or Chicago style instantly local.
edX
Search and discover online courses from Harvard, MIT, Berkeley and 160+ top institutions on edX.
Cheddar
Manage usage-based billing and subscriptions via Cheddar — track usage, monitor invoices, and manage customers directly from any AI agent.