BangBangMart MCP

MCP (Model Context Protocol) server for 棒棒玛特 (BangBangMart) — an online snack shop designed for AI agent interaction. The MCP server is live at https://www.bangbangmart.com/mcp (Streamable HTTP, stateless, no installation required).

Overview

BangBangMart is an e-commerce site built AI-first: all routes return plain text wrapped in minimal HTML, making them easy for LLMs to consume directly. The MCP server exposes the same catalog, checkout, and order functionality as structured tools. - Live site: https://www.bangbangmart.com - MCP endpoint: https://www.bangbangmart.com/mcp - Protocol: MCP Streamable HTTP (stateless, one transport per request) - Server name: bangbangmart

Tools

| Tool | Description | | ------------------ | --------------------------------------------------------------------------------------------------------------- | | search_products | Search and filter the snack catalog by keyword, price, sale status. Returns product IDs, prices, and buy links. | | get_product | Get full details for a single product by product_id (e.g. p_snacks_0001). | | checkout | Create an order for one or more products and get a payment URL. Requires a viewer token. | | get_order_status | Look up the status of an order by order_id (format: ord_XXXXXXX). | | get_orders | List all orders for the authenticated viewer. Requires a viewer token. | | pay_order | Confirm mock payment for an order. |

Tool parameter details

checkout supports two ordering modes: - Single product: pass product_id (e.g. p_snacks_0001) and qty - Multiple products: pass an items string of comma-separated product_id:qty pairs, e.g. p_snacks_0001:2,p_snacks_0014:1

Viewer tokens

checkout and get_orders require a viewer token. Tokens are short base64url strings (e.g. AABSu3k4oEw) issued by the BangBangMart backend. Ask the user to provide their token — do not generate or guess one.

MCP client configuration

Because the server is hosted, no local installation is needed. Configure your MCP client to point at the remote endpoint.

Cursor

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

Claude Code

`bash claude mcp add --transport http bangbangmart https://www.bangbangmart.com/mcp `

Visual Studio Code

`json { "servers": { "bangbangmart": { "type": "http", "url": "https://www.bangbangmart.com/mcp" } } } `

Kimi Code

`bash kimi mcp add --transport http bangbangmart https://www.bangbangmart.com/mcp `

Example agent workflow

1. Call search_products with a keyword (e.g. q: "薯片") to find products and their IDs. 2. Call get_product with a product_id to see full details. 3. Ask the user for their viewer token. 4. Call checkout with the token, product_id, and qty (or multi-product items) to place an order. 5. Present the payment URL from the response to the user. 6. Call pay_order with the order_id to confirm mock payment. 7. Call get_order_status or get_orders` to verify.

License

MIT — see LICENSE.