{"id":"io.suverse.www/catalog","slug":"io-suverse-www-catalog","title":"SuVerse","description":"Find local US businesses: what they offer, prices from their own sites, and how to order or book.","version":"1.7.0","publisher":{"kind":"domain","id":"www.suverse.io","label":"www.suverse.io","url":"https://www.suverse.io"},"website":"https://www.suverse.io/docs","repository":"https://github.com/sudzikcoin/suverse-agent-assistant","remotes":[{"type":"streamable-http","url":"https://www.suverse.io/mcp/catalog"}],"packages":[],"published":"2026-11-11","updated":"2026-11-11","status":"online","auth":"","latency_ms":1183,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"list_niches","title":"What the catalogue knows, and where","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 k","read_only":true},{"name":"list_cards","title":"Every business of one trade near a place, in one fixed order — the shelf","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. ","read_only":true},{"name":"find_business","title":"A business by its name","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","read_only":true},{"name":"search_catalog","title":"A match by meaning, for when the trade is not known — check its results on the cards","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. `not","read_only":true},{"name":"get_card","title":"One business in full: what it sells, what can be done, how it reaches you","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 h","read_only":true},{"name":"get_offering","title":"One thing in full, with its price checked again right now","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 wh","read_only":true},{"name":"get_product","title":"One thing in full (synonym of get_offering)","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 a","read_only":true},{"name":"get_business","title":"One business in full (synonym of get_card)","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 ","read_only":true},{"name":"quote_order","title":"What an order would cost delivered to an address — asked of the shop’s own cart, nothing ordered","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» w","read_only":false},{"name":"check_availability","title":"Ask the business’s own system: is it in stock now · which slots are free","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","read_only":true},{"name":"place_order","title":"Place an order in the business’s own system; the buyer pays on the platform’s checkout page","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 b","read_only":false},{"name":"book_slot","title":"Book a slot in the business’s own calendar (Square Appointments)","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 (s","read_only":false},{"name":"order_status","title":"What became of an order or a booking placed through this door","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 an","read_only":true},{"name":"request_to_owner","title":"Send a request to the business’s verified owner (not a booking until the owner confirms)","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","read_only":false},{"name":"request_status","title":"What became of a request to the owner: delivery and the owner’s outcome","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","read_only":true}],"server_info":{"name":"suverse-catalog","version":"1.6.0"},"category":"ecommerce","tags":["web-search"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-11-11","stars":0,"badges":["new"],"sponsor":null,"page":"https://agentsindex.org/agents/io-suverse-www-catalog/"}