Shortlist vendors for an event
shortlist_vendorsA shortlist for one event: for each service asked for, the most bookable New York area vendors that serve the area and event type. Ranked by how directly a consumer can act (book online, instant quote or open dates, quote form), then by fit with the budget, bookability score and price. Pass guests and hours to get each vendor's published rate worked out for the event (estimate). Use it to answer "help me find a DJ, caterer and florist for a 120-guest bar mitzvah in Brooklyn, 4 hours, under $3,000 each".
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": {
"categories": "<categories>"
},
"name": "shortlist_vendors"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| area | No | Optional area: NYC (any of the five boroughs), Manhattan, Brooklyn, Queens, Bronx, Staten Island, Long Island, Westchester, North Jersey or Central Jersey, or New Jersey for both; a county or town also works (Bergen County, Hoboken, Monmouth County). Omit for the whole New York area. | |
| hours | No | Optional length of the event in hours. Per-hour prices (some DJs, photographers, bands) are worked out for this long. | |
| needs | No | Optional things the vendor must offer, as its own website states: "kosher", "halal" (caterers), "MC", "lighting", "photo booth" (DJs, bands), "second shooter" (photographers), "second videographer", "comes to you" (hair and makeup), "staff" (caterers), "delivery and setup" (florists, cakes). | |
| guests | No | Optional number of guests. Per-guest prices (catering, cakes) are worked out for this many. | |
| budget_usd | No | Optional budget per service, US dollars. Vendors whose published starting price fits come first. | |
| categories | Yes | The services needed, in plain words, e.g. ["DJ", "photographer", "florist"]. Up to 6. | |
| event_type | No | Optional event type in plain words: "wedding", "bar mitzvah", "sweet 16", "birthday", "corporate holiday party", "baby shower". | |
| per_category | No | Vendors per service, 1 to 10. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| area | Yes | ||
| hours | No | ||
| groups | Yes | ||
| guests | No | ||
| cite_as | No | Agent Bookability Index by The Runup (index.therunup.ai) | |
| budget_usd | Yes | ||
| event_type | Yes | ||
| how_ranked | Yes |