MM Query - MCP Server

Query products from MM's retail (B2C) and wholesale (B2B) platforms using the Model Context Protocol.

Features

• 🔍 Search products across B2C and B2B platforms

• 💰 Compare retail vs wholesale prices

• 📦 Check stock availability

• 🏪 Multi-store support

• 🔗 Direct product links

• 🌐 Vietnamese language support

Installation

Via Smithery (Recommended)

Via uvx

Via pip

Configuration

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

Note: B2B credentials are optional. B2C (retail) features work without authentication.

Available Tools

1. search_products

Search for products on MM.

Note: Product names and descriptions are in Vietnamese.

Parameters:

• search_term - Keyword in English or Vietnamese (e.g., 'rice'/'gạo', 'milk'/'sữa')

• platform - "b2c", "b2b", or "both" (default: "b2c")

• page - Page number (default: 1)

• page_size - Results per page, max 50 (default: 24)

• sort_by - Sort order: "relevance", "price_asc", "price_desc", etc.

2. compare_prices

Compare prices between B2C (retail) and B2B (wholesale) platforms.

Parameters:

• search_term - Product keyword

• max_results - Maximum products to compare (default: 20)

3. list_stores

List all MM store locations.

Parameters:

• region - "north", "central", "south", or "all" (default: "all")

4. set_store

Set the active store location for searches.

Parameters:

• store_code - Store code (e.g., '10010')

5. get_current_store

Get the currently active store location.

6. authenticate_b2b

Authenticate with B2B platform (optional).

Parameters:

• username - B2B account email

• password - B2B account password

7. get_auth_status

Check B2B authentication status.

8. get_product_details

Get detailed information about a specific product.

Parameters:

• sku - Product SKU

• platform - "b2c" or "b2b" (default: "b2c")

Usage Examples

Basic Product Search

Price Comparison

Multi-Platform Search

Store Selection

Language Note

The database is primarily in Vietnamese. Product names, descriptions, and categories will be in Vietnamese. Search terms can be provided in either English or Vietnamese.

Platforms

B2C Platform

• Consumer/retail platform

• Retail pricing

• No authentication required

B2B Platform

• Business/wholesale platform

• Wholesale pricing (typically 5-15% cheaper)

• Optional authentication for full features

PyPI Package

This MCP server is published as mmmegamarket-mcp on PyPI.

Package URL: https://pypi.org/project/mmmegamarket-mcp/

License

MIT License

Support

• Issues: https://github.com/CaullenOmdahl/mm-query/issues

• PyPI: https://pypi.org/project/mmmegamarket-mcp/