`nearby_events`

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

Find PredictHQ events within a radius of a geographic point (latitude/longitude). Useful for “what is happening near this venue/store/airport” demand-forecasting queries. Filter by category and active-date window; results are ranked by predicted impact. Example: nearby_events({ latitude: 40.7128, longitude: -74.006, radius: “10km”, category: “concerts,sports” }).

Parameters

Name	Type	Required	Description
`latitude`	number	yes	Center latitude in decimal degrees, e.g. 40.7128.
`longitude`	number	yes	Center longitude in decimal degrees, e.g. -74.006.
`radius`	string	no	Search radius with unit, e.g. “10km”, “5mi” (default “10km”).
`limit`	number	no	Max events to return (default 15, max 50).

Example call

Arguments

{
  "latitude": 40.7128,
  "longitude": -74.006,
  "radius": "10km",
  "category": "concerts,sports",
  "_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":"nearby_events","arguments":{"latitude":40.7128,"longitude":-74.006,"radius":"10km","category":"concerts,sports","_apiKey":"your-predicthq-api-key"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('nearby_events', {
  "latitude": 40.7128,
  "longitude": -74.006,
  "radius": "10km",
  "category": "concerts,sports",
  "_apiKey": "your-predicthq-api-key"
});

More examples

{
  "latitude": -33.8688,
  "longitude": 151.2093,
  "radius": "5mi",
  "start": "2026-07-01",
  "end": "2026-08-31",
  "_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.

nearby_events