Run a Promoter Brief
run_briefStart a Promoter Brief for a booking question that names an artist and a market, e.g. 'Should I book Wet Leg in Denver in October?' (a venue, date or capacity can be included). Takes about five minutes and uses one of the promoter's briefs (free, the plan's allowance, or one bought in a pack; not charged if the run needs more input or fails). Returns a job_id immediately — poll get_brief_job every 45 seconds. force_low_confidence=true runs anyway when a previous attempt reported thin data; force_refresh=true regenerates instead of reusing data from the last 24 hours. use_profile=false leaves the promoter's saved booking profile (home market, rooms, genres, guarantee range) out of the brief — use it when the question is asked on someone else's behalf or about a market the promoter doesn't book in.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "run_brief"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| use_profile | No | ||
| force_refresh | No | ||
| force_low_confidence | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | Yes | ||
| quota | No | The plan allowance after this run. Absent when the run used a purchased brief. | |
| job_id | Yes | ||
| status | No | running | |
| purchased_briefs | No | Set when this run used a purchased brief: what's left after it. | |
| estimated_seconds | Yes | ||
| poll_after_seconds | Yes |