# SuVerse

> SuVerse is a free MCP server for e-commerce. Search a catalogue of local US businesses with prices, hours and ways to order or book. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://www.suverse.io/docs
- **Repository:** https://github.com/sudzikcoin/suverse-agent-assistant
- **MCP Registry name:** io.suverse.www/catalog
- **Categories:** e-commerce, maps and travel
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://www.suverse.io/mcp/catalog
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "catalog": {
      "url": "https://www.suverse.io/mcp/catalog"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [Shanghai Streets Travel Guide](https://ai-powered.com/mcp/shanghai-streets-travel-guide): Shanghai Streets Travel Guide is a free MCP server for maps and travel.
- [Renta](https://ai-powered.com/mcp/renta): Renta is a paid MCP server for e-commerce.
- [Shopify MCP Server (any store)](https://ai-powered.com/mcp/shopify-mcp-server-any-store): Shopify MCP Server (any store) is a paid MCP server for e-commerce.
- [repairinfo](https://ai-powered.com/mcp/repairinfo): repairinfo is a freemium MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/suverse-2
