Bangbangmart
About
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…
Explore
- 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.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
BangbangmartCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Because the server is hosted, no local installation is needed. Configure your MCP client to point at the remote endpoint.
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 | 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. |
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"bangbangmart": {
"bangbangmart": {
"type": "http",
"url": "https://www.bangbangmart.com/mcp"
}
}
}
}McpServers
{
"bangbangmart": {
"type": "http",
"url": "https://www.bangbangmart.com/mcp"
}
}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.Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
