`search_events`

Pack: predicthq · Endpoint: https://gateway.pipeworx.io/predicthq/mcp

Search the PredictHQ Events API for real-world events (concerts, sports, conferences, festivals, public holidays, severe weather, etc.) used for demand forecasting. Filter by free-text query, category, country, and an active-date window; results are ranked by predicted impact. Returns each event with its rank, predicted attendance, dates, and location. Example: search_events({ query: “taylor swift”, country: “US”, category: “concerts”, start: “2026-06-01”, end: “2026-12-31” }).

Parameters

Name	Type	Required	Description
`query`	string	no	Free-text search across event titles/descriptions, e.g. “marathon”.
`country`	string	no	2-letter ISO country code, e.g. “US”, “GB”, “AU”.
`limit`	number	no	Max events to return (default 15, max 50).

Example call

Arguments

{
  "query": "marathon",
  "country": "US",
  "category": "sports",
  "start": "2026-06-01",
  "end": "2026-12-31",
  "_apiKey": "your-predicthq-api-key"
}

curl

curl -X POST https://gateway.pipeworx.io/predicthq/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_events","arguments":{"query":"marathon","country":"US","category":"sports","start":"2026-06-01","end":"2026-12-31","_apiKey":"your-predicthq-api-key"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('search_events', {
  "query": "marathon",
  "country": "US",
  "category": "sports",
  "start": "2026-06-01",
  "end": "2026-12-31",
  "_apiKey": "your-predicthq-api-key"
});

More examples

{
  "query": "taylor swift",
  "category": "concerts",
  "country": "US",
  "limit": 25,
  "_apiKey": "your-predicthq-api-key"
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "predicthq": {
      "url": "https://gateway.pipeworx.io/predicthq/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

search_events