Versum Agent Assistant

AI agents can find a local business, see what it sells, check availability and price, and open a real order or booking.

Why

Local businesses are close to invisible to AI agents. Their menus, price lists and booking pages are written for people, an agent cannot phone the shop, and many businesses have no website an agent could use at all. Versum reads what each business publishes, turns it into one card per business with real links to order, book or ask, and serves the cards to any MCP client.

Related MCP server: @qasperai/mcp-server

60-second quickstart

The MCP door (streamable HTTP, no key needed):

https://versum.suverse.io/mcp

Config for an MCP client that takes a JSON server list with streamable-HTTP servers (checked by connecting the official MCP TypeScript SDK client with exactly this entry: 13 tools listed, a live call answered):

{
  "mcpServers": {
    "versum": { "type": "http", "url": "https://versum.suverse.io/mcp" }
  }
}

One request — search_catalog with {"query": "a dozen red roses delivered", "location": "Miami, FL", "limit": 3} — and the live answer (2026-11-02), cut to the first business:

{
  "found": 12,
  "returned": 3,
  "businesses": [
    {
      "id": "f2f197e1-7e39-4794-9e3c-54a77a75ef24",
      "name": "More Than Flowers",
      "trade": "Florist",
      "miles_away": 2.1,
      "offerings": [
        {
          "id": "e9a2aebb-cd9e-4627-8d8d-84d866a26bee",
          "title": "Three Dozen Roses - Hot Pink",
          "price": 135,
          "availability": "in_stock",
          "link": "https://morethanflowersmiami.com/miami-more-than-flowers/three-dozen-roses-hot-pink.html?ref=versum"
        }
      ],
      "can": ["check_delivery", "contact", "order"],
      "links": {
        "order": "https://morethanflowersmiami.com/miami-more-than-flowers/mayflower-wrapped-bouquet.html?ref=versum",
        "contact": "tel:+17865876195"
      }
    }
  ]
}

Read any business website yourself

reader/ is Versum's own open reader: the same readers the catalogue runs, on your machine, for any website — items with prices, the doors to order, book or ask, hours and contacts, every value with the words it was read from. No Google, no proxy, no browser; robots.txt obeyed; a model only with your own ANTHROPIC_API_KEY (--no-model turns it off).

cd reader && npm install && npm run build
node dist/cli.cjs read https://example-business.com --pretty

Its shared cache is free and on by default (--no-share or VERSUM_SHARE=0 turns it off): what is sent and kept is in reader/README.md and the privacy policy.

Tools

check_availability, place_order and book_slot work for businesses whose owner connected Shopify or Square (the card shows live_data, and a connected door). Shopify: place_order returns the shop's own checkout link with the items in the cart; the buyer gives their details and pays on Shopify. For every other business the card's doors link to its own order and booking pages.

Example: quote_order — Flowers of Miami, 12 roses

{"offering_id": "a05bbf1c-32c0-4a56-9038-310b0c35b852", "deliver_to": "1000 Brickell Ave, Miami, FL 33131"} — «Tiny Bouquet of 12 Red Roses with Baby Breath», live answer of 2026-11-02, from the shop's own cart:

Item $55.00; the totals include the shop's own tax for this address. placed: false — nothing was ordered; only the delivery address was sent (no name, e-mail or phone), and the cart session was emptied afterwards. delivery_date came back unknown: the shop does not publish one through its cart.

The business card

get_card returns one card per business. The full schema, inferred from live cards of every kind of business, is schema/card.schema.json. The main parts:

• identity — id, name, address, location, phone, email, website, hours / hours_folded, page_url

• offerings — what it sells: each with id, title, price, currency, availability, link

• actions (the doors) — order, book, reserve, request_quote, contact, check_delivery; each with a real url (or tel: / mailto:) and the provider when it is a platform

• fulfillment — delivery, pickup and the rest, with what is known and what is not

• reach — how an agent can deal with the business, in one word:

  reach	meaning
  online_platform	orders or bookings go through a platform (a shop, ordering or booking system)
  own_cart	the business's own website takes the order
  form_only	a request form, no online order
  phone_only	the telephone is the only door
  no_site	the business has no website
  not_read	the site could not be read

• status — unverified: read from the business's own public pages; the owner has not confirmed it. A business whose owner claimed and confirmed its card shows owner_verified. An unclaimed card is one no owner has claimed yet — today, every card.

Taxonomy

Every card belongs to one or more niches (trades): a key, the words people use for it (also_called) and the kinds of things it sells (tags). taxonomy/niches.json lists the 128 niches as of 2026-11-02, read from list_niches.

Coverage

Numbers as of 2026-11-02.

For business owners

• versum.suverse.io — find your business, claim it, edit what the card says and publish it.

• /b/{slug} — every card has a public page, for example versum.suverse.io/b/flowers-of-miami-miami.

• Connect Shopify or Square from the owner page: the card then shows the store's live items, prices and availability, and agents can place orders and (Square) book slots in the owner's own system.

• Coming soon: the Shopify App Store listing.

How it works

1. A scan lists the businesses of a trade in an area.

2. The analyzer reads each business's own website: menus, price lists, shop catalogues, booking and ordering pages.

3. Everything it keeps carries the page and the words it was read from; nothing is invented.

4. One card per business goes on the shelf, with real doors.

5. Agents ask the MCP door; owners can claim, correct and connect their card.

flowchart LR
  A[Scan an area] --> B[Read the business website]
  B --> C[Card: offerings, prices, doors]
  C --> D[MCP door for agents]
  C --> E["/b/ page + owner site"]
  E -->|owner claims, edits, connects Shopify / Square| C

Roadmap

• Listings in more MCP catalogues.

• An npm package @suverselabs/versum-mcp (stdio) with typed functions for the tools.

• An open reader with a shared cache: read any business website yourself.

• WhatsApp click-to-chat doors.

License and contact

MIT for the schemas, the taxonomy, the documentation and the open reader (reader/) in this repository; the hosted catalogue's service code is closed. Privacy Policy · Terms of Service (SuVerse LLC). Contact: info@suverse.io. The compute side of Versum is versum-node.