Bangbangmart

Name: Bangbangmart
Author: XhanGlobal

@XhanGlobal

リポジトリ

Bangbangmart について

首个专为 AI Agents 打造的零食电商平台，支持自主采购下单

#e-commerce

基本情報

カテゴリ

その他

トランスポート

stdio

公開者

XhanGlobal

投稿者

X-HAN

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "bangbangmart": {
      "type": "http",
      "url": "https://www.bangbangmart.com/mcp"
    }
  }
}

ツール

Search and filter the snack catalog by keyword, price, sale status. Returns product IDs, prices, and buy links.

Get full details for a single product by `product_id` (e.g. `p_snacks_0001`).

Create an order for one or more products and get a payment URL. Requires a viewer token.

Look up the status of an order by `order_id` (format: `ord_XXXXXXX`).

List all orders for the authenticated viewer. Requires a viewer token.

Confirm mock payment for an order.

概要

What is Bangbangmart?

Bangbangmart is an MCP (Model Context Protocol) server for BangBangMart, an online snack shop designed for AI agent interaction. It exposes catalog, checkout, and order functionality as structured tools, with a live hosted endpoint at https://www.bangbangmart.com/mcp using Streamable HTTP (stateless, no installation required).

How to use Bangbangmart?

No local installation is needed; configure any MCP client (Cursor, Claude Code, VS Code, Kimi Code) to point at the remote endpoint. For example, in Cursor add {"mcpServers":{"bangbangmart":{"type":"http","url":"https://www.bangbangmart.com/mcp"}}}. Use the six provided tools (search_products, get_product, checkout, get_order_status, get_orders, pay_order) to browse, order, and manage snack purchases. Note that checkout and get_orders require a viewer token from the user.

Key features of Bangbangmart

Search snack catalog by keyword, price, or sale status.
Get full product details by product ID.
Create single- or multi-product orders via checkout.
Look up order status and list all orders.
Confirm mock payment for an order.
Fully hosted, stateless server — no local setup required.

Use cases of Bangbangmart

AI assistant helps user find and purchase snacks.
Automated order management and tracking for snack purchases.
Demo or testing of MCP-based e-commerce workflows.
Integration of a real online store into AI agent interactions.

FAQ from Bangbangmart

What tools does the Bangbangmart MCP server offer?

It offers six tools: search_products, get_product, checkout, get_order_status, get_orders, and pay_order.

Do I need to install anything to use Bangbangmart?

No, the server is hosted at https://www.bangbangmart.com/mcp. Just point your MCP client to that endpoint.

What is a viewer token and when do I need one?

A viewer token is a short base64url string issued by the BangBangMart backend. It is required for checkout and get_orders. Ask the user to provide their token — do not generate or guess one.

How does the checkout tool work for multiple products?

Pass an items string of comma-separated product_id:qty pairs, e.g. p_snacks_0001:2,p_snacks_0014:1. For a single product, pass product_id and qty separately.