Skip to main content
Glama
haidrau

Priceminder MCP Server

by haidrau

Priceminder MCP Server

License: MIT Python MCP Website

δΈ­ζ–‡ | English

Priceminder β€” Real-time Shopee competitor price monitoring, powered by AI agents through the Model Context Protocol (MCP).

🌐 Sign up free: priceminder.online

Monitor competitor prices across Shopee Southeast Asia (SG, MY, TH, VN). Let your AI agent track, analyze, and alert on price movements β€” all through natural language.


🌟 Features

#

Tool

Description

Tier

1

get_monitor_list

List all products you're tracking

πŸ” Query

2

get_price_summary

Price summary across all tracked products (batch mode)

πŸ” Query

3

get_price_history

Time-series price data for a specific product

πŸ” Query

4

get_alerts

List price drop alerts

πŸ” Query

5

add_monitor

Add a new product to track

⚑ Action

6

update_monitor_status

Pause or resume monitoring

⚑ Action

7

mark_alert_read

Mark an alert as read

⚑ Action

8

get_crawl_health

Check crawler engine health & stats

πŸ“Š Insight

9

get_monitor_overview

Dashboard overview of all monitors

πŸ“Š Insight

10

search_my_products

Search your tracked products by keyword

πŸ“Š Insight


Related MCP server: Ecommerce Price Monitor MCP

πŸš€ Quick Start

Just add this URL to any MCP-compatible client:

https://priceminder.online/mcp_server?key=YOUR_MCP_KEY

Step 1: Get your MCP Key

Step 2: Configure your AI client

For Claude Desktop / Cursor / Cherry Studio:

{
  "mcpServers": {
    "priceminder": {
      "type": "http",
      "url": "https://priceminder.online/mcp_server?key=YOUR_MCP_KEY"
    }
  }
}

For Claude Code:

claude mcp add priceminder --type http --url "https://priceminder.online/mcp_server?key=YOUR_MCP_KEY"

Option B: Self-Hosted (Docker)

docker run -d \
  --name priceminder-mcp \
  -p 8082:8082 \
  -e SENTINEL_API_BASE=https://priceminder.online/shopee \
  -e SENTINEL_TOKEN=YOUR_SENTINEL_TOKEN \
  -e SENTINEL_API_KEY=sentinel-mvp-2026 \
  ghcr.io/haidrau/sentinel-mcp-server:latest

Option C: Self-Hosted (pip)

pip install sentinel-mcp-server

# Run in stdio mode (for Claude Desktop, Cursor, etc.)
export SENTINEL_TOKEN=YOUR_SENTINEL_TOKEN
sentinel-mcp-server

# Or run in HTTP mode
export SENTINEL_TOKEN=YOUR_SENTINEL_TOKEN
sentinel-mcp-server --mode http

πŸ—οΈ Architecture

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                  AI Client                          β”‚
β”‚  (Claude Desktop / Cursor / Claude Code / Codex)    β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
               β”‚  MCP Protocol (stdio or HTTP/SSE)
               β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚     Priceminder MCP Server           β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”‚
β”‚  β”‚  Tool Registry (10 tools)     β”‚  β”‚
β”‚  β”‚  - get_monitor_list           β”‚  β”‚
β”‚  β”‚  - get_price_summary          β”‚  β”‚
β”‚  β”‚  - get_price_history          β”‚  β”‚
β”‚  β”‚  - get_alerts                 β”‚  β”‚
β”‚  β”‚  - add_monitor                β”‚  β”‚
β”‚  β”‚  - ...                        β”‚  β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β”‚
β”‚                 β”‚ HTTP + Token Auth
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”‚
β”‚  β”‚  API Client (httpx)           β”‚  β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                  β”‚ HTTPS
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚     Priceminder REST API             β”‚
β”‚  (User Mgmt / Monitor / Price / Alert)β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                  β”‚
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚     PostgreSQL 16                    β”‚
β”‚  (Price History / Users / Alerts)    β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸ”§ Configuration

Environment Variables

Variable

Description

Default

SENTINEL_API_BASE

Backend API base URL

https://priceminder.online/shopee

SENTINEL_TOKEN

Your authentication token

(required)

SENTINEL_API_KEY

API key for backend auth

sentinel-mvp-2026

SENTINEL_TIMEOUT

HTTP request timeout (s)

30

MCP_MODE

Run mode: stdio or http

stdio

MCP_HOST

HTTP server bind address

127.0.0.1

MCP_PORT

HTTP server port

8082

LOG_LEVEL

Log level

INFO


πŸ’¬ Usage Examples

Once configured, you can ask your AI agent things like:

Price monitoring:

  • "Show me my tracked products on Shopee SG"

  • "What's the price trend for the iPhone 14 I'm monitoring?"

  • "Has any competitor dropped prices in the last 3 days?"

Adding products:

Alerts & insights:

  • "Any new price drop alerts?"

  • "How's the crawler system running today?"

  • "Give me a dashboard overview"


πŸ“‘ API Reference

Authentication

All API calls require these headers:

X-Api-Key: sentinel-mvp-2026
X-Sentinel-Token: YOUR_TOKEN

Generate MCP Key

curl -X POST https://priceminder.online/shopee/mcp/generate-key \
  -H "X-Api-Key: sentinel-mvp-2026" \
  -H "X-Sentinel-Token: YOUR_TOKEN"

Verify MCP Key (MCP Server Internal)

curl https://priceminder.online/shopee/mcp/verify-key?key=YOUR_MCP_KEY \
  -H "X-MCP-Internal-Key: sentinel-mcp-internal-2026"

πŸ†“ Free vs Pro

Feature

Free

Pro

Active monitors

5 max

Unlimited

Price history

3 days

90 days

Price summary

3 days

90 days

Call rate

60/hour

Unlimited

Real-time alerts

β€”

βœ…

Priority support

β€”

βœ…


πŸ› οΈ Development

git clone https://github.com/haidrau/sentinel-mcp-server.git
cd sentinel-mcp-server

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
python -m pytest tests/

# Start in dev mode
export SENTINEL_TOKEN=your-test-token
python -m sentinel_mcp.server

πŸ“„ License

MIT License β€” see LICENSE for details.


🀝 Contributing

Contributions are welcome! Feel free to:

  • Open issues for bugs or feature requests

  • Submit PRs for new tools or improvements

  • Ask questions in the discussions


A
license - permissive license
-
quality - not tested
B
maintenance

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/haidrau/sentinel-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server