How to connect PredictHQ to Claude

Connect Claude Web, Desktop and Cowork 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

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your PredictHQ account to Claude via Composio Connect, enabling it to find major events near San Francisco, forecast demand around upcoming concerts, compare event impact across retail locations, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

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

Also integrate PredictHQ with

Connecting PredictHQ to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your PredictHQ account

Back in Claude, ask it to connect to PredictHQ or give it any PredictHQ-related task.

For example, ask Claude to:

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

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your PredictHQ account is ready to use.

What is the PredictHQ Claude Connector, and what's possible with it?

The PredictHQ MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your PredictHQ account. It provides structured and secure access to event intelligence, demand forecasting, and location analytics, so your agent can count relevant events, identify demand surges, create and review forecasts, assess event impact areas, and manage community event submissions on your behalf.

  • Event intelligence: Have your agent count events and broadcasts using filters for dates, locations, categories, attendance, rank, and other event details.
  • Demand surge detection: Let the agent identify dates with significant predicted demand surges for a specified location and report the expected event attendance.
  • Forecast planning: Direct your agent to create forecast models for saved business locations, review their readiness and accuracy, inspect uploaded demand data, and retrieve generated forecast results.
  • Location impact analysis: Instruct your agent to calculate predicted event impact areas as GeoJSON, create reusable saved locations, and manage their opening hours and closure periods.
  • Event feedback and submissions: Have your agent create hosted Loop links, review submitted events and feedback conversations, inspect link settings, and manage existing links.

Troubleshooting

1. Why does Claude not use the Composio connector for PredictHQ?

The connector can show as connected, but Claude must use it in each PredictHQ conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to PredictHQ again.

2. Why does Claude show an MCP server error before PredictHQ connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for PredictHQ.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect PredictHQ.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the PredictHQ authorization link not work?

The Composio connector is one server. Your PredictHQ account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the PredictHQ connection.
  • Composio creates a fresh PredictHQ authorization link.
  • Open that link in your browser and finish the PredictHQ sign-in.

4. Why do PredictHQ actions fail after they worked before?

The PredictHQ connection can expire or lose permission.

  • Ask Claude to inspect the PredictHQ connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the PredictHQ account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in PredictHQ.
  • If the action still fails with a permission error, check that the connected account has that permission in PredictHQ itself.

5. How do I switch to a different PredictHQ account?

Claude can manage the PredictHQ connection for you.

  • Ask Claude to disconnect or delete the current PredictHQ account.
  • Ask Claude to connect PredictHQ again.
  • Open the new Composio authorization link for PredictHQ.
  • Sign in with the other PredictHQ account in the browser.
  • After the account connects, ask Claude to retry the PredictHQ task.

6. Why is my PredictHQ connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your PredictHQ connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If PredictHQ tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect PredictHQ.
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