Skip to content
MCP server

SuVerse

Search a catalogue of local US businesses with prices, hours and ways to order or book

Install
Pricing
Free
Platforms
API, Web
Runs
Remotely
Version
1.7.0
Listing updated
3 days ago

About SuVerse

SuVerse is a free MCP server for e-commerce. It runs as a hosted remote server, so there is nothing to install locally.

Each business is one card listing what it sells and at what price, opening hours, delivery area and contact routes, every value tied to the page it was read from and a date. The cards are dated snapshots, so prices and availability remain the business's to confirm unless a tool says it checked live.

Fifteen tools split into reading and acting. The acting tools run only with the user's explicit permission: quote_order asks a shop's public cart for a delivered cost without ordering, request_to_owner messages a verified owner by Telegram or email or returns a WhatsApp link, place_order returns the platform's own Shopify or Square checkout link, and book_slot books a Square Appointments slot. SuVerse takes no payment, and write tools take an idempotency key so a retry never repeats.

It needs no account or key. The README also describes an open reader for reading any business website locally.

Install

Run in a terminal

claude mcp add --transport http catalog https://www.suverse.io/mcp/catalog

Add to Settings → Connectors → Add custom connector

https://www.suverse.io/mcp/catalog
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "catalog": {
      "url": "https://www.suverse.io/mcp/catalog"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "catalog": {
      "type": "http",
      "url": "https://www.suverse.io/mcp/catalog"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "catalog": {
      "serverUrl": "https://www.suverse.io/mcp/catalog"
    }
  }
}

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (15)

Read directly from the server.

list_niches
The trades (niches) this catalogue holds near a place, by key, with how many businesses are inside the radius (default 15 miles). Without `niche`: a compact list of keys. With `niche`: that trade in full — its tags, coverage and the conditions its businesses publish. A `niche` that is not a key comes back with `variants` and why (a tag, a similar name, a meaning) — nothing is substituted: pick a k
list_cards
Every business of ONE trade (`niche`: a key from list_niches, exactly) near `location`, default radius 15 miles, 20 a page. The 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). `query` does NOT filter or reorder businesses: it chooses which ITEM each card shows.
find_business
One business the user NAMED, matched by its name near `location` (default radius 15 miles); typos, word order and punctuation are tolerated. Not 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). `intent`, `query`, `needed_by`, `deliver_to` shape the short card the same way as list_cards. Follow the
search_catalog
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. Each 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
get_card
`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. Free. One business in full, in the same shape for every trade: who it is (name, trade, address, telephone, e-mail, opening hours, time zone), everything it sells (60 offerings a page, cheapest first; `offerings_page` says h
get_offering
Free. One offering in full, with ONE live request to the shop asking for that item’s price and stock right now (`live_check`). Call it before you quote a price to a person: a catalogue read yesterday is yesterday’s price. One business is asked at most once every ten minutes however many of its offerings you open, so walking a shop is one request and not twenty; `from_cache` and `checked_at` say wh
get_product
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. Free. One offering in full, with ONE live request to the shop asking for that item’s price and stock right now (`live_check`). Call it before you quote a price to a person: a catalogue read yesterday is yesterday’s price. One business is asked at
get_business
SYNONYM of get_card, kept for agents that already know this name. `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. Free. One business in full, in the same shape for every trade: who it is (name, trade, address, telephone, e-mail, opening hours, time zone), everything it s
quote_order
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. Answers 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). Other platforms answer «quote not available» w
check_availability
Only for a business whose card shows `live_data` (its items come from its connected Shopify or Square, not from a page read). For a product: the platform’s stock right now — `state: confirmed | refuted | unknown` (unknown = the platform does not track stock, which is not «no»). For a service on a platform with bookings: the free `slots` between `from` and `to` (default: the next 7 days), each with
place_order
🔴 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. For a business whose card shows an `order` action with method `connected`. Shopify: returns the shop’s own checkout link with these items and quantities already in the cart (`status: unknown`, `mode: cart`) — no customer data is needed or passed, the
book_slot
🔴 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. For a service whose business’s card shows a `book` action with method `connected` and no `book` in its `cannot` (a door the platform refuses for this account is marked there, with the reason, at every sync). Take a `start_at` from check_availability (
order_status
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. Follow the server instructions «HOW TO USE THE SUVERSE CATALOG»: results are candidates, not proof; keep reading, quoting, requesting an
request_to_owner
🔴 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. For a business that takes requests through SuVerse (a verified owner with Telegram, e-mail or WhatsApp). Sends what, when, how many, which branch and the person’s name and contact. Requires `idempotency_key`: retrying with the same key returns the sam
request_status
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. `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

What it does

Local search
Finds businesses by trade and place or by meaning.
Sourced cards
Each value cites its page and date.
Delivery quotes
Asks a shop's own cart what delivery would cost.
Owner requests
Sends a request to a verified owner or returns a WhatsApp link.
Orders and bookings
Hands off to Shopify or Square checkout, or books a Square slot.
Retry safety
Write tools use an idempotency key.

Good for

  • Find a florist near a ZIP code that delivers tomorrow
  • Compare prices for a service at nearby salons
  • Get a delivered cost before ordering
  • Ask a bakery whether it can make a custom cake

Pricing

Free

Free; no account, key or payment

Prices change. Check suverse.io before you buy.

SuVerse FAQ

Does it cost anything?

No. Docs say free, with no account, key or payment.

Does SuVerse take payment?

No. Buyers pay on the platform's checkout page.

Are prices live?

Cards are dated snapshots; item tools recheck the price on the business's page.

What is covered?

Local businesses in the United States.

Is SuVerse free?

Yes. SuVerse is free to use.

How do I add SuVerse to Claude Code?

Run this command in your terminal: claude mcp add --transport http catalog https://www.suverse.io/mcp/catalog

What are the best alternatives to SuVerse?

The closest alternatives to SuVerse are O'So MCP Server for PrestaShop, Tutu eSIM, SecureCloud, MadMax Trade Supply parts and Shanghai Streets Travel Guide.

Alternatives to SuVerse

  1. Let Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions

    Not checked yet
    • Remote
    • Open source
    • 2 GitHub stars
    • E-commerce
  2. Tutu eSIM

    MCP server

    Live travel eSIM plans, prices and roaming costs for 190+ countries

    • 5 tools
    • Remote
    • Paid
    • Maps and travel
  3. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security
  4. Search replacement filters, alarms and batteries, check fit and build a cart link

    • 7 tools
    • Remote
    • Free
    • E-commerce
  5. Curated places, walking routes and areas in Shanghai, Jiangsu and Zhejiang

    • 9 tools
    • Remote
    • Free
    • Maps and travel
  6. Renta

    MCP server

    Remote MCP server for running an outdoor rental shop on Renta from an AI client

    • Remote
    • Paid
    • E-commerce