How to connect PredictHQ with ChatGPT

Connect ChatGPT to PredictHQ MCP. Find major events near san francisco, forecast demand around upcoming concerts, and more using natural language, with authentication handled for you.

PredictHQ logoPredictHQ
Api Key

PredictHQ is an event intelligence platform with APIs for events, demand, and locations. It helps businesses anticipate demand changes and plan with real-world event data.

62 Tools

How to connect PredictHQ MCP with ChatGPT

ChatGPT can take action across your apps and files, stay with a project for hours, and turn a goal into finished materials like sheets, slides, and docs, not just answers.

In this guide, I will explain the easiest and most secure way to connect your PredictHQ account to ChatGPT via Composio Connect, so it can search events, forecast demand, analyze locations, track event impact, and compare trends through natural language commands without ever putting your account credentials at risk.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate PredictHQ with

Why use Composio over default connectors?

  • Apps with read and write access. Default connectors mostly can read your data. Composio's PredictHQ integration lets ChatGPT take actions like creating drafts, sending updates, labeling records, and more.
  • 1,700+ SaaS toolkits out of the box. Composio gives you instant access to a vast catalog of pre-built connectors, from Gmail and Slack to Notion, Linear, and Salesforce.
  • One MCP server for every app. Connect any of your applications on demand through a single endpoint, rather than juggling a separate server for each app.
  • Smart, context-aware tool loading. Unlike traditional MCP servers that dump every available tool into the LLM context window, Composio searches for and loads only the tools relevant to the task at hand.
  • Cross-app automation. Chain actions across multiple apps in a single run - fetch a thread, summarize it in Notion, and post highlights to Slack without leaving the conversation.

Prerequisites

Note: Composio connects through OAuth. You will be asked to sign in and approve specific permissions. Review the permission screen carefully if you are using a work account.

Step-by-step: Connect PredictHQ to ChatGPT

1. Install the Composio plugin

Click the button. ChatGPT opens the Composio plugin page. Click Install plugin.

Install in ChatGPT

Composio plugin page in ChatGPT with the Install plugin button

You can also find it inside ChatGPT: go to Settings, open Plugins, search the marketplace for Composio, and click Install plugin.

2. Authenticate

After you install, ChatGPT asks you to authenticate with Composio. Log in and click Allow access to authorize ChatGPT to use your Composio account.

Composio login and Allow access screen for ChatGPT

3. Start using Composio

That is it. Composio tools are now available in ChatGPT. Type @Composio followed by your request, for example @Composio find unread PredictHQ messages and summarize them, and it will run the actions you authorize. On first use it asks you to authorize PredictHQ.

Option 2: Add Composio as an MCP server

If you cannot use the plugin marketplace, add Composio as a custom MCP server instead.

1. Open the MCP settings

In ChatGPT, go to Settings and open the Plugins section. Inside the Plugins page, click the MCP tab.

ChatGPT settings showing the Plugins page with the MCP tab selected

2. Add the server

Click Add server. In the Name field enter Composio, for Type select Streamable HTTP, and in the URL field paste the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
ChatGPT Add server dialog with the name Composio, type Streamable HTTP, and the Composio MCP URL

Then click Save. The Composio server now appears in your MCP plugins list.

ChatGPT Plugins page showing the Composio MCP server added to the list

3. Authenticate

Click Authenticate on the Composio entry, log in via Composio, and click Allow access. Composio tools are then available in ChatGPT the same way as with the plugin.

What you can do after connecting PredictHQ

  • Find major events near San Francisco
  • Forecast demand around upcoming concerts
  • Compare event impact across retail locations

Security + privacy notes (important)

  • Use least-privilege access: Only grant permissions you actually need.
  • Review OAuth permissions before approving: Make sure requested scopes match what you expect Composio and ChatGPT to do.
  • Keep write actions human-reviewed: For actions like sending messages, creating labels, or editing drafts, keep manual confirmation enabled.
  • Be careful with sensitive data: Avoid using this setup with highly sensitive information unless allowed by your personal, company, or client policies.
TOOLS

Supported Tools

Every PredictHQ action and event your agent gets out of the box.

Calculate Event Features

Calculate one page of daily or weekly ML-ready event features for a required date range using either a Beam analysis or a manually configured location and feature set.

Count Broadcasts

Return the total number of PredictHQ broadcast records matching optional broadcast, schedule, date, viewership, location, and event filters, without returning result records.

Count Events

Get aggregate event counts by category, label, rank level, and the same date, location, rank, attendance, spend, and event filters supported by search.

Create Beam Analysis

Create a Beam analysis that correlates an owned location's events with uploaded demand data.

Create Beam Analysis Group

Create a Beam analysis group that aggregates feature importance across compatible analyses.

Create Forecast Model

Create a forecast model for a Saved Location.

Create Loop Link

Create a hosted Loop link for end users to submit missing events or event feedback, and return both shareable URLs.

Create Saved Location

Create a reusable PredictHQ Saved Location from an exact business point, a custom GeoJSON area, or Geonames place IDs.

Create Saved Location Closure

Create a closure period for a PredictHQ Saved Location.

Create Saved Location Opening Hours

Create opening hours for a Saved Location.

Delete Beam Analysis

Soft-delete a Beam Analysis.

Delete Beam Analysis Group

Delete an existing Beam Analysis Group without deleting the individual analyses in the group.

Delete Forecast Model

Permanently deletes a forecast model and all associated demand data and forecasts.

Delete Loop Link

Soft-delete a Loop link.

Delete Saved Location

Permanently delete a Saved Location and all of its associated insights data.

Delete Saved Location Closure

Delete a closure by ID from the specified PredictHQ Saved Location.

Delete Saved Location Opening Hours

Delete an opening hours record by ID from the specified PredictHQ Saved Location.

Get Beam Analysis

Return the full details of one Beam Analysis, including its location, demand type, rank, readiness status, and processing state.

Get Beam Analysis Feature Importance

Return the Beam feature groups whose statistical significance indicates how strongly they affect an analysis's demand, including the Features API fields recommended for forecasting models.

Get Beam Analysis Group

Return the full details of one Beam Analysis Group, including its member analyses, demand type, readiness status, and processing state.

Get Beam Analysis Group Feature Importance

Return feature-importance results aggregated across the analyses in an existing Beam Analysis Group, including each feature group's Features API fields and p-value.

Get Demand Surges

Return dates with at least the requested demand-surge intensity for a required date and location, including summed predicted attendance.

Get Forecast Model

Retrieves a forecast model by ID, including its readiness status, configuration, accuracy metrics, and location details.

Get Loop Link

Return one Loop Link, including its status, metadata, expiry, and hosted event-submission and event-feedback URLs.

Get Loop Settings

Return the organization name displayed in the hosted Loop interface.

Get Predicted Impact Area

Calculate a polygonal or radial Predicted Impact Area for a business location and industry, returned as GeoJSON.

Get Saved Location

Retrieve a Saved Location by ID, including its geometry, enrichment status, labels, resolved places, summary insights, opening hours, and closures.

Get Saved Location Closure

Return a single closure by ID for the specified Saved Location.

Get Saved Location Opening Hours

Return one opening hours record by its ID for a specified PredictHQ Saved Location.

List Beam Analyses

Return one page of Beam Analyses, with filters for lifecycle state, readiness, groups, demand type, location, labels, update date, and name.

List Beam Analysis Correlation Results

Return one page of results correlating PredictHQ event data with an analysis's transactional demand data for a required lower and upper date bound.

List Beam Analysis Groups

Return one page of Beam Analysis Groups, optionally filtered by update date, name, lifecycle state, readiness, demand interval, or industry.

List Forecast Algorithms

Returns the list of available forecasting algorithms.

List Forecast Model Demand

Return one page of demand data uploaded to a forecast model, optionally filtered by date, as JSON, CSV, or newline-delimited JSON.

List Forecast Models

Return one page of forecast models belonging to the authenticated organization, optionally filtered by text, Saved Location, or readiness status.

List Loop Event Submissions

Return one page of Loop-submitted events matching link, event, user, review, state, category, location, and date filters.

List Loop Feedback Conversations

Return one page of Loop feedback conversations matching record, link, user, feedback type, status, text, and date filters.

List Loop Links

Return one page of hosted Loop links matching text, link, user, and sort filters.

List Model Forecast Results

Return one page of generated forecast results for a trained model, optionally filtered by date and enriched with features or event explainability.

List Place Hierarchies

Return one page of administrative hierarchy chains resolved from either place IDs or coordinates.

List Saved Location Closures

Return one page of closure records for a PredictHQ Saved Location, optionally filtered by the dates on which the records are active.

List Saved Location Insight Events

Return one page of events that impact a specified PredictHQ Saved Location.

List Saved Location Opening Hours

Return one page of opening-hours records for a Saved Location, optionally filtered by the dates on which the records are active.

List Saved Locations

Search and return one page of Saved Locations, including reusable location IDs, geographic definitions, enrichment state, and summary insights.

Refresh Beam Analysis

Rerun correlation and analysis processing for an existing Beam Analysis.

Refresh Beam Analysis Group

Rerun aggregation for an existing Beam Analysis Group.

Replace Beam Analysis

Fully replace an existing Beam analysis using PUT.

Replace Beam Analysis Group

Fully replace an existing Beam analysis group using PUT.

Replace Forecast Model

Fully replace an existing forecast model's mutable configuration.

Replace Loop Link

Fully replace the mutable name, expiry, and metadata of an existing PredictHQ Loop Link using PUT.

Replace Saved Location

Fully replace an existing PredictHQ Saved Location using PUT.

Replace Saved Location Opening Hours

Fully replace one PredictHQ Saved Location opening-hours record.

Search Broadcasts

Return one page of US county-level live-TV broadcast records matching event, geography, status, and date filters.

Search Events

Search for events happening in a location and date range using PredictHQ's event, location, rank, label, attendance, spend, and lifecycle filters.

Search Places

Return one page of places matching text, country, coordinates, place IDs, or administrative type filters.

Train Forecast Model

Triggers asynchronous training for a forecast model that has uploaded demand data and is in an eligible readiness state.

Update Beam Analysis

Partially update one or more fields on an existing Beam analysis without replacing fields that are omitted.

Update Beam Analysis Group

Partially update an existing Beam analysis group using PATCH.

Update Forecast Model

Partially update a forecast model.

Upload Beam Analysis Demand

Upload daily or weekly demand data to an existing Beam analysis.

Upload Forecast Model Demand

Upload historical demand data to an existing forecast model as typed JSON, CSV, or newline-delimited JSON.

Upsert Loop Settings

Create or replace the organization-wide display name used by the hosted Loop interface.

FRAMEWORKS

How to build PredictHQ MCP Agent with another framework

FAQ

Frequently asked questions

Start with PredictHQ.It takes 30 seconds.

Managed auth, hosted MCP servers, and every PredictHQ tool your agent needs.Free to start.

Start building