Server definition
- Hash
- sha256:43711d8c2f8057b4361eaa3bc55143b467a09d92eda55267cb6307380b32a021
- What it is
- What a remote MCP server returned when asked what it offers: 15 tools
The blob, as servednamed by its sha256
{
"instructions": "HOW TO USE THE SUVERSE CATALOG\n\nPURPOSE\nSuVerse helps you find local businesses, read what they offer, and see the ways to contact or use them. SuVerse does not choose for the user. It does not guarantee availability, price, open slots or delivery unless a tool result says so explicitly.\n\n1. PREPARE THE REQUEST\nFrom the user's task, work out:\n- what is needed: a business, a service or a product;\n- where to look: the place the user gave;\n- which extra conditions need checking (time, price, language, delivery).\nDo not invent missing details. If a local search needs a place and you don't have one, ask the user. Do not turn a rough time into an exact slot without saying so.\n\n2. PICK THE TOOL\n- You know the business name → find_business.\n- You know the type of business → list_cards.\n- You don't know the type, or need to search by what businesses offer → search_catalog.\n- You need to see available categories and their names → list_niches.\nUse parameters exactly as the tool schema says. Do not guess internal category keys. If a tool offers matching options, pick only one that fits the task.\n\n3. SEPARATE THE NEED FROM THE DETAILS\nLook for whoever provides the service when the user needs a service, and for a seller when the user wants to buy something. Model, brand, material and other details narrow the need; they do not replace it. If more than one type of business could fit, use several reasonable types or ask the user.\n\n4. READ RESULTS AS CANDIDATES\nlist_cards returns businesses of the chosen category. Its query selects which item is shown; it does not guarantee that every business matches every word. A business in the results is a candidate. It does not prove that all of the user's conditions are met.\n\n5. CHECK THE CARD\nUse the specialization, service format, service area and available actions. Keep these apart:\n- opening hours vs. free time;\n- item price vs. final total;\n- being nearby vs. serving the user's area;\n- a listed service vs. confirmed availability;\n- no data vs. confirmed absence.\nNote the source and when it was checked. Do not call information owner-confirmed unless it is.\n\n6. CHOOSE THE NEXT STEP\n- To see what's offered: the menu or catalog.\n- To book or reserve: the matching door.\n- To get a total: quote_order, where supported.\n- To ask the business: request_to_owner, only if that channel is connected. After request_to_owner, tell the person it is not a booking and where the answer will come. If you can set reminders, schedule a request_status check and only then say you will check.\n- Otherwise: the published phone, form or other contact.\nA working link does not mean the action is done. Keep reading, quoting, sending a request and placing an order separate.\n\n7. DON'T OVERSTATE\nIf a needed capability is not confirmed: present the business as a candidate, say what is left to check, and use the available way to check it. If nothing fits, do not substitute a business that only shares words with the request. If information is missing, say exactly what.\n\n8. PERMISSIONS\nDo not send requests to owners, make bookings or orders, or pay without the user's permission.\n\n9. ONLINE BUSINESSES\nThe catalog also holds online businesses (software, apps, APIs, online shops) that have no location. list_niches lists their niches under online_niches. For an online niche call list_cards without a location; for an online request (software, an app, an API) call search_catalog without a location — you get online businesses, not location_needed. get_card shows their facts under «online», each with its source page.",
"tools": [
{
"description": "🔴 ACTS FOR THE USER: call it only after the user has explicitly agreed to this exact action (what, where, when, who) — never on your own judgement.\nFor a service whose business’s card shows a `book` action with method `connected` and no `book` in its\n`cannot` (a door the platform refuses for this account is marked there, with the reason, at every sync). Take a `start_at`\nfrom check_availability (slots) and the platform books it for the named customer; the answer is the\nplatform’s own status (created = on the calendar awaiting confirmation · confirmed · declined). A time\nthe platform does not offer is an `unavailable` error and nothing is booked. Idempotent by\n`idempotency_key` like place_order. Get the user’s explicit yes first.\nFollow 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"business_id": {
"format": "uuid",
"type": "string"
},
"customer": {
"additionalProperties": false,
"properties": {
"email": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"description": "the buyer’s e-mail: the platform sends the checkout link and the receipt there (for a booking; NOT asked for an order on Shopify or Square, whose checkout asks the buyer)"
},
"name": {
"anyOf": [
{
"maxLength": 120,
"type": "string"
},
{
"type": "null"
}
],
"description": "the buyer’s name (required for a booking)"
},
"phone": {
"anyOf": [
{
"maxLength": 40,
"type": "string"
},
{
"type": "null"
}
],
"description": "the buyer’s telephone with country code"
}
},
"type": "object"
},
"idempotency_key": {
"anyOf": [
{
"maxLength": 120,
"type": "string"
},
{
"type": "null"
}
]
},
"note": {
"anyOf": [
{
"maxLength": 500,
"type": "string"
},
{
"type": "null"
}
]
},
"offering_id": {
"description": "the service, from the card",
"format": "uuid",
"type": "string"
},
"start_at": {
"description": "ISO date-time with an offset, as check_availability gave it",
"maxLength": 60,
"type": "string"
},
"variant_id": {
"anyOf": [
{
"maxLength": 120,
"type": "string"
},
{
"type": "null"
}
],
"description": "the service variation when the card lists several"
}
},
"required": [
"business_id",
"offering_id",
"start_at",
"customer"
],
"type": "object"
},
"name": "book_slot",
"outputSchema": null
},
{
"description": "Only for a business whose card shows `live_data` (its items come from its connected Shopify or Square,\nnot from a page read). For a product: the platform’s stock right now — `state: confirmed | refuted |\nunknown` (unknown = the platform does not track stock, which is not «no»). For a service on a platform\nwith bookings: the free `slots` between `from` and `to` (default: the next 7 days), each with a\n`start_at` that book_slot takes as it is — on the business’s own clock with its offset\n(`timezone` names the zone; `start_at_utc` is the same instant). If the card’s `cannot` lists `book`,\nthe slots are information only and the answer says so. A business without a connection answers `not_connected`.\nFollow 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"business_id": {
"description": "the business id from the card",
"format": "uuid",
"type": "string"
},
"from": {
"anyOf": [
{
"maxLength": 60,
"type": "string"
},
{
"type": "null"
}
],
"description": "slots: the window’s start, ISO with an offset"
},
"offering_id": {
"description": "the offering id from the card",
"format": "uuid",
"type": "string"
},
"quantity": {
"anyOf": [
{
"maximum": 999,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"description": "how many — stock is judged against it"
},
"to": {
"anyOf": [
{
"maxLength": 60,
"type": "string"
},
{
"type": "null"
}
],
"description": "slots: the window’s end, ISO with an offset"
},
"variant_id": {
"anyOf": [
{
"maxLength": 120,
"type": "string"
},
{
"type": "null"
}
],
"description": "the variant (the card lists them when there are several)"
}
},
"required": [
"business_id",
"offering_id"
],
"type": "object"
},
"name": "check_availability",
"outputSchema": null
},
{
"description": "One business the user NAMED, matched by its name near `location` (default radius 15 miles); typos, word order and punctuation are tolerated.\nNot in the catalogue → `name_not_found`, and up to 5 nearby businesses that carry the name's distinctive word (never presented as the business asked for).\n`intent`, `query`, `needed_by`, `deliver_to` shape the short card the same way as list_cards.\nFollow 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"deliver_to": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"description": "where it must be brought (a postcode is best): the card says confirmed / refuted / unknown"
},
"intent": {
"anyOf": [
{
"enum": [
"book",
"order",
"quote",
"info",
"reserve",
"request_quote",
"contact",
"call"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "what the user means to do with this business"
},
"location": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"description": "a postcode, a city or \"lat,lng\" — orders the matches by nearness and bounds the nearby list"
},
"name": {
"description": "the business name as the user said it",
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"needed_by": {
"anyOf": [
{
"maxLength": 60,
"type": "string"
},
{
"type": "null"
}
],
"description": "when: «sunday», «tomorrow 19:00», «now», «tomorrow after 15:00» — read on the business’s own clock, three ways (on_day / open_at / slot_after)"
},
"query": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"description": "the thing under the task («red roses», «ribeye»): picks the ≤ 5 items on the card"
},
"radius_miles": {
"description": "Default 15 (the same in every tool).",
"maximum": 250,
"minimum": 1,
"type": "number"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "find_business",
"outputSchema": null
},
{
"description": "SYNONYM of get_card, kept for agents that already know this name.\n\n`transparency`: the SuVerse Transparency rating — how much the business publishes about itself (not the quality of its work), A–D, each item with its source page and read date.\nFree. One business in full, in the same shape for every trade: who it is (name, trade, address,\ntelephone, e-mail, opening hours, time zone), everything it sells (60 offerings a page, cheapest first; `offerings_page` says how many there are and the next offset),\nthe six actions with their links and `required_fields`, how the thing reaches the buyer (delivery,\npickup, on_site, at_customer — with the published area, the fee and the order deadline), and how fresh\neach part of that is. `live_data` (platform, synced_at) when the shelf is the business’s own connected\nsystem: then every offering carries `source: connector` with its variants (each with `inventory`: units in\nstock as the platform counts them, null = unknown), and an action with method\n`connected` is taken through place_order / book_slot on this door.\n\nUse it when the user asks «can they deliver to me», «are they open now», «what else do they do», or\nwhen search_catalog offered a business with nothing listed and the next step is a telephone call.\nFollow 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"id": {
"description": "the business id from search_catalog",
"format": "uuid",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_business",
"outputSchema": null
},
{
"description": "`transparency`: the SuVerse Transparency rating — how much the business publishes about itself (not the quality of its work), A–D, each item with its source page and read date.\nFree. One business in full, in the same shape for every trade: who it is (name, trade, address,\ntelephone, e-mail, opening hours, time zone), everything it sells (60 offerings a page, cheapest first; `offerings_page` says how many there are and the next offset),\nthe six actions with their links and `required_fields`, how the thing reaches the buyer (delivery,\npickup, on_site, at_customer — with the published area, the fee and the order deadline), and how fresh\neach part of that is. `live_data` (platform, synced_at) when the shelf is the business’s own connected\nsystem: then every offering carries `source: connector` with its variants (each with `inventory`: units in\nstock as the platform counts them, null = unknown), and an action with method\n`connected` is taken through place_order / book_slot on this door.\n\nUse it when the user asks «can they deliver to me», «are they open now», «what else do they do», or\nwhen search_catalog offered a business with nothing listed and the next step is a telephone call.\nFollow 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"id": {
"description": "the business id from search_catalog",
"format": "uuid",
"type": "string"
},
"offerings_limit": {
"description": "offerings on this page (default 60, at most 200)",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"offerings_offset": {
"description": "11-05: where this page of offerings starts (default 0); offerings_page.next_offset gives the next one",
"minimum": 0,
"type": "integer"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_card",
"outputSchema": null
},
{
"description": "Free. One offering in full, with ONE live request to the shop asking for that item’s price and stock\nright now (`live_check`). Call it before you quote a price to a person: a catalogue read yesterday is\nyesterday’s price. One business is asked at most once every ten minutes however many of its offerings\nyou open, so walking a shop is one request and not twenty; `from_cache` and `checked_at` say which.\nA price list, a menu or a quote form has no single-item door to ask (`ok: false` with the reason) and\nthe stored reading stands with its date.\n\nHand `action_url` to the user as it is, ref=suverse included.\nFollow 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"id": {
"description": "the offering id from search_catalog",
"format": "uuid",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_offering",
"outputSchema": null
},
{
"description": "SYNONYM of get_offering, kept for agents that already know this name. A «product» is just an offering whose kind is `product`; the same id works in both.\n\nFree. One offering in full, with ONE live request to the shop asking for that item’s price and stock\nright now (`live_check`). Call it before you quote a price to a person: a catalogue read yesterday is\nyesterday’s price. One business is asked at most once every ten minutes however many of its offerings\nyou open, so walking a shop is one request and not twenty; `from_cache` and `checked_at` say which.\nA price list, a menu or a quote form has no single-item door to ask (`ok: false` with the reason) and\nthe stored reading stands with its date.\n\nHand `action_url` to the user as it is, ref=suverse included.\nFollow 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"id": {
"description": "the offering id from search_catalog",
"format": "uuid",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_product",
"outputSchema": null
},
{
"description": "Every business of ONE trade (`niche`: a key from list_niches, exactly) near `location`, default radius 15 miles, 20 a page.\nThe 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).\n`query` does NOT filter or reorder businesses: it chooses which ITEM each card shows. To find businesses that have an item, use search_catalog.\nEach 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).\n`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.\nA `niche` that is not a key returns no cards and the variants to choose from.\nEach card carries `transparency` {grade A–D, have, of, items ✓/✗}: how much the business publishes about itself, NOT quality. You may sort or filter by it; this order does not use it.\nTrades on the shelf: restaurant (2527) · medical clinic (1229) · insurance agent (1114) · auto repair (1113) · hair salon (1096) · dentist (1083) · lawyer (1038) · oil change (980) · clothing store (905) · massage (894) · accountant (882) · nail salon (785) · hvac (776) · print shop (772) · real estate agent (763) · beauty salon (760) · barber (736) · chiropractor (710) · gas station (664) · notary (651) · appliance repair (589) · grocery (562) · car dealer (560) · storage (549) · optometrist (543) · bakery (539) · bar (531) · landscaping (517) · pharmacy (505) · elder care and home care (462) · daycare (448) · body shop (447) · photographer (440) · pet grooming (433) · pizza (426) · catering (411) · cleaning (411) · florist (404) · event venue (403) · tire shop (395) · auto parts store (389) · hotel (380) · pressure washing (378) · plumber (373) · furniture (362) · jewelry (362) · electrician (355) · pool service (355) · windows and doors (330) · tree service (327) · coffee shop (326) · party rental (319) · towing (316) · roofer (313) · veterinarian (306) · tattoo studio (296) · truck tire service (296) · pest control (293) · car wash (274) · junk removal (274) · movers (273) · liquor store (268) · tutoring (262) · ev charging station (260) · urgent care (256) · window cleaning (249) · truck repair (237) · carpet cleaning (224) · travel agency (214) · painter (191) · car rental (190) · physical therapy (190) · ice cream shop (189) · parking (176) · bike repair (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 (154) · 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 (131) · 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 (55) · golf course (53) · driving school (52) · pet store (49) · butcher and seafood market (43) · local business (32) · 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) · other online service (9) · specialty grocery and farmers market (9) · babysitting and nanny agency (8) · motorcycle repair (8) · taxi and transfer service (8) · martial arts (5) · shoe repair (4) · laundromat (3) · online store (3) · food truck (2) · lash and brow studio (2) · museum (2) · services (2) · sporting goods store (2) · aquarium (1) · butcher (1) · caterer (1) · furniture store (1) · health (1) · logistics software (1) · marketing software (1) · motel (1) · motorcycle rental (1) · nail technician (1) · pet care (1) · santa claus for hire (1) · shoe store (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.\nFollow 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"deliver_to": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"description": "where 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"
},
"detail": {
"anyOf": [
{
"enum": [
"task",
"shelf"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "task (default): the short card under the task; shelf: the older ≤ 1 KB shelf card"
},
"intent": {
"anyOf": [
{
"enum": [
"book",
"order",
"quote",
"info",
"reserve",
"request_quote",
"contact",
"call"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "what 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)"
},
"limit": {
"description": "cards per page. Default 10.",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"location": {
"description": "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).",
"maxLength": 200,
"type": "string"
},
"max_price": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "the 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_by": {
"anyOf": [
{
"maxLength": 60,
"type": "string"
},
{
"type": "null"
}
],
"description": "when: «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)"
},
"niche": {
"description": "a niche key from list_niches, exactly (another word returns the variants to choose from, never a substitute)",
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"page": {
"anyOf": [
{
"maxLength": 300,
"type": "string"
},
{
"type": "null"
}
],
"description": "the `next_page` token of the previous answer"
},
"properties": {
"description": "facts to read off each card without filtering: property_states {key: \"confirmed <value>\" | \"refuted\" | \"unknown\"}",
"items": {
"additionalProperties": false,
"properties": {
"equals": {
"type": [
"string",
"number",
"boolean"
]
},
"key": {
"maxLength": 60,
"minLength": 1,
"type": "string"
},
"max": {
"type": "number"
},
"min": {
"type": "number"
}
},
"required": [
"key"
],
"type": "object"
},
"maxItems": 8,
"type": "array"
},
"query": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"description": "chooses which ITEM each card shows («red roses», «balayage»); it does not filter or reorder businesses — for that, search_catalog"
},
"radius_miles": {
"description": "Default 15 (the same in every tool).",
"maximum": 250,
"minimum": 1,
"type": "number"
},
"tags": {
"anyOf": [
{
"items": {
"maxLength": 60,
"minLength": 1,
"type": "string"
},
"maxItems": 8,
"type": "array"
},
{
"type": "null"
}
],
"description": "FILTER 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»)."
}
},
"required": [
"niche"
],
"type": "object"
},
"name": "list_cards",
"outputSchema": null
},
{
"description": "The trades (niches) this catalogue holds near a place, by key, with how many businesses are inside the radius (default 15 miles).\nWithout `niche`: a compact list of keys. With `niche`: that trade in full — its tags, coverage and the conditions its businesses publish.\nA `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.\n`detail: \"full\"` lists every trade in full.\nCoverage: 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 (+32 more); furnitures in Brandon, Clearwater, Dunedin, Largo (+8 more); nail salons in Apollo Beach, Brandon, Carrollwood, Clearwater (+21 more); auto parts stores in Clearwater, Largo, Lutz, Pinellas Park (+3 more); print shops in Brandon, Clearwater, Holiday, Largo (+10 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 Clearwater, Dunedin, Indian Rocks Beach, Largo (+7 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); auto repairs in Clearwater, Dunedin, Gibsonton, Holiday (+12 more); car dealers in Brandon, Clearwater, Gibsonton, Holiday (+8 more); oil changes in Clearwater, Gibsonton, Largo, New Port Richey (+7 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 (+10 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, Gibsonton, Oldsmar (+9 more); medical equipment rentals in Clearwater, Dunedin, Gibsonton, Largo (+5 more); towings in Clearwater, Largo, St. Petersburg, Tampa; 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); plumbers in Apollo Beach, Brandon, Clearwater, Dunedin (+15 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); chiropractors in Brandon, Clearwater, Dunedin, Largo (+9 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); insurance agents in Clearwater, Dunedin, Greater Northdale, Indian Shores (+7 more); car washs in Apollo Beach, Clearwater, Dunedin, East Lake-Orient Park (+9 more); butcher and seafood markets in Seminole, Tampa; daycares in Apollo Beach, Belleair, Brandon, Clearwater (+10 more); tree services in Clearwater, Largo, Odessa, Pinellas Park (+3 more); dance studios in Clearwater, Gibsonton, Largo, New Port Richey (+7 more); boat rentals in Palm Harbor, St. Petersburg, Tampa; electricians in Apollo Beach, Clearwater, Dunedin, Holiday (+15 more); roofers in Brandon, Clearwater, Dunedin, Odessa (+5 more); tailors in St. Petersburg, Tampa; lawyers in Clearwater, Largo, Lutz, New Port Richey (+6 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); specialty grocery and farmers markets in St. Petersburg, Tampa; funeral homes in Clearwater, Largo, Pinellas Park, St. Petersburg (+1 more); HVACs in Apollo Beach, Belleair, Clearwater, Holiday (+8 more); painters in Clearwater, Kissimmee, Largo, St. Petersburg (+2 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); wedding planners in Clearwater, Clearwater Beach, Gibsonton, Largo (+3 more); appliance repairs in Apollo Beach, Brandon, Clearwater, Gibsonton (+6 more); real estate agents in Apollo Beach, Belleair Bluffs, Clearwater, Clearwater Beach (+12 more); carpet cleanings in Clearwater, Dunedin, Kenneth City, Largo (+8 more); cleanings in Clearwater, Dunedin, Largo, Lutz (+8 more); car rentals in Clearwater, Indian Rocks Beach, Miami, St. Petersburg (+2 more); elder care and home cares in Apollo Beach, Clearwater, Dunedin, Largo (+8 more); tire shops in Butte, Clearwater, Lutz, Palm Harbor (+3 more); meal preps in Clearwater, St. Petersburg, Tampa; ice cream shops in Clearwater Beach, Dunedin, Holiday, Largo (+5 more); gyms in Clearwater, Dunedin, Largo, Oldsmar (+5 more); pest controls in Clearwater, Largo, Pinellas Park, Riverview (+4 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); 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); 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; 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; shoe stores in Bozeman; swim schools in Brandon, Seminole, St. Petersburg, Tampa (+1 more); laundromats in Miami; 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; pet cares in Fort Lauderdale; 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.\nFollow 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"detail": {
"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"
},
"location": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"description": "a 5-digit US postcode, a city (\"Tampa, FL\") or \"lat,lng\". Optional: without it every niche is listed with its totals."
},
"niche": {
"anyOf": [
{
"maxLength": 80,
"type": "string"
},
{
"type": "null"
}
],
"description": "one niche key: that niche in full (tags, coverage, every condition it publishes). Another word returns `variants` with why, never a substitute"
},
"radius_miles": {
"description": "How far from the location counts as «here». Default 15 (the same in every tool).",
"maximum": 250,
"minimum": 1,
"type": "number"
}
},
"type": "object"
},
"name": "list_niches",
"outputSchema": null
},
{
"description": "The status of an `order_id` from place_order or book_slot, asked of the platform again when it is not final (paid? confirmed? declined by the owner?). A Shopify cart link answers `unknown` — payment is on Shopify’s side and the shop does not report it here. Free.\nFollow 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"order_id": {
"format": "uuid",
"type": "string"
}
},
"required": [
"order_id"
],
"type": "object"
},
"name": "order_status",
"outputSchema": null
},
{
"description": "🔴 ACTS FOR THE USER: call it only after the user has explicitly agreed to this exact action (what, where, when, who) — never on your own judgement.\nFor a business whose card shows an `order` action with method `connected`. Shopify: returns the shop’s\nown checkout link with these items and quantities already in the cart (`status: unknown`, `mode: cart`)\n— no customer data is needed or passed, the buyer gives their details and pays on Shopify, and nothing\nexists on the shop until they do. Square: an order with a payment link (no customer data either).\nWhatsApp: a message to the owner (customer phone or email). Returns `order_id`, `status`, `checkout_url`\n— HAND THE CHECKOUT URL TO THE USER AS IT IS: that page takes the money, SuVerse holds no card and charges\nnothing. Stock is checked live first on a platform that tracks it; «not in stock» is an `unavailable`\nerror and no order or link is given. Send an `idempotency_key` of your own and keep it for a retry: the\nsame key returns the same answer and the same link (`repeated: true`), never a second one. Lines name\nofferings by their card id (and `variant_id` when the card lists several). `status`: unknown (a cart\nlink: payment is on the platform’s side) · created (the platform holds it) · pending_owner (WhatsApp) ·\nconfirmed · declined · failed. Get the user’s explicit yes before calling this.\nFollow 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"business_id": {
"format": "uuid",
"type": "string"
},
"customer": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"email": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"description": "the buyer’s e-mail: the platform sends the checkout link and the receipt there (for a booking; NOT asked for an order on Shopify or Square, whose checkout asks the buyer)"
},
"name": {
"anyOf": [
{
"maxLength": 120,
"type": "string"
},
{
"type": "null"
}
],
"description": "the buyer’s name (required for a booking)"
},
"phone": {
"anyOf": [
{
"maxLength": 40,
"type": "string"
},
{
"type": "null"
}
],
"description": "the buyer’s telephone with country code"
}
},
"type": "object"
},
{
"type": "null"
}
],
"description": "only where the platform needs it (WhatsApp); omit for Shopify and Square"
},
"idempotency_key": {
"anyOf": [
{
"maxLength": 120,
"type": "string"
},
{
"type": "null"
}
],
"description": "your own key for this order; reuse it on a retry"
},
"lines": {
"items": {
"additionalProperties": false,
"properties": {
"offering_id": {
"description": "from the card",
"format": "uuid",
"type": "string"
},
"quantity": {
"description": "default 1",
"maximum": 999,
"minimum": 1,
"type": "integer"
},
"variant_id": {
"anyOf": [
{
"maxLength": 120,
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"offering_id"
],
"type": "object"
},
"maxItems": 20,
"minItems": 1,
"type": "array"
},
"note": {
"anyOf": [
{
"maxLength": 1000,
"type": "string"
},
{
"type": "null"
}
],
"description": "a note to the business, in the user’s words (not passed on a Shopify cart link)"
}
},
"required": [
"business_id",
"lines"
],
"type": "object"
},
"name": "place_order",
"outputSchema": null
},
{
"description": "Prices ONE cart in the shop's own public cart (Shopify or WooCommerce) to ONE ZIP, with no personal data, and orders nothing: the cart is emptied afterwards.\nAnswers the items, delivery options with their prices, the subtotal and what stays unknown (tax and fees at checkout; the delivery date unless the cart names it — `delivery_date` asks for a day).\nOther platforms answer «quote not available» with the reason and the order link.\nFollow 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"deliver_to": {
"anyOf": [
{
"maxLength": 200,
"minLength": 5,
"type": "string"
},
{
"additionalProperties": false,
"properties": {
"address_1": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"description": "street line, only for the price: some shops price by it"
},
"city": {
"anyOf": [
{
"maxLength": 80,
"type": "string"
},
{
"type": "null"
}
]
},
"country": {
"anyOf": [
{
"maxLength": 20,
"type": "string"
},
{
"type": "null"
}
],
"description": "US only for now"
},
"postcode": {
"description": "5-digit US postcode",
"maxLength": 10,
"minLength": 5,
"type": "string"
},
"state": {
"anyOf": [
{
"maxLength": 40,
"type": "string"
},
{
"type": "null"
}
],
"description": "two letters; read from the postcode when omitted"
}
},
"required": [
"postcode"
],
"type": "object"
}
],
"description": "where it must be brought: \"33139\", \"Miami Beach, FL 33139\", or {postcode, state, city, address_1}"
},
"delivery_date": {
"anyOf": [
{
"maxLength": 40,
"type": "string"
},
{
"type": "null"
}
],
"description": "the day the person wants it delivered (\"2026-11-20\"): answered as confirmed only when the shop's cart names that day, else «delivery date: unknown»"
},
"items": {
"anyOf": [
{
"items": {
"additionalProperties": false,
"properties": {
"offering_id": {
"format": "uuid",
"type": "string"
},
"options": {
"anyOf": [
{
"items": {
"additionalProperties": false,
"properties": {
"field": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"value": {
"maxLength": 400,
"type": "string"
}
},
"required": [
"field",
"value"
],
"type": "object"
},
"maxItems": 10,
"type": "array"
},
{
"type": "null"
}
]
},
"quantity": {
"maximum": 99,
"minimum": 1,
"type": "integer"
},
"variant_id": {
"anyOf": [
{
"maxLength": 64,
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"offering_id"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
{
"type": "null"
}
],
"description": "several different items of the SAME shop in one cart (delivery and tax on the whole order); offering_id is then the first of them"
},
"offering_id": {
"description": "the offering id from a card",
"format": "uuid",
"type": "string"
},
"options": {
"anyOf": [
{
"items": {
"additionalProperties": false,
"properties": {
"field": {
"description": "words of the page’s own question, e.g. «card»",
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"value": {
"description": "the answer, e.g. «No», or the card message",
"maxLength": 400,
"type": "string"
}
},
"required": [
"field",
"value"
],
"type": "object"
},
"maxItems": 10,
"type": "array"
},
{
"type": "null"
}
],
"description": "answers to the product page’s own add-on questions; the rest are answered «no»"
},
"quantity": {
"description": "default 1",
"maximum": 99,
"minimum": 1,
"type": "integer"
},
"variant_id": {
"anyOf": [
{
"maxLength": 64,
"type": "string"
},
{
"type": "null"
}
],
"description": "a variant id from the card when it lists several"
}
},
"required": [
"offering_id",
"deliver_to"
],
"type": "object"
},
"name": "quote_order",
"outputSchema": null
},
{
"description": "Delivery (`sent` · `link_given` · `expired` · `failed`) and the owner’s outcome (`declined` · `other_time` + proposal · `available` = free but NOT booked · `confirmed` = booked). `confirmed: true` only when the owner booked it.\n`wait_seconds` (optional, default 0 = answer now; at most 45 s are used): waits for the owner and returns as soon as the request is answered or final, otherwise the current status when the wait ends (see `wait.ended`).\nWaiting is not a promise of an answer, and nothing calls you back afterwards: if it is still waiting, call request_status again later (for example when the person asks). Hanging up does not cancel the request.\nFollow 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"request_id": {
"format": "uuid",
"type": "string"
},
"wait_seconds": {
"description": "seconds to wait for the owner's answer (0–60, default 0; at most 45 are used)",
"maximum": 60,
"minimum": 0,
"type": "integer"
}
},
"required": [
"request_id"
],
"type": "object"
},
"name": "request_status",
"outputSchema": null
},
{
"description": "🔴 ACTS FOR THE USER: call it only after the user has explicitly agreed to this exact action (what, where, when, who) — never on your own judgement.\nFor a business that takes requests through SuVerse (a verified owner with Telegram, e-mail or WhatsApp). Sends what,\nwhen, how many, which branch and the person’s name and contact. Requires `idempotency_key`: retrying with the same key\nreturns the same request. Answers: `sent` (delivered to the owner), `link_given` (WhatsApp: give `whatsapp_url` to the\nperson — THEY send it; nothing is sent yet), or `no_channel` with the business’s other doors.\nAfter it, tell the person it is NOT a booking yet and where the answer will come (`next_steps.tell_the_person`, `next_steps.answer_goes_to`).\nIf you can set reminders, schedule a request_status check (`next_steps.check_again_after` is a pause, not a promised reply time) — and only then say you will check; otherwise tell the person how to ask again.\nA PRODUCT on the card (an offering with `order`) is ordered the same way: what = its title, quantity 1–10, way = one of its how_to_get, address only for delivery or shipping; no date or time. No payment goes through SuVerse.\nFollow 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"anyOf": [
{
"maxLength": 300,
"type": "string"
},
{
"type": "null"
}
],
"description": "for a product order with delivery or shipping only: the address (it goes only to this business)"
},
"branch": {
"anyOf": [
{
"maxLength": 120,
"type": "string"
},
{
"type": "null"
}
],
"description": "which location, when the business has several"
},
"business_id": {
"description": "the business id from the card",
"format": "uuid",
"type": "string"
},
"customer": {
"additionalProperties": false,
"properties": {
"contact": {
"description": "e-mail or phone where the owner can answer",
"maxLength": 150,
"minLength": 5,
"type": "string"
},
"name": {
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"required": [
"name",
"contact"
],
"type": "object"
},
"date": {
"anyOf": [
{
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
{
"type": "null"
}
],
"description": "YYYY-MM-DD, the business’s local date"
},
"idempotency_key": {
"description": "your own key for this request; the same key never makes a second one",
"maxLength": 80,
"minLength": 8,
"type": "string"
},
"note": {
"anyOf": [
{
"maxLength": 800,
"type": "string"
},
{
"type": "null"
}
]
},
"quantity": {
"anyOf": [
{
"maximum": 999,
"minimum": 1,
"type": "integer"
},
{
"type": "null"
}
],
"description": "how many; for a product order 1 to 10"
},
"time": {
"anyOf": [
{
"pattern": "^\\d{2}:\\d{2}$",
"type": "string"
},
{
"type": "null"
}
],
"description": "HH:MM, the business’s local time"
},
"way": {
"anyOf": [
{
"enum": [
"pickup",
"delivery",
"shipping"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "for a PRODUCT order: how the person gets it — one of the product’s how_to_get on the card"
},
"what": {
"description": "what the person wants (a service, an item, a table for 4 …)",
"maxLength": 200,
"minLength": 2,
"type": "string"
}
},
"required": [
"business_id",
"what",
"customer",
"idempotency_key"
],
"type": "object"
},
"name": "request_to_owner",
"outputSchema": null
},
{
"description": "Search by what is wanted (an item, a dish, a service, in any language) near `location`, default radius 15 miles, when the trade is not known.\nEach business shows its best-fitting items first; `match.fit` says how well: exact (the thing and every asked property), likely (the thing, a property not stated), property (the thing with another quantity or colour), partial (only its main word), none. `nothing_fitting` says so when nothing does.\nConditions you pass come back per business as met / violated / unknown (time: open_then / closed_then / unknown): the item's price is not the total, opening hours are not a delivery time, being near is not being served.\nNo `location` and nothing fitting → an empty list, not unrelated businesses from anywhere.\nCoverage: 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 (+32 more); furnitures in Brandon, Clearwater, Dunedin, Largo (+8 more); nail salons in Apollo Beach, Brandon, Carrollwood, Clearwater (+21 more); auto parts stores in Clearwater, Largo, Lutz, Pinellas Park (+3 more); print shops in Brandon, Clearwater, Holiday, Largo (+10 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 Clearwater, Dunedin, Indian Rocks Beach, Largo (+7 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); auto repairs in Clearwater, Dunedin, Gibsonton, Holiday (+12 more); car dealers in Brandon, Clearwater, Gibsonton, Holiday (+8 more); oil changes in Clearwater, Gibsonton, Largo, New Port Richey (+7 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 (+10 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, Gibsonton, Oldsmar (+9 more); medical equipment rentals in Clearwater, Dunedin, Gibsonton, Largo (+5 more); towings in Clearwater, Largo, St. Petersburg, Tampa; 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); plumbers in Apollo Beach, Brandon, Clearwater, Dunedin (+15 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); chiropractors in Brandon, Clearwater, Dunedin, Largo (+9 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); insurance agents in Clearwater, Dunedin, Greater Northdale, Indian Shores (+7 more); car washs in Apollo Beach, Clearwater, Dunedin, East Lake-Orient Park (+9 more); butcher and seafood markets in Seminole, Tampa; daycares in Apollo Beach, Belleair, Brandon, Clearwater (+10 more); tree services in Clearwater, Largo, Odessa, Pinellas Park (+3 more); dance studios in Clearwater, Gibsonton, Largo, New Port Richey (+7 more); boat rentals in Palm Harbor, St. Petersburg, Tampa; electricians in Apollo Beach, Clearwater, Dunedin, Holiday (+15 more); roofers in Brandon, Clearwater, Dunedin, Odessa (+5 more); tailors in St. Petersburg, Tampa; lawyers in Clearwater, Largo, Lutz, New Port Richey (+6 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); specialty grocery and farmers markets in St. Petersburg, Tampa; funeral homes in Clearwater, Largo, Pinellas Park, St. Petersburg (+1 more); HVACs in Apollo Beach, Belleair, Clearwater, Holiday (+8 more); painters in Clearwater, Kissimmee, Largo, St. Petersburg (+2 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); wedding planners in Clearwater, Clearwater Beach, Gibsonton, Largo (+3 more); appliance repairs in Apollo Beach, Brandon, Clearwater, Gibsonton (+6 more); real estate agents in Apollo Beach, Belleair Bluffs, Clearwater, Clearwater Beach (+12 more); carpet cleanings in Clearwater, Dunedin, Kenneth City, Largo (+8 more); cleanings in Clearwater, Dunedin, Largo, Lutz (+8 more); car rentals in Clearwater, Indian Rocks Beach, Miami, St. Petersburg (+2 more); elder care and home cares in Apollo Beach, Clearwater, Dunedin, Largo (+8 more); tire shops in Butte, Clearwater, Lutz, Palm Harbor (+3 more); meal preps in Clearwater, St. Petersburg, Tampa; ice cream shops in Clearwater Beach, Dunedin, Holiday, Largo (+5 more); gyms in Clearwater, Dunedin, Largo, Oldsmar (+5 more); pest controls in Clearwater, Largo, Pinellas Park, Riverview (+4 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); 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); 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; 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; shoe stores in Bozeman; swim schools in Brandon, Seminole, St. Petersburg, Tampa (+1 more); laundromats in Miami; 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; pet cares in Fort Lauderdale; 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.\nFollow 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"detail": {
"description": "compact (default): the business, its 1–2 best offerings with prices and links, what can be done, and the date it was read — a few hundred bytes a card. full: everything, including images, the sentence each price was read from, variants, all four fulfilment modes with published areas, opening hours and per-field evidence. Ask for full only when the user has chosen a business and you need its delivery area or its hours.",
"enum": [
"compact",
"full"
],
"type": "string"
},
"fulfillment": {
"description": "HOW it must reach the user, and the four are different questions: delivery = brought to the address; pickup = the user collects; on_site = the user goes there (a salon chair, a dining room); at_customer = the business travels (a mover, a plumber). Default any. A business that has not published an answer is KEPT; one that ruled it out is dropped.",
"enum": [
"delivery",
"pickup",
"on_site",
"at_customer",
"any"
],
"type": "string"
},
"limit": {
"description": "How many BUSINESS CARDS to return. Default 10.",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"location": {
"description": "Where the user is, or where it must happen. A 5-DIGIT US POSTCODE IS BEST (\"33139\"): it is the only form a business’s own published delivery or service area can be matched against exactly, so a postcode gets you `how: \"zips\"` and a city name gets you a distance. A city (\"Orlando, FL\") or \"lat,lng\" also work. OPTIONAL IN NAME ONLY — without it nothing is measured and nothing is narrowed, and the answer comes back with `needs` carrying the question to put to your user. \"near me\" is not a location: ask which town.",
"maxLength": 200,
"type": "string"
},
"max_price": {
"description": "The most the user will pay for ONE offering, in USD, compared against the lowest number the business published — so \"from $45\" passes \"under $50\". An offering priced on request is NOT filtered out: it comes back `price_type: \"quote_only\"`, because \"they quote it\" is an answer.",
"minimum": 0,
"type": "number"
},
"needed_by": {
"description": "When it has to happen: \"today\", \"tomorrow\", \"tomorrow 9am\", or an ISO date-time — WITH an offset (2026-10-31T14:00:00-04:00) if you know the user’s zone, because a business whose cut-off is on the RECIPIENT’s clock can only be judged against an offset you give.",
"maxLength": 60,
"type": "string"
},
"only_independent": {
"description": "true = leave out chains (a business whose website serves several of the places found). Default false: a chain is kept as a name, a telephone and a website — it was never read, so it has no offerings — and its card says `chain: true`.",
"type": "boolean"
},
"only_local": {
"description": "true = leave out marketplaces: a business whose shelf names places far from its own address (one local address, hundreds of listings in other cities and countries). Default false: a marketplace is kept, ranked lower, and its card says `marketplace: true` (the full card says why).",
"type": "boolean"
},
"properties": {
"description": "THE OPEN LAYER AS A FILTER: facts a business publishes beyond price and availability — a capacity, a deposit, a duration, whether something is included. Three states per key: a published value that fits = confirmed; a published value that does not = refuted (left out, a fact); nothing published = unknown (KEPT, ranked lower, named in the card’s `unknown`). Ask for the user’s real conditions here instead of putting them in `query`: «for 8 people» is {key:\"capacity\",min:8}, «no deposit» is {key:\"deposit\",max:0}.",
"items": {
"additionalProperties": false,
"properties": {
"equals": {
"description": "the value must be this, as the page wrote it («included», «yes», 8)",
"type": [
"string",
"number",
"boolean"
]
},
"exists": {
"description": "true = the business must publish this property at all",
"type": "boolean"
},
"key": {
"description": "a property key this index has read — get_card lists the ones established for a niche under `established_properties`, and every card shows its own under `properties`",
"maxLength": 60,
"minLength": 1,
"type": "string"
},
"max": {
"description": "the value must be at most this (a number); max 0 = «none»",
"type": "number"
},
"min": {
"description": "the value must be at least this (a number)",
"type": "number"
}
},
"required": [
"key"
],
"type": "object"
},
"maxItems": 8,
"type": "array"
},
"query": {
"description": "What the user wants, IN THEIR OWN WORDS AND THEIR OWN LANGUAGE: \"red roses\", \"steakhouse\", \"funeral flowers\", \"movers 2 bedroom\", \"ramo de rosas\", or the same question in a language not written in the Latin alphabet. Matched by MEANING as well as by words, through one multilingual model — so do NOT translate for us and do NOT list synonyms yourself. A place, a date, a budget and a delivery word may be left in (they are parsed out), but the fewer extra words the better the match.",
"maxLength": 300,
"minLength": 1,
"type": "string"
},
"radius_miles": {
"description": "How far the business may be, in miles. Default 15.",
"maximum": 250,
"minimum": 1,
"type": "number"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_catalog",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:43711d8c2f8057b4361eaa3bc55143b467a09d92eda55267cb6307380b32a021 | sha256sum