Back to Browse

Japan Price Alert MCP Server

Developer ToolsUse Caution3.5MCP RegistryLocal
Free

Server data from the Official MCP Registry

Price change alert MCP. Apify: apify.com/fruitful_quintessence Gumroad: atushi5.gumroad.com/l/kutuxe

About

Price change alert MCP. Apify: apify.com/fruitful_quintessence Gumroad: atushi5.gumroad.com/l/kutuxe

Security Report

3.5
Use Caution3.5High Risk

The server has no authentication and no ownership checks, so any caller can read, modify, or delete any watch by id, and user_id is caller-supplied. The main code risk is that fetch_price passes caller-supplied URLs to urllib without restricting the scheme, so file:// URLs can read local files and return extracted title text, and the webhook and fetch paths can reach internal hosts. Otherwise the code is clean: the SQL is parameterized, the update allowlist is enforced, there are no hardcoded secrets, and the dependencies are minimal. Supply chain analysis found 3 known vulnerabilities in dependencies (1 critical, 1 high severity).

12 files analyzed · 11 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

database

Check that this permission is expected for this type of plugin.

env_vars

Check that this permission is expected for this type of plugin.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-atushi1841-japan-price-alert-mcp": {
      "args": [
        "japan-price-alert-mcp"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

japan-price-alert-mcp

Japanese EC price-change monitoring and notification MCP server for AI agents.

Smithery

Overview

Monitor product prices across major Japanese e-commerce platforms (Mercari, Yahoo Auctions, Rakuten, SUUMO, Kakaku.com) and receive instant alerts on price drops.

Built on the Kensho project's price monitoring engine.

Platforms

  • Mercari Japan (メルカリ) - jp.mercari.com
  • Yahoo! Auctions / Shopping (ヤフオク) - auctions.yahoo.co.jp, shopping.yahoo.co.jp
  • Rakuten Ichiba (楽天市場) - item.rakuten.co.jp
  • SUUMO (SUUMO) - suumo.jp
  • Kakaku.com (価格.com) - kakaku.com
  • Suruga-ya (駿河屋) - suruga-ya.jp

Tools

ToolDescription
create_price_watchRegister a new product URL for price monitoring
list_price_watchesList all registered watches
get_price_watchGet details of a specific watch
update_price_watchUpdate watch parameters (target price, interval, etc.)
delete_price_watchRemove a watch
check_price_watchForce immediate price check
run_due_price_checksBatch check all due watches
get_price_historyGet historical price data
detect_platform_urlDetect platform from URL

Installation

Smithery (Recommended)

npx @smithery/cli install atushi1841/japan_price_alert_mcp

Manual

# Clone or extract the MCPB bundle
# Configure in your MCP client:
{
  "servers": {
    "japan-price-alert-mcp": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/bundle", "src/stdio_main.py"]
    }
  }
}

Configuration

Environment VariableDescriptionDefault
PRICE_WATCH_DBCustom SQLite database path<bundle>/data/price_watch.db
TELEGRAM_BOT_TOKENTelegram bot token (for notifications)-
TELEGRAM_CHAT_IDTelegram chat ID (for notifications)-

Usage Examples

// Create a price watch
const result = await mcp.callTool("create_price_watch", {
  user_id: "user123",
  url: "https://www.mercari.com/us/item/m123456789/",
  target_price_jpy: 5000,
  notification_channel: "telegram",
  notification_destination: "123456789",
  check_interval_minutes: 30
});

// Check a specific watch
const check = await mcp.callTool("check_price_watch", {
  watch_id: "pw_abc123"
});

// List all watches
const list = await mcp.callTool("list_price_watches", {
  user_id: "user123"
});

Alert Conditions

  • lte (default): Alert when price <= target_price_jpy
  • any_drop: Alert on any price decrease
  • percent_drop: Alert when price drops by >= drop_percentage%
  • in_stock: Alert when item comes back in stock

Notification Channels

  • log (default): Log to stderr
  • telegram: Send to Telegram bot (requires token + chat_id)
  • webhook: POST to specified URL
  • email: Log email alert (SMTP not implemented)

Dependencies

  • Python >=3.10
  • fastmcp >=3.0.0
  • stdlib only for scraping (no external dependencies beyond fastmcp)

License

MIT

Author

atushi1841


Data & Store

Reviews

No reviews yet

Be the first to review this server!