Versum MCP server — documentation
For AI assistants and the people who connect them · server https://versum.suverse.io/mcp
1. What Versum is
Versum is a free catalogue of real local businesses in the United States, made for AI assistants. One card per business: what it sells and at what price, opening hours, where it delivers, and the ways to order, book or contact it — each value with the page it was read from and when. The assistant searches the catalogue, reads the cards, and with the user's permission can ask a shop's own cart for a delivery quote, send a request to a business's verified owner, or place an order or book a slot where the business connected Shopify or Square.
Versum does not choose for the user and does not sell anything. A card is a dated snapshot: prices and availability are the business's to confirm, unless a tool answer says it checked them live.
2. Connect
| Server URL | https://versum.suverse.io/mcp |
|---|---|
| Transport | Streamable HTTP (stateless, JSON responses) |
| Authentication | none — no account, no key, no payment |
| Price | free |
| Tools | 15 (below); each has a title and read-only / write annotations |
Claude (claude.ai, Claude Desktop): Settings → Connectors → Add custom connector → paste the URL. Claude Code: claude mcp add --transport http versum https://versum.suverse.io/mcp. ChatGPT (developer mode): Settings → Apps → Create, with the URL above and no authentication. Any other MCP client: add a remote server with that URL.
The server sends its usage rules in the MCP instructions at connect time; assistants should follow them.
3. Tools
Find and read (read-only)
| tool | what it does |
|---|---|
list_niches | The trades the catalogue holds near a place, with how many businesses are within the radius. |
list_cards | Every business of one trade near a place, in one fixed order, with the item that best fits the query. |
find_business | A business by its name. |
search_catalog | A search by meaning, for when the trade is not known. |
get_card · get_business | One business in full: offerings, prices, hours, delivery area, actions and contacts. |
get_offering · get_product | One item or service in full, with its price checked again on the business's page. |
check_availability | For a business with a connected Shopify or Square: stock now, or the free booking slots. |
order_status | What became of an order or booking placed through Versum. |
request_status | Delivery and the owner's answer to a request (optionally waits up to 45 s). |
Act for the user (only with the user's explicit permission)
| tool | what it does |
|---|---|
quote_order | Asks the shop's own public cart (Shopify, WooCommerce) what an order would cost delivered to an address. Nothing is ordered; only the delivery address is sent to the shop, and the cart is emptied afterwards. |
request_to_owner | Sends a request (what, when, how many, the person's name and contact, a note) to the business's verified owner by Telegram or e-mail, or returns a WhatsApp link the person sends themselves. It is not a booking until the owner confirms. |
place_order | For a business with a connected Shopify or Square: returns the platform's own checkout link with the items in the cart. The buyer pays on the platform's page; Versum takes no payment. |
book_slot | Books a free slot in the business's own calendar (Square Appointments) for the named customer. |
No tool deletes anything. The write tools take an idempotency_key: a retry with the same key never makes a second request, order or booking.
4. Example requests
- "Find a florist near 33606 that can deliver roses tomorrow, under $80."
- "Which nail salons in Clearwater are open on Sunday? Show prices for a gel manicure."
- "Is there a bike repair shop near St. Petersburg that fixes e-bikes?"
- "What does Bern's Steak House in Tampa have on its menu, and how do I reserve a table?"
- "How much would this arrangement cost delivered to 4202 W Kennedy Blvd, Tampa, FL 33609?" (quote_order)
- "Ask the bakery whether they can make a 3-tier cake for Saturday 2 pm — my name is Ana, reply to ana@example.com." (request_to_owner, after the user agrees)
5. Coverage
Local businesses in the United States, collected city by city; Florida (Tampa Bay, Orlando, Miami) is covered most. Live from the index now: 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); medical equipment rentals in Clearwater, Dunedin, Gibsonton, Largo (+5 more); notarys in Apollo Beach, Clearwater, Dunedin, Gibsonton (+12 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); pool services in Apollo Beach, Clearwater, Largo, Madeira Beach (+10 more); caterings in Clearwater, Dunedin, Palm Harbor, Pinellas Park (+4 more); plumbers in Apollo Beach, Brandon, Clearwater, Dunedin (+14 more); garden center and nurserys in Dunedin, Largo, Ruskin, St. Petersburg (+1 more); towings in Clearwater, Largo, St. Petersburg, Tampa; 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); dentists in Apollo Beach, Belleair, Clearwater, Dunedin (+13 more); fishing charter and boat tourss in Apollo Beach, Belleair, Belleair Bluffs, Clearwater (+14 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); wedding planners in Clearwater, Clearwater Beach, Gibsonton, Largo (+3 more); cleanings in Clearwater, Dunedin, Largo, Lutz (+8 more); car washs in Apollo Beach, Clearwater, Dunedin, East Lake-Orient Park (+9 more); elder care and home cares in Apollo Beach, Clearwater, Dunedin, Largo (+8 more); car rentals in Clearwater, Indian Rocks Beach, St. Petersburg, Tampa (+1 more); ice cream shops in Clearwater Beach, Dunedin, Holiday, Largo (+5 more); insurance agents in Clearwater, Dunedin, Greater Northdale, Indian Shores (+7 more); roofers in Brandon, Clearwater, Dunedin, Odessa (+5 more); meal preps in Clearwater, St. Petersburg, Tampa; daycares in Apollo Beach, Belleair, Brandon, Clearwater (+10 more); pest controls in Clearwater, Largo, Pinellas Park, Riverview (+4 more); tire shops in Clearwater, Lutz, Palm Harbor, Pinellas Park (+2 more); cleaning services in Apollo Beach, Clearwater, Dunedin, Gibsonton (+12 more); real estate agents in Apollo Beach, Belleair Bluffs, Clearwater, Clearwater Beach (+11 more); tutorings in Clearwater, Gibsonton, Largo, Oldsmar (+9 more); lawyers in Clearwater, Largo, Lutz, New Port Richey (+6 more); window cleanings in Apollo Beach, Clearwater, Crystal Beach, Gibsonton (+10 more); gyms in Clearwater, Dunedin, Largo, Oldsmar (+5 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; painters in Clearwater, Kissimmee, Largo, St. Petersburg (+2 more); 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); physical therapys in Clearwater, Dunedin, Largo, Pinellas Park (+4 more); pet boardings in Apollo Beach, Clearwater, St. Petersburg, Tampa (+1 more); shipping and packing stores in Tampa; 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; specialty grocery and farmers markets in St. Petersburg, 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; aquariums in Tampa; truck tire services in Dunedin, 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.
Call list_niches with a place to see exactly what is held there. A place outside coverage answers with an empty list, never with businesses from elsewhere.
6. Limits
- United States only; English only.
- Cards are snapshots read from public pages and may be out of date. Every value carries its source and the date it was checked; unknown values are left out, never guessed.
- A business in the results is a candidate: a listed service is not confirmed availability, an item price is not a final total, and being nearby is not serving the user's area.
- Orders and bookings work only where the business connected its own Shopify or Square; requests only where a verified owner connected Telegram, e-mail or WhatsApp. Elsewhere the card gives the business's own links, telephone and forms.
request_to_owner: at most 6 requests an hour per business.request_statuswaits at most 45 seconds.get_cardreturns 60 offerings a page (up to 200).place_ordertakes up to 20 lines.- Versum is not a party to any purchase: payment, delivery and refunds are between the buyer and the business.
7. Data and privacy
No account is needed and no cookies are set for assistants. What a request carries and where it goes is in the Privacy Policy; the rules of use are in the Terms of Service. Business owners can claim, correct or hide their card at versum.suverse.io.
8. Support
E-mail info@suverse.io — questions, wrong data on a card, removal requests, or a problem with the server. We answer within two business days.