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)

smithery install mmmegamarket-mcp

Via uvx

uvx mmmegamarket-mcp

Via pip

pip install mmmegamarket-mcp

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

{
  "mcpServers": {
    "mm-query": {
      "command": "uvx",
      "args": ["mmmegamarket-mcp"],
      "env": {
        "MMPRO_USERNAME": "your_b2b_email@example.com",
        "MMPRO_PASSWORD": "your_b2b_password"
      }
    }
  }
}

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

Search for "coffee"

Price Comparison

Compare prices for "cooking oil" between B2C and B2B

Multi-Platform Search

Search for "rice" on both B2C and B2B platforms

Store Selection

List stores in south region
Set store to 10010
Search for "milk"

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/