Search vendors
search_vendorsFind New York area event vendors, in one category or across all, filtered by area, event type, maximum published price, online booking or part of a name. Sorted by bookability score (how much an AI agent can learn and do on the vendor's own site), then price. Each result has the starting price and what it covers, how to book, and the index page to cite. For a ready shortlist across several categories, use shortlist_vendors; search is the id-only variant for ChatGPT.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_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. | |
| sort | No | "score" (default: most bookable first, then price) or "price" (lowest published starting price first, vendors without a price last; check starting_price.per, as a per-hour or per-guest rate is not a whole-event price). | score |
| limit | No | How many vendors to return, 1 to 25 (larger values are capped). | |
| 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). | |
| offset | No | How many matches to skip, to page through a long list: pass next_offset from the previous result. | |
| category | No | Vendor category in plain words ("DJ", "wedding photographer", "florist"). Omit to search every category. | |
| has_price | No | Only vendors that publish a price. | |
| event_type | No | Optional event type in plain words: "wedding", "bar mitzvah", "sweet 16", "birthday", "corporate holiday party", "baby shower". | |
| books_online | No | Only vendors whose own site shows online booking. | |
| max_price_usd | No | Only vendors whose published starting price is at or under this, in US dollars. | |
| name_contains | No | Part of the vendor's name. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| area | Yes | ||
| note | Yes | ||
| shown | Yes | ||
| offset | No | How many matches were skipped before these. | |
| cite_as | No | Agent Bookability Index by The Runup (index.therunup.ai) | |
| matched | Yes | How many vendors matched before the limit. | |
| vendors | Yes | ||
| category | Yes | ||
| list_page | Yes | The index page listing these vendors. | |
| next_offset | No | Pass this as offset to get the next page; None when there is no more. |