Skip to main content
Glama
Sign In

SuVerse

by io.suverse.www
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, Carrollwood, Clair-Mel City (+22 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); storages in Clearwater, Gibsonton, Largo, Lutz (+11 more); windows and doorss in Apollo Beach, Clearwater, Dunedin, Largo (+1 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); pizzas in Clearwater, Largo, Palm Harbor, Pinellas Park (+4 more); pressure washings in Apollo Beach, Clearwater, Dunedin, Oldsmar (+6 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); moverss in Clearwater, Holiday, Largo, Orlando (+8 more); shooting ranges in Largo, Odessa, Pinellas Park, St. Petersburg (+1 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); dentists in Apollo Beach, Belleair, Clearwater, Dunedin (+13 more); fishing charter and boat tourss in Apollo Beach, Belleair, Belleair Bluffs, Clearwater (+14 more); car washs in Apollo Beach, Clearwater, Dunedin, East Lake-Orient Park (+9 more); pharmacys in Clearwater, Holiday, Palm Harbor, Safety Harbor (+4 more); insurance agents in Clearwater, Dunedin, Greater Northdale, Indian Shores (+7 more); daycares in Apollo Beach, Belleair, Brandon, Clearwater (+10 more); appliance repairs in Apollo Beach, Brandon, Clearwater, Gibsonton (+6 more); carpet cleanings in Clearwater, Dunedin, Kenneth City, Largo (+8 more); wedding planners in Clearwater, Clearwater Beach, Gibsonton, Largo (+3 more); cleanings in Clearwater, Dunedin, Largo, Lutz (+8 more); roofers in Brandon, Clearwater, Dunedin, Odessa (+5 more); lawyers in Clearwater, Largo, Lutz, New Port Richey (+6 more); elder care and home cares in Apollo Beach, Clearwater, Dunedin, Largo (+8 more); tire shops in Butte, Clearwater, Lutz, Palm Harbor (+3 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; painters in Clearwater, Kissimmee, Largo, St. Petersburg (+2 more); real estate agents in Apollo Beach, Belleair Bluffs, Clearwater, Clearwater Beach (+12 more); pest controls in Clearwater, Largo, Pinellas Park, Riverview (+4 more); gyms in Clearwater, Dunedin, Largo, Oldsmar (+5 more); cleaning services in Apollo Beach, Clearwater, Dunedin, Gibsonton (+12 more); tutorings in Clearwater, Gibsonton, Largo, Oldsmar (+9 more); window cleanings in Apollo Beach, Clearwater, Crystal Beach, Gibsonton (+10 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); specialty grocery and farmers markets in St. Petersburg, Tampa; locksmiths in Greater Northdale, Pinellas Park, Riverview, St. Petersburg (+1 more); physical therapys in Clearwater, Dunedin, Largo, Pinellas Park (+4 more); shipping and packing stores in Tampa; 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); 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; sporting goods stores in Bozeman, Missoula; urgent cares in Clearwater, Pinellas Park, Tampa, Temple Terrace; motorcycle repairs in Tampa; septic and well services in Apollo Beach, Gibsonton, Lutz, 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); shoe stores in Bozeman; 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; aquariums in Tampa; truck tire services in Dunedin, Tampa; moving companys in Tampa; babysitting and nanny agencys in Tampa; tennis and sports courtss in Clearwater, Odessa, St. Petersburg; thrift stores in Seminole, Tampa; escape rooms in Largo, Tampa; computer repairs in Clearwater, Seminole. Follow the server instructions «HOW TO USE THE SUVERSE 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.

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": "list_niches"
  }
}

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.9/5.0
Behavior4/5

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

With read-only annotations already supplied, the description adds meaningful behavior: invalid niche keys return variants rather than substitutes, and compact versus full modes return different shapes. It also carries the server reminder that results are candidates, not proof. It does not cover auth or rate limits, but those are not central for this read-only listing tool.

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 paragraphs are well structured and front-load the important modes and fallback behavior. However, the enormous embedded coverage list enumerating scores of niche/city combinations dominates the description and is not concise; most of that data does not need to be in the tool definition for an agent to select or invoke it correctly.

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

Completeness5/5

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

Given the absence of an output schema, the description still explains the return shape for compact and full modes, the invalid-niche fallback, and how location and radius affect results. It is complete enough for an agent to call the tool correctly, even though the coverage listing is overlong.

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 cross-parameter meaning beyond the schema: `niche` changes the return from a compact key list to a full trade record, and `detail: "full"` broadens the listing. It reinforces the default 15-mile radius and optional location behavior.

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 description clearly states the resource: trades/niches held by the catalogue near a place, with business counts inside a radius. It distinguishes compact-key listing from full niche detail, but it does not explicitly differentiate this tool from sibling discovery tools such as search_catalog or find_business.

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 clear mode-based guidance: omit `niche` for a compact key list, supply `niche` for full detail, and use `detail: "full"` to list every trade. It also explains the fallback when a non-key `niche` is supplied. It stops short of naming alternatives or saying when to choose this over sibling tools.

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

All SuVerse 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