Skip to main content
Glama
Sign In

Versum

by io.suverse.versum
OverviewDiscussionsAdmin

What the catalogue knows, and where

list_niches
Read-only

The trades (niches) this catalogue holds near a place, by key, with how many businesses are inside the radius (default 15 miles). Without niche: a compact list of keys. With niche: that trade in full — its tags, coverage and the conditions its businesses publish. A niche that is not a key comes back with variants and why (a tag, a similar name, a meaning) — nothing is substituted: pick a key. detail: "full" lists every trade in full. Coverage: clothing stores in Apollo Beach, Austin, Belleair Bluffs, Brandon (+22 more); restaurants in Apollo Beach, Brandon, Carrollwood, Clearwater (+29 more); jewelrys in Brandon, Clearwater, Indian Rocks Beach, Largo (+6 more); florists in Apollo Beach, Austin, Aventura, Brickell (+31 more); furnitures in Brandon, Clearwater, Dunedin, Largo (+8 more); nail salons in Apollo Beach, Brandon, Carrollwood, Clearwater (+20 more); print shops in Brandon, Clearwater, Holiday, Largo (+10 more); auto parts stores in Clearwater, Largo, Lutz, Pinellas Park (+3 more); hair salons in Apollo Beach, Belleair Bluffs, Clair-Mel City, Clearwater (+21 more); spas in Apollo Beach, Belleair, Clearwater, Dunedin (+15 more); liquor stores in Clearwater, Dunedin, Holiday, Largo (+4 more); jewelry and watch repairs in Apollo Beach, Clearwater, Safety Harbor, St. Petersburg (+2 more); bike repairs in Apollo Beach, Clearwater, Dunedin, Indian Rocks Beach (+8 more); massages in Apollo Beach, Belleair, Brandon, Clearwater (+20 more); party rentals in Clearwater, Clearwater Beach, Dunedin, Indian Rocks Beach (+11 more); event venues in Clearwater, Dunedin, Gibsonton, Indian Rocks Beach (+12 more); pet groomings in Apollo Beach, Belleair Bluffs, Clearwater, Dunedin (+11 more); car dealers in Brandon, Clearwater, Gibsonton, Holiday (+8 more); oil changes in Clearwater, Gibsonton, Largo, New Port Richey (+7 more); auto repairs in Clearwater, Dunedin, Gibsonton, Holiday (+12 more); truck repairs in Clearwater, Largo, Safety Harbor, Tampa; grocerys in Clearwater, Dunedin, Pinellas Park, St. Petersburg (+2 more); landscapings in Apollo Beach, Clearwater, Gibsonton, Largo (+6 more); bakerys in Belleair Bluffs, Clearwater, Clearwater Beach, Indian Rocks Beach (+10 more); mattresss in Clearwater, Largo, Palm Harbor, Pinellas Park (+2 more); bars in Clearwater, Clearwater Beach, Holiday, Indian Rocks Beach (+10 more); barbers in Apollo Beach, Belleair Bluffs, Clearwater, Clearwater Beach (+15 more); cafes in Apollo Beach, Clearwater, Clearwater Beach, Dunedin (+9 more); windows and doorss in Apollo Beach, Clearwater, Dunedin, Largo (+1 more); storages in Clearwater, Gibsonton, Largo, Lutz (+11 more); notarys in Apollo Beach, Clearwater, Dunedin, Gibsonton (+12 more); medical equipment rentals in Clearwater, Dunedin, Gibsonton, Largo (+5 more); music lessonss in Clearwater, Dunedin, Largo, Palm Harbor (+3 more); pressure washings in Apollo Beach, Clearwater, Dunedin, Oldsmar (+6 more); pizzas in Clearwater, Largo, Palm Harbor, Pinellas Park (+4 more); medical clinics in Apollo Beach, Clearwater, Dunedin, Holiday (+12 more); caterings in Clearwater, Dunedin, Palm Harbor, Pinellas Park (+4 more); pool services in Apollo Beach, Clearwater, Largo, Madeira Beach (+10 more); towings in Clearwater, Largo, St. Petersburg, Tampa; plumbers in Apollo Beach, Brandon, Clearwater, Dunedin (+14 more); garden center and nurserys in Dunedin, Largo, Ruskin, St. Petersburg (+1 more); photographers in Apollo Beach, Clearwater, Clearwater Beach, Dunedin (+15 more); phone repairs in Apollo Beach, Largo, Palm Harbor, Pinellas Park (+3 more); tattoo studios in Clearwater, Dunedin, Greater Northdale, Largo (+8 more); travel agencys in Apollo Beach, Clearwater, Dunedin, Largo (+9 more); shooting ranges in Largo, Odessa, Pinellas Park, St. Petersburg (+1 more); moverss in Clearwater, Holiday, Largo, Orlando (+8 more); butcher and seafood markets in Seminole, Tampa; dance studios in Clearwater, Gibsonton, Largo, New Port Richey (+7 more); tree services in Clearwater, Largo, Odessa, Pinellas Park (+3 more); boat rentals in Palm Harbor, St. Petersburg, Tampa; electricians in Apollo Beach, Clearwater, Dunedin, Holiday (+15 more); tailors in St. Petersburg, Tampa; chiropractors in Brandon, Clearwater, Dunedin, Largo (+9 more); med spas in Clearwater, Dunedin, Largo, Palm Harbor (+5 more); optometrists in Apollo Beach, Brandon, Carrollwood, Clearwater (+7 more); hardware stores in Largo, Pinellas Park, Tampa; servicess in North Miami, Sunny Isles Beach; medical apparels in Hollywood; unknown trades in Tampa; stores in Portage; coffee shops in Chicago, Largo, Palm Harbor, Redington Shores (+2 more); funeral homes in Clearwater, Largo, Pinellas Park, St. Petersburg (+1 more); HVACs in Apollo Beach, Belleair, Clearwater, Holiday (+8 more); accountants in Clearwater, Dunedin, Greater Northdale, Holiday (+11 more); yogas in Apollo Beach, Clearwater, Clearwater Beach, Dunedin (+10 more); veterinarians in Largo, Lutz, Palm Harbor, Riverview (+4 more); fishing charter and boat tourss in Apollo Beach, Belleair, Belleair Bluffs, Clearwater (+14 more); dentists in Apollo Beach, Belleair, Clearwater, Dunedin (+13 more); pharmacys in Clearwater, Holiday, Palm Harbor, Safety Harbor (+4 more); appliance repairs in Apollo Beach, Brandon, Clearwater, Gibsonton (+6 more); carpet cleanings in Clearwater, Dunedin, Kenneth City, Largo (+8 more); car washs in Apollo Beach, Clearwater, Dunedin, East Lake-Orient Park (+9 more); wedding planners in Clearwater, Clearwater Beach, Gibsonton, Largo (+3 more); cleanings in Clearwater, Dunedin, Largo, Lutz (+8 more); insurance agents in Clearwater, Dunedin, Greater Northdale, Indian Shores (+7 more); roofers in Brandon, Clearwater, Dunedin, Odessa (+5 more); elder care and home cares in Apollo Beach, Clearwater, Dunedin, Largo (+8 more); tire shops in Butte, Clearwater, Lutz, Palm Harbor (+3 more); daycares in Apollo Beach, Belleair, Brandon, Clearwater (+10 more); car rentals in Clearwater, Indian Rocks Beach, St. Petersburg, Tampa (+1 more); ice cream shops in Clearwater Beach, Dunedin, Holiday, Largo (+5 more); meal preps in Clearwater, St. Petersburg, Tampa; lawyers in Clearwater, Largo, Lutz, New Port Richey (+6 more); pest controls in Clearwater, Largo, Pinellas Park, Riverview (+4 more); cleaning services in Apollo Beach, Clearwater, Dunedin, Gibsonton (+12 more); real estate agents in Apollo Beach, Belleair Bluffs, Clearwater, Clearwater Beach (+12 more); tutorings in Clearwater, Gibsonton, Largo, Oldsmar (+9 more); gyms in Clearwater, Dunedin, Largo, Oldsmar (+5 more); window cleanings in Apollo Beach, Clearwater, Crystal Beach, Gibsonton (+10 more); painters in Clearwater, Kissimmee, Largo, St. Petersburg (+2 more); dog walking and pet sittings in Clearwater, Gibsonton, Largo, Lutz (+9 more); handymans in Apollo Beach, Belleair Beach, Clearwater, Holiday (+7 more); bowling and billiardss in Seminole, St. Petersburg, Tampa; parkings in Clearwater, Ruskin, St. Petersburg, Tampa; dry cleaners in Clearwater, Dunedin, Largo, Seminole (+2 more); driving schools in Clearwater, Holiday, Largo, St. Petersburg (+3 more); barber-shops in Riverview, St. Petersburg, Tampa; junk removals in Clearwater, Indian Rocks Beach, Largo, Lutz (+4 more); kids play centers in Brandon, Clearwater, Palm Harbor, Pinellas Park (+3 more); locksmiths in Greater Northdale, Pinellas Park, Riverview, St. Petersburg (+1 more); shipping and packing stores in Tampa; physical therapys in Clearwater, Dunedin, Largo, Pinellas Park (+4 more); pet boardings in Apollo Beach, Clearwater, St. Petersburg, Tampa (+1 more); gas stations in Clearwater, Gibsonton, Holiday, Largo (+4 more); bike and jet ski rentals in Apollo Beach, Belleair Bluffs, Clearwater, Clearwater Beach (+5 more); specialty grocery and farmers markets in St. Petersburg, Tampa; general contractors in Apollo Beach, Clearwater, Dunedin, Gibsonton (+7 more); body shops in Clearwater, Tampa; garage doors in Clearwater, Largo, Palm Harbor, Tampa; hair-salons in St. Petersburg, Tampa; urgent cares in Clearwater, Pinellas Park, Tampa, Temple Terrace; septic and well services in Apollo Beach, Gibsonton, Lutz, Tampa; motorcycle repairs in Tampa; juice bars in Clearwater, Riverview, Tampa; auto glasss in Clearwater, Seminole, Tampa; beauty salons in Largo, Pinellas Park, St. Petersburg, Tampa; gift shops in Miami; hotels in Clearwater, Clearwater Beach, North Redington Beach, Palm Harbor (+2 more); golf courses in Dunedin, Largo, Palm Harbor, Pinellas Park (+3 more); nail-salons in Tampa; fuel deliverys in Clearwater, Gibsonton, Riverview, Ruskin (+1 more); pet stores in Tampa; swim schools in Brandon, Seminole, St. Petersburg, Tampa (+1 more); kids sports and activitiess in Clearwater, St. Petersburg, Tampa; EV charging stations in Clearwater, Tampa; taxi and transfer services in Tampa; shoe repairs in Tampa; lash and brow studios in Pinellas Park; pizzerias in Brooklyn; cinemas in Clearwater, Riverview, Ruskin, Tampa; truck tire services in Dunedin, Tampa; aquariums in Tampa; moving companys in Tampa; tennis and sports courtss in Clearwater, Odessa, St. Petersburg; babysitting and nanny agencys in Tampa; thrift stores in Seminole, Tampa; escape rooms in Largo, Tampa; computer repairs in Clearwater, Seminole. 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
nicheNoone niche key: that niche in full (tags, coverage, every condition it publishes). Another word returns `variants` with why, never a substitute
detailNocompact (default without a matched niche): keys and counts; full: every niche with tags, coverage and conditions
locationNoa 5-digit US postcode, a city ("Tampa, FL") or "lat,lng". Optional: without it every niche is listed with its totals.
radius_milesNoHow far from the location counts as «here». Default 15 (the same in every tool).

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.5/5.0
Behavior4/5

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

Annotations already declare readOnlyHint=true, openWorldHint=false and destructiveHint=false, so the safety profile is covered. The description adds genuinely non-obvious behavior: an unrecognized `niche` returns `variants` with a reason and nothing is substituted, so the agent knows to pick a key rather than assume a fuzzy match. It also discloses that coverage is partial and location-scoped, which manages expectations about empty results.

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 first four sentences are well front-loaded and carry all the real information. They are then followed by several hundred words enumerating every trade and its cities, a data dump that no agent can usefully parse and that buries the operating rules. It is far larger than the tool's decision content warrants.

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 read-only, no-required-parameter listing tool with full schema coverage and no output schema, the description covers modes, location semantics, radius default and the unmatched-key path. Nothing an agent needs to call it correctly is missing; it is over-complete rather than under-complete.

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

Parameters3/5

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

Schema description coverage is 100%, so all four parameters, the compact/full enum, the location formats and the 15-mile default are already documented structurally. The description largely restates those semantics (variants behavior, detail: full, default radius) rather than adding new meaning. Baseline 3 is the correct ceiling here.

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

Purpose4/5

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

The opening sentence gives a specific verb and resource: it lists the trades/niches a catalogue holds near a place, keyed by niche, with business counts inside a radius. An agent can tell this is a browse/enumerate tool rather than a lookup like find_business or get_business. It never names a sibling explicitly, which keeps it short of a 5.

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

Usage Guidelines3/5

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

It does explain the three modes: no `niche` gives compact keys, a `niche` gives that trade in full, and `detail: "full"` lists everything. That is useful invocation guidance, but it is all intra-tool. Nothing says when to call this instead of search_catalog or find_business, which is the real selection question for an agent facing 14 siblings.

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