Skip to main content
Glama
Sign In

Versum

by io.suverse.versum
OverviewDiscussionsAdmin

Every business of one trade near a place, in one fixed order — the shelf

list_cards
Read-only

Every business of ONE trade (niche: a key from list_niches, exactly) near location, default radius 15 miles, 20 a page. The order is fixed and is not a ranking: independent businesses, then chains, then marketplaces; inside each, by distance (a trade that comes to the customer: published service area first). query does NOT filter or reorder businesses: it chooses which ITEM each card shows. To find businesses that have an item, use search_catalog. Each card: id, name, distance, phone, a few items, next (one action), and for what you pass — needed_by, max_price, deliver_to — a state: hours give open_then / closed_then / unknown (never a free slot); an item price within the budget is item_price_within_budget (the total is not known until priced). needed_by: «today», «tomorrow 19:00», «after 15:00», an interval «tomorrow 08:00 to 17:00», a deadline «by 2026-11-20», a range «this week» — read the same way in every tool. A niche that is not a key returns no cards and the variants to choose from. Trades on the shelf: restaurant (2473) · medical clinic (1222) · auto repair (1101) · insurance agent (1094) · hair salon (1080) · dentist (1043) · lawyer (1036) · oil change (969) · clothing store (895) · massage (881) · accountant (877) · nail salon (777) · hvac (774) · print shop (765) · real estate agent (757) · beauty salon (753) · barber (730) · chiropractor (709) · notary (670) · gas station (658) · appliance repair (586) · grocery (557) · car dealer (556) · storage (544) · optometrist (540) · bakery (534) · bar (526) · landscaping (514) · pharmacy (505) · elder care and home care (459) · daycare (446) · body shop (445) · photographer (438) · pet grooming (430) · pizza (423) · cleaning (409) · catering (407) · florist (400) · event venue (399) · tire shop (386) · auto parts store (383) · hotel (377) · pressure washing (377) · plumber (372) · jewelry (362) · furniture (360) · electrician (354) · pool service (354) · windows and doors (330) · tree service (327) · coffee shop (322) · party rental (319) · towing (314) · roofer (313) · veterinarian (305) · tattoo studio (295) · pest control (292) · truck tire service (287) · car wash (273) · junk removal (272) · movers (270) · liquor store (264) · tutoring (261) · ev charging station (259) · urgent care (255) · window cleaning (248) · truck repair (236) · carpet cleaning (224) · travel agency (214) · painter (191) · physical therapy (189) · car rental (188) · ice cream shop (187) · bike repair (175) · parking (175) · dance studio (169) · fishing charter and boat tours (168) · fuel delivery (167) · jewelry and watch repair (164) · music lessons (160) · dry cleaner (159) · locksmith (153) · handyman (152) · med spa (152) · auto glass (151) · gym (147) · general contractor (146) · shipping and packing store (146) · wedding planner (139) · septic and well service (130) · garage door (124) · dog walking and pet sitting (108) · garden center and nursery (103) · pet boarding (103) · phone repair (101) · mattress (88) · thrift store (87) · yoga (83) · hardware store (75) · boat rental (73) · tailor (68) · bike and jet ski rental (65) · funeral home (60) · medical equipment rental (54) · golf course (53) · driving school (52) · pet store (47) · butcher and seafood market (43) · swim school (30) · meal prep (21) · cinema (20) · shooting range (20) · juice bar (19) · computer repair (18) · kids play center (18) · escape room (17) · tennis and sports courts (17) · bowling and billiards (12) · brewery (9) · kids sports and activities (9) · specialty grocery and farmers market (9) · babysitting and nanny agency (8) · motorcycle repair (8) · taxi and transfer service (8) · local business (6) · other online service (6) · martial arts (5) · shoe repair (4) · online store (3) · food truck (2) · lash and brow studio (2) · museum (2) · services (2) · aquarium (1) · butcher (1) · logistics software (1) · motel (1) · store (1) · transportation service (1) · travel booking site (1); known but not scanned anywhere: candle shop, confectionery, garden center, gift shop, medical apparel, party shop, toy store. Follow the server instructions «HOW TO USE THE VERSUM CATALOG»: results are candidates, not proof; keep reading, quoting, requesting and ordering separate; nothing is sent to an owner, booked, ordered or paid without the user’s permission.

Input Schema

NameRequiredDescriptionDefault
pageNothe `next_page` token of the previous answer
tagsNoFILTER by the niche’s own tags, as list_niches gives them («steak house», «italian», «dish»): a card without one of them is left out; the order does not change. Spelling is folded («steakhouse» = «steak house»).
limitNocards per page. Default 10.
nicheYesa niche key from list_niches, exactly (another word returns the variants to choose from, never a substitute)
queryNochooses which ITEM each card shows («red roses», «balayage»); it does not filter or reorder businesses — for that, search_catalog
detailNotask (default): the short card under the task; shelf: the older ≤ 1 KB shelf card
intentNowhat the user means to do: shapes the items shown and the ONE action in `next` (book → book / check_slot / call; order → order / quote_order / call; quote → quote_order / call; info → call)
locationNoa 5-digit US postcode (best), a city ("Tampa, FL") or "lat,lng". Required for local trades; ignored for online niches (software, apps, online shops — see list_niches → online_niches).
max_priceNothe most for ONE offering, in USD: groups the cards in_budget · budget_unknown · over_budget (nobody is left out) and picks the shown offering inside it (exact, then kind, then partial matches); fixed prices compare; a «from» price above the budget is over, under it budget_unknown
needed_byNowhen: «sunday» / «today» / «2026-11-08» (open that day), «tomorrow 19:00» / «now» (open at that minute), «after 15:00» / «tomorrow after 3pm» (open after then; a free slot only where the source knows slots) — on each business’s own clock; adds `time` {asked_as, day, hours, state, why} and LEAVES OUT only the cards refuted for the way the trade is done (see excluded)
deliver_toNowhere it must be brought (a postcode is best): adds can_deliver_to per card — confirmed when the published area names the place, refuted when the business says no, unknown otherwise
propertiesNofacts to read off each card without filtering: property_states {key: "confirmed <value>" | "refuted" | "unknown"}
radius_milesNoDefault 15 (the same in every tool).

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / location / description
      Previous value: -"a 5-digit US postcode (best), a city (\"Tampa, FL\") or \"lat,lng\". Required: the shelf is a place."New value: +"a 5-digit US postcode (best), a city (\"Tampa, FL\") or \"lat,lng\". Required for local trades; ignored for online niches (software, apps, online shops — see list_niches → online_niches)."
    • changedInput schema / required
      Previous value: -[
-  "niche",
-  "location"
-]New value: +[
+  "niche"
+]
  2. First observed

TDQS

A4.1/5.0
Behavior4/5

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

With readOnlyHint/destructiveHint already covering the safety profile, the description still adds real behavior: the order is fixed and not a ranking, an invalid niche returns variants instead of results, per-card states (open_then/closed_then/unknown, item_price_within_budget) are enumerated, and it warns that results are candidates and nothing is booked without permission. The one flaw is '20 a page' contradicting the schema's 'Default 10' for limit.

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

Conciseness2/5

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

The opening sentences are well front-loaded, but the bulk of the description is a ~140-entry enumeration of trades with counts, which duplicates list_niches — an existing sibling tool — and crowds out the genuinely useful behavioral notes. That list should be a pointer, not inline data.

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?

For a 13-parameter, no-output-schema tool, the description covers the card contents (id, name, distance, phone, items, `next`) and the added state fields, effectively substituting for a return schema, and it documents error behavior for bad niches. Gaps are minor: pagination via `page`/`limit` and the `detail` shelf mode are only lightly touched.

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 coverage is 100%, so the baseline is 3, but the description adds meaning beyond the schema: `query` selects which item a card shows rather than filtering, `niche` must be an exact key, and `needed_by` accepts free-text forms like «tomorrow 19:00» or «this week» interpreted identically everywhere. It explains the state vocabulary produced by max_price and deliver_to, though it leaves page, limit, detail, tags and properties to the schema.

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?

It states a specific verb and resource — every business of ONE trade near a location, in a fixed shelf order — and immediately distinguishes the `query` parameter from filtering, pointing to search_catalog for the latter. An agent can tell it apart from find_business, search_catalog and get_business without opening a schema.

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

Usage Guidelines4/5

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

It gives explicit routing: `niche` must come from list_niches, and finding businesses that carry an item belongs to search_catalog. It also explains the needed_by vocabulary shared across tools. It stops short of stating when to prefer find_business/get_business for a single known business, so it is clear but not exhaustive.

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

All Versum toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources