# SuVerse

> SuVerse is a free MCP server for maps and travel. Find local US businesses, their prices and ways to order or book, for AI assistants. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Each business has a card with what it sells and at what price, opening hours, delivery area and ways to order, book or get in touch, and every value notes the page it came from and when. The docs call a card a dated snapshot: prices and availability are the business's to confirm unless a tool says it checked live.

The server needs no account, key or payment. Read-only tools find trades near a place, list businesses, search by meaning and check stock or booking slots for shops that connected Shopify or Square. Action tools run only with the user's permission: quote a delivery from a shop's own public cart, send a request to a verified owner by Telegram or email, or return a checkout link where the buyer pays on the platform's page.

SuVerse says it does not choose for the user and does not sell anything.

## Features

- **Sourced business cards:** Each value shows the page and date it was read from.
- **Search by trade or meaning:** Find businesses near a place by trade, name or free text.
- **Live stock and slots:** Check availability where Shopify or Square is connected.
- **Delivery quotes:** Ask a shop's own cart for a delivered price without ordering.
- **Owner requests:** Send a request to the verified owner by Telegram or email.

## Good for

- Find a local bakery that delivers to an address
- Compare prices from nearby shops
- Book a slot at a business that uses Square
- Ask an owner whether a custom order is possible

## Install

### Claude Code (Terminal)

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

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

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

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

```json
{
  "mcpServers": {
    "suverse-agent-assistant": {
      "url": "https://www.suverse.io/mcp"
    }
  }
}
```

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

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

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

```json
{
  "mcpServers": {
    "suverse-agent-assistant": {
      "serverUrl": "https://www.suverse.io/mcp"
    }
  }
}
```

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

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

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

### Is an account needed?

No. The server uses no authentication and is free.

### Does it take payments?

No. place_order returns the platform's own checkout link, and SuVerse takes no payment.

### Are prices current?

Cards are dated snapshots; some tools re-check a price on the business's page.

### How many tools are there?

The docs list 15, each marked read-only or write.

### 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 suverse-agent-assistant https://www.suverse.io/mcp

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