Tools Overview
PriceMinder MCP Server provides 22 tools (10 basic + 12 smart-follow), classified into query, action, insight, and smart follow.
Available Tools
Basic Tools (10)
| Tool | Category | Function |
|---|---|---|
get_monitor_list | Query | List all monitored products for the current user |
search_my_products | Query | Search the watchlist by keyword (product or shop name) |
get_price_summary | Query | Get price statistics summary (current/baseline/highest/lowest/average/trend) |
get_price_history | Query | Query historical price records for a specific product |
get_alerts | Query | Get price drop alert records, filterable by site |
add_monitor | Action | Add a new monitored product (supports 7 Shopee sites) |
update_monitor_status | Action | Enable or pause a monitored product |
mark_alert_read | Action | Mark an alert as read |
get_crawl_health | Insight | Check the crawl service health status |
get_monitor_overview | Insight | Get monitoring overview (counts, site distribution, last 7 days) |
Smart-Follow Tools (12)
12 tools cover the loop from triggering an analysis, reading suggestions, recording/adopting/rejecting decisions, reviewing them, to viewing stats:
| Tool | Category | Function |
|---|---|---|
run_smart_follow_analysis | Smart Follow | Trigger a smart-follow analysis and return the price suggestions fired this run |
get_smart_follow_results | Smart Follow | Read the latest smart-follow results and per-product suggestions |
mark_self_owned | Smart Follow | Mark a monitored product as self-owned (or unmark it) |
map_competitors | Smart Follow | Set competitor mappings for a self-owned product (overwrites existing) |
get_competitor_mapping | Smart Follow | View competitor mappings of self-owned products |
create_decision | Smart Follow | Record a smart-follow decision (follow/hold/observe/raise/improve rating) |
list_decisions | Smart Follow | List smart-follow decision records and their status |
review_decision | Smart Follow | Submit a review outcome and notes for a decision |
adopt_decision | Smart Follow | Adopt a decision and record the actual price |
reject_decision | Smart Follow | Reject a decision |
get_smart_follow_stats | Smart Follow | View smart-follow stats for the last 30 days (adoption rate, by action) |
get_algorithm_list | Smart Follow | View enabled algorithms and their parameters |
Tool Tier Descriptions
- Query: Reads data, does not modify state. Safe for AI to call.
- Action: Modifies monitor state (add/pause/resume). Requires user confirmation.
- Insight: Aggregates and analyzes data to support operational decisions.
- Smart Follow: Reads and writes smart-follow decision data (analysis runs, mappings, decision logging and reviews). Write tools change data — confirm before calling.
Tool Naming Convention
All tools use snake_case naming with mcp__sentinel__ prefix when exposed to AI clients. E.g., mcp__sentinel__get_monitor_list.