Besttime Forecast
besttime_forecastHow busy is by hour/day (foot-traffic forecast) — creates a busyness forecast for a public venue (restaurant, bar, gym, store, museum) by name + address. Returns the 24-hour busyness curve (0-100) for each weekday plus busy/quiet/peak hours and a venue_id for later queries. Example: besttime_forecast({ venue_name: "McDonald's", venue_address: "Ocean Ave, San Francisco", _apiKey: "pri_xxx:pub_yyy" })
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"_apiKey": "pri_abc123:pub_xyz789",
"venue_name": "McDonald's",
"venue_address": "Ocean Ave, San Francisco, CA"
},
"name": "besttime_forecast"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| _apiKey | Yes | BestTime keys as "privateKey:publicKey" (pri_.../pub_...) from your besttime.app account (free test account available) | |
| venue_name | Yes | Business name, e.g. "McDonald's", "SoulCycle" (max 256 chars) | |
| venue_address | Yes | Business address, e.g. "1 Market St, San Francisco, CA" (max 1024 chars) |