English Français العربية

Japan Price Alert MCP

Official registry E-commerce

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

MCPB package https://github.com/atushi1841/japan-price-alert-mcp/releases/download/v0.1.0/server.mcpb

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. japan-price-alert-mcp
  2. Overview
  3. Platforms
  4. Tools
  5. Installation
  6. Configuration
  7. Usage Examples
  8. Alert Conditions
  9. Notification Channels
  10. Dependencies
  11. License
  12. Author
  13. Data & Store

japan-price-alert-mcp

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

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

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

Frequently asked questions

What is Japan Price Alert MCP?

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

How do I install Japan Price Alert MCP?

Follow the installation steps in its documentation, shown on this page and in its repository.

Does Japan Price Alert MCP need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Japan Price Alert MCP open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains Japan Price Alert MCP?

It is published by atushi1841. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.