Skip to main content
Glama
Sign In

Versum Agent Assistant

by io.github.sudzikcoin
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: restaurants in Apollo Beach, Carrollwood, Gibsonton, Lutz (+10 more); florists in Apollo Beach, Austin, Aventura, Brickell (+21 more); clothing stores in Apollo Beach, Brandon, Carrollwood, Gibsonton (+3 more); jewelrys in Brandon, St. Petersburg, Tampa; furnitures in St. Petersburg, Tampa; nail salons in Apollo Beach, Gibsonton, Lutz, Riverview (+3 more); jewelry and watch repairs in Apollo Beach, St. Petersburg, Tampa, Temple Terrace; bike repairs in Apollo Beach, St. Petersburg, Tampa; mattresss in St. Petersburg, Tampa; party rentals in Lutz, Riverview, Ruskin, Tampa; hair salons in Gibsonton, Riverview, Ruskin, St. Petersburg (+3 more); auto parts stores in Tampa; car dealers in Tampa; garden center and nurserys in Ruskin, St. Petersburg, Tampa; pet groomings in Apollo Beach, Riverview, St. Petersburg, Tampa; massages in St. Petersburg, Tampa, Temple Terrace; print shops in Riverview, St. Petersburg, Tampa, Temple Terrace; liquor stores in Lutz, Tampa; pool services in Apollo Beach, St. Petersburg, Tampa, Temple Terrace; boat rentals in St. Petersburg, Tampa; spas in St. Petersburg, Tampa, Temple Terrace; truck repairs in Tampa; tailors in St. Petersburg, Tampa; bakerys in Tampa, Temple Terrace; shooting ranges in St. Petersburg, Tampa; unknown trades in Tampa; barbers in Apollo Beach, New York, Riverview, St. Petersburg (+2 more); butcher and seafood markets in Tampa; landscapings in St. Petersburg, Tampa; medical equipment rentals in Gibsonton, Riverview, Tampa; plumbers in Apollo Beach, Brandon, Gibsonton, Lutz (+3 more); phone repairs in Apollo Beach, Tampa; dance studios in St. Petersburg, Tampa; moverss in St. Petersburg, Tampa, Temple Terrace; coffee shops in Chicago, Tampa; medical clinics in Apollo Beach, Riverview, St. Petersburg, Tampa; windows and doorss in Tampa; carpet cleanings in St. Petersburg, Tampa; event venues in Lutz, Riverview, Tampa; optometrists in Apollo Beach, Riverview, St. Petersburg, Tampa; pizzas in Tampa, Temple Terrace; oil changes in Gibsonton, Riverview, Ruskin, St. Petersburg (+1 more); appliance repairs in Apollo Beach, Brandon, Clearwater, Gibsonton (+3 more); accountants in Greater Northdale, Lutz, St. Petersburg, Tampa (+1 more); electricians in Apollo Beach, Odessa, Riverview, Ruskin (+2 more); HVACs in Apollo Beach, St. Petersburg, Tampa, Temple Terrace; dentists in Apollo Beach, Tampa; chiropractors in Tampa; med spas in Riverview, Tampa; roofers in Tampa, Temple Terrace; meal preps in St. Petersburg, Tampa; car rentals in St. Petersburg, Tampa; elder care and home cares in Tampa; motorcycle repairs in Tampa; cafes in Apollo Beach, Riverview, St. Petersburg, Tampa; photographers in Apollo Beach, St. Petersburg, Tampa; locksmiths in Greater Northdale, Riverview, Tampa; auto repairs in St. Petersburg, Tampa; veterinarians in Lutz, St. Petersburg, Tampa, Thonotosassa; ice cream shops in Riverview, Tampa, Temple Terrace; cleanings in Riverview, St. Petersburg, Tampa; caterings in Riverview, St. Petersburg, Tampa, Temple Terrace; pharmacys in Tampa; parkings in Ruskin, Tampa; hair-salons in St. Petersburg, Tampa, Temple Terrace; yogas in Apollo Beach, Ruskin, St. Petersburg, Tampa; notarys in Gibsonton, Riverview, St. Petersburg, Sun City Center (+1 more); shipping and packing stores in Tampa; barber-shops in Riverview, St. Petersburg, Tampa; kids play centers in Brandon, Tampa; tree services in Odessa, St. Petersburg, Tampa; travel agencys in St. Petersburg, Tampa; tattoo studios in Ruskin, St. Petersburg, Tampa; physical therapys in St. Petersburg, Tampa; body shops in Tampa; daycares in Apollo Beach, Brandon, St. Petersburg, Tampa; wedding planners in Tampa; handymans in Apollo Beach, St. Petersburg, Tampa; pressure washings in Apollo Beach, St. Petersburg, Tampa, Temple Terrace; insurance agents in St. Petersburg, Tampa; music lessonss in St. Petersburg, Tampa; septic and well services in Apollo Beach, Gibsonton, Lutz, Tampa; cleaning services in Apollo Beach, Gibsonton, Riverview, Ruskin (+1 more); driving schools in Tampa, Town 'N' Country; grocerys in Tampa; window cleanings in Apollo Beach, Gibsonton, Riverview, Ruskin (+3 more); specialty grocery and farmers markets in St. Petersburg, Tampa; pet boardings in Apollo Beach, Tampa; dog walking and pet sittings in Gibsonton, Lutz, Riverview, Tampa (+1 more); car washs in Riverview, Tampa, Temple Terrace; auto glasss in Tampa; dry cleaners in St. Petersburg, Tampa; general contractors in Apollo Beach, St. Petersburg, Tampa; real estate agents in Apollo Beach, St. Petersburg, Tampa, Westchase; tutorings in Gibsonton, St. Petersburg, Tampa, Westchase; painters in Kissimmee, St. Petersburg, Tampa; towings in St. Petersburg, Tampa; braids-locss in Tampa; storages in Tampa; fuel deliverys in Gibsonton, Riverview, Ruskin, Tampa; funeral homes in Tampa; junk removals in St. Petersburg, Tampa; juice bars in Riverview, Tampa; bars in Pine Key, Tampa, Temple Terrace; fishing charter and boat tourss in Ruskin, St. Petersburg, Tampa; lawyers in St. Petersburg, Tampa; pest controls in St. Petersburg, Sun City Center, Tampa; golf courses in St. Petersburg, Tampa; beauty salons in St. Petersburg, Tampa; servicess in Sunny Isles Beach; bowling and billiardss in St. Petersburg, Tampa; pet stores in Tampa; tire shops in Tampa; garage doors in Tampa; taxi and transfer services in Tampa; bike and jet ski rentals in Apollo Beach, Tampa; shoe repairs in Tampa; gas stations in Gibsonton, Riverview, Sun City Center, Tampa; truck tire services in Tampa; babysitting and nanny agencys in Tampa; urgent cares in Tampa, Temple Terrace; EV charging stations in Tampa; hotels in Tampa; kids sports and activitiess in St. Petersburg, Tampa; swim schools in Tampa; aquariums in Tampa; cinemas in Riverview, Ruskin, Tampa; moving companys in Tampa; escape rooms in Tampa; thrift stores in Tampa; tennis and sports courtss in St. Petersburg; hardware stores in Tampa. 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. Changed3 schema fields changed
    • addedInput schema / properties / detail
      Added value: +{
+  "anyOf": [
+    {
+      "enum": [
+        "compact",
+        "full"
+      ],
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "compact (default without a matched niche): keys and counts; full: every niche with tags, coverage and conditions"
+}
    • changedInput schema / properties / niche / description
      Previous value: -"one niche (a key or your words): only it, with EVERY key of the deal it publishes (`conditions`: {key: {confirmed, refuted, unknown}} over the cards inside the radius) — the key to pass as list_cards `properties`"New value: +"one niche key: that niche in full (tags, coverage, every condition it publishes). Another word returns `variants` with why, never a substitute"
    • changedInput schema / properties / radius_miles / description
      Previous value: -"How far from the location counts as «here». Default 10."New value: +"How far from the location counts as «here». Default 15 (the same in every tool)."
  2. First observed

TDQS

B3.4/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=true and openWorldHint=false, so safety is covered. The description adds genuine behavior beyond that: default 15-mile radius, the no-substitution variant behavior, and what compact vs full returns. However, the bulk of the text is a coverage inventory rather than behavioral disclosure, and the final 'follow the server instructions' sentence is boilerplate that repeats the annotations' implications.

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 core is front-loaded and efficient: purpose, three mode rules, and the variants rule take only a few sentences. But more than half the description is a raw enumeration of every niche and city ('restaurants in Apollo Beach, Carrollwood, ... (+10 more); florists in ...'), which is output data, not invocation guidance, and does not help an agent choose or call the tool.

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

Completeness3/5

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

With readOnly annotations, no output schema, and 4 optional parameters, the description does explain the return shapes (key list, full trade, variants) and defaults well enough to call it correctly. The coverage dump is superfluous for completeness and arguably misleading to carry as static text, since it will drift from actual data.

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 the schema already documents niche, detail, location and radius_miles thoroughly. The description restates rather than extends those semantics; its only added nuance is the instruction to pick a returned key instead of relying on substitution, which is behavioral rather than parameter meaning. Baseline 3 is appropriate.

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?

Opening sentence gives a specific verb (lists) and resource (trades/niches this catalogue holds) plus scope (near a place, by key, with business counts inside a default 15-mile radius). It does not distinguish itself from siblings like search_catalog or find_business, so an agent must infer that this is the discovery/listing entry point.

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?

Explicit mode guidance: 'Without `niche`: a compact list of keys. With `niche`: that trade in full' and '`detail: "full"` lists every trade in full.' It also handles the failure case clearly ('a `niche` that is not a key comes back with `variants` ... pick a key'). Missing is routing versus search_catalog/find_business, so it's clear context without exclusions.

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

All Versum Agent Assistant 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