Skip to main content
Glama

Search vendors

search_vendors
Read-onlyIdempotent

Find 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

NameRequiredDescriptionDefault
areaNoOptional 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.
sortNo"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
limitNoHow many vendors to return, 1 to 25 (larger values are capped).
needsNoOptional 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).
offsetNoHow many matches to skip, to page through a long list: pass next_offset from the previous result.
categoryNoVendor category in plain words ("DJ", "wedding photographer", "florist"). Omit to search every category.
has_priceNoOnly vendors that publish a price.
event_typeNoOptional event type in plain words: "wedding", "bar mitzvah", "sweet 16", "birthday", "corporate holiday party", "baby shower".
books_onlineNoOnly vendors whose own site shows online booking.
max_price_usdNoOnly vendors whose published starting price is at or under this, in US dollars.
name_containsNoPart of the vendor's name.

Output Schema

NameRequiredDescriptionDefault
areaYes
noteYes
shownYes
offsetNoHow many matches were skipped before these.
cite_asNoAgent Bookability Index by The Runup (index.therunup.ai)
matchedYesHow many vendors matched before the limit.
vendorsYes
categoryYes
list_pageYesThe index page listing these vendors.
next_offsetNoPass this as offset to get the next page; None when there is no more.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changed
    • addedInput schema / properties / offset
      Added value: +{
      +  "default": 0,
      +  "description": "How many matches to skip, to page through a long list: pass next_offset from the previous result.",
      +  "title": "Offset",
      +  "type": "integer"
      +}
    • addedInput schema / properties / sort
      Added value: +{
      +  "default": "score",
      +  "description": "\"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).",
      +  "title": "Sort",
      +  "type": "string"
      +}
    • addedOutput schema / properties / next_offset
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Pass this as offset to get the next page; None when there is no more.",
      +  "title": "Next Offset"
      +}
    • addedOutput schema / properties / offset
      Added value: +{
      +  "default": 0,
      +  "description": "How many matches were skipped before these.",
      +  "title": "Offset",
      +  "type": "integer"
      +}
  2. Changed2 schema fields changed
    • changedInput schema / properties / area / description
      Previous value: -"Optional area: NYC (any of the five boroughs), Manhattan, Brooklyn, Queens, Bronx, Staten Island, Long Island, Westchester, North Jersey or Central Jersey. Omit for the whole New York area."New value: +"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."
    • addedInput schema / properties / needs
      Added value: +{
      +  "anyOf": [
      +    {
      +      "items": {
      +        "type": "string"
      +      },
      +      "type": "array"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "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).",
      +  "title": "Needs"
      +}
  3. Changed2 schema fields changed
    • addedOutput schema / $defs / Estimate
      Added value: +{
      +  "properties": {
      +    "basis": {
      +      "description": "How it was worked out, e.g. \"$35 per guest x 120 guests\".",
      +      "title": "Basis",
      +      "type": "string"
      +    },
      +    "total_usd": {
      +      "description": "Starting price for this event, US dollars, from the vendor's published rate.",
      +      "title": "Total Usd",
      +      "type": "number"
      +    }
      +  },
      +  "required": [
      +    "total_usd",
      +    "basis"
      +  ],
      +  "title": "Estimate",
      +  "type": "object"
      +}
    • addedOutput schema / $defs / VendorCard / properties / estimate
      Added value: +{
      +  "anyOf": [
      +    {
      +      "$ref": "#/$defs/Estimate"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Only in shortlists: the published starting price worked out for this event's guests or hours. A starting point, not a quote."
      +}
  4. Changed13 schema fields changed
    • addedInput schema / properties / area / description
      Added value: +"Optional area: NYC (any of the five boroughs), Manhattan, Brooklyn, Queens, Bronx, Staten Island, Long Island, Westchester, North Jersey or Central Jersey. Omit for the whole New York area."
    • addedInput schema / properties / books_online / description
      Added value: +"Only vendors whose own site shows online booking."
    • addedInput schema / properties / category / anyOf
      Added value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedInput schema / properties / category / default
      Added value: +null
    • addedInput schema / properties / category / description
      Added value: +"Vendor category in plain words (\"DJ\", \"wedding photographer\", \"florist\"). Omit to search every category."
    • removedInput schema / properties / category / type
      Removed value: -"string"
    • addedInput schema / properties / event_type
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Optional event type in plain words: \"wedding\", \"bar mitzvah\", \"sweet 16\", \"birthday\", \"corporate holiday party\", \"baby shower\".",
      +  "title": "Event Type"
      +}
    • addedInput schema / properties / has_price / description
      Added value: +"Only vendors that publish a price."
    • addedInput schema / properties / limit / description
      Added value: +"How many vendors to return, 1 to 25 (larger values are capped)."
    • addedInput schema / properties / max_price_usd / description
      Added value: +"Only vendors whose published starting price is at or under this, in US dollars."
    • addedInput schema / properties / name_contains / description
      Added value: +"Part of the vendor's name."
    • removedInput schema / required
      Removed value: -[
      -  "category"
      -]
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$defs": {
      +    "Booking": {
      +      "properties": {
      +        "contact_methods": {
      +          "description": "Ways to reach the vendor shown on its site (form, email, phone...).",
      +          "items": {
      +            "type": "string"
      +          },
      +          "title": "Contact Methods",
      +          "type": "array"
      +        },
      +        "instant_quote": {
      +          "anyOf": [
      +            {
      +              "type": "boolean"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "The site shows a price after choosing options.",
      +          "title": "Instant Quote"
      +        },
      +        "online_booking": {
      +          "anyOf": [
      +            {
      +              "type": "boolean"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "The vendor's site lets you book online.",
      +          "title": "Online Booking"
      +        },
      +        "quote_request_form": {
      +          "anyOf": [
      +            {
      +              "type": "boolean"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "The site has a form to ask for a quote.",
      +          "title": "Quote Request Form"
      +        },
      +        "shows_open_dates": {
      +          "anyOf": [
      +            {
      +              "type": "boolean"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "The site shows dates that are still open.",
      +          "title": "Shows Open Dates"
      +        }
      +      },
      +      "title": "Booking",
      +      "type": "object"
      +    },
      +    "Price": {
      +      "properties": {
      +        "amount_usd": {
      +          "description": "The vendor's lowest published starting price, US dollars.",
      +          "title": "Amount Usd",
      +          "type": "number"
      +        },
      +        "covers": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "What the price covers, in the index's words.",
      +          "title": "Covers"
      +        },
      +        "per": {
      +          "default": "event",
      +          "description": "What the price is per: \"event\", \"hour\" or \"guest\".",
      +          "title": "Per",
      +          "type": "string"
      +        },
      +        "source": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "The vendor's own page the price was read from.",
      +          "title": "Source"
      +        }
      +      },
      +      "required": [
      +        "amount_usd"
      +      ],
      +      "title": "Price",
      +      "type": "object"
      +    },
      +    "VendorCard": {
      +      "properties": {
      +        "areas": {
      +          "description": "Area keys the vendor serves.",
      +          "items": {
      +            "type": "string"
      +          },
      +          "title": "Areas",
      +          "type": "array"
      +        },
      +        "category": {
      +          "title": "Category",
      +          "type": "string"
      +        },
      +        "checked": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "description": "Date the vendor's website was read (YYYY-MM-DD).",
      +          "title": "Checked"
      +        },
      +        "how_to_book": {
      +          "$ref": "#/$defs/Booking"
      +        },
      +        "index_page": {
      +          "description": "The vendor's page on the index: cite this.",
      +          "title": "Index Page",
      +          "type": "string"
      +        },
      +        "name": {
      +          "title": "Name",
      +          "type": "string"
      +        },
      +        "score": {
      +          "description": "Bookability score 0-100: how much an AI agent can learn and do on the vendor's site.",
      +          "title": "Score",
      +          "type": "integer"
      +        },
      +        "starting_price": {
      +          "anyOf": [
      +            {
      +              "$ref": "#/$defs/Price"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null
      +        },
      +        "website": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ],
      +          "default": null,
      +          "title": "Website"
      +        }
      +      },
      +      "required": [
      +        "name",
      +        "category",
      +        "areas",
      +        "score",
      +        "how_to_book",
      +        "index_page"
      +      ],
      +      "title": "VendorCard",
      +      "type": "object"
      +    }
      +  },
      +  "properties": {
      +    "area": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "title": "Area"
      +    },
      +    "category": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "title": "Category"
      +    },
      +    "cite_as": {
      +      "default": "Agent Bookability Index by The Runup (index.therunup.ai)",
      +      "title": "Cite As",
      +      "type": "string"
      +    },
      +    "list_page": {
      +      "description": "The index page listing these vendors.",
      +      "title": "List Page",
      +      "type": "string"
      +    },
      +    "matched": {
      +      "description": "How many vendors matched before the limit.",
      +      "title": "Matched",
      +      "type": "integer"
      +    },
      +    "note": {
      +      "title": "Note",
      +      "type": "string"
      +    },
      +    "shown": {
      +      "title": "Shown",
      +      "type": "integer"
      +    },
      +    "vendors": {
      +      "items": {
      +        "$ref": "#/$defs/VendorCard"
      +      },
      +      "title": "Vendors",
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "category",
      +    "area",
      +    "matched",
      +    "shown",
      +    "vendors",
      +    "list_page",
      +    "note"
      +  ],
      +  "title": "SearchVendorsResult",
      +  "type": "object"
      +}
  5. First observed

TDQS

A4.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly/idempotent/non-destructive, so the description does not need to restate safety. It adds real behavioral context beyond them: results are ranked by a bookability score (defined inline as "how much an AI agent can learn and do on the vendor's own site"), tie-broken by price, each result carries starting price, coverage, booking route and a citable index page, and limit values above 25 are capped. It does not discuss total-match counts or truncation behavior, which keeps it below a 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences, front-loaded with purpose, then sort/return shape, then the alternative-tool routing. Some clauses are stacked and run-on (the opening sentence packs filters, sorting, ranking, and three result fields), but nothing is redundant with the title or wasted.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An 11-parameter tool with zero required params, full schema coverage, and an output schema is well served here: all 11 params are documented in-schema, the output shape is summarized in prose, and the one meaningful ambiguity (which sibling to use) is resolved. Minor gap: no note on how many matches exist in total or what happens at the offset boundary.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so per-dimension baseline is 3; the description still adds meaning by explaining the scoring dimension behind the default sort and by summarizing the filter set (area, event type, max published price, online booking, name fragment) as a coherent whole rather than isolated fields. It does not add syntax or examples beyond the schema, so it stays at 4 rather than 5.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with a specific verb and resource plus scope: "Find New York area event vendors, in one category or across all", then enumerates the filter facets and the sort order. The sibling shortlist_vendors is named, so an agent can distinguish a raw search from a curated shortlist without opening either schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly routes away: "For a ready shortlist across several categories, use shortlist_vendors; search is the id-only variant for ChatGPT." It also states the default sort and what the price sort does, so the agent knows which variant and ordering to pick.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources