Skip to main content
Glama

CouponJP MCP server

Let AI assistants answer "where near here can I use a tourist coupon in Japan?"

CouponJP is a free coupon site for foreign tourists shopping in Japan: Don Quijote, drugstores (Sugi, Tsuruha, Sundrug, Cosmos, Kokumin), electronics stores, department stores and duty-free shops, about 2,200 stores in all. There's no app, sign-up or coupon code: tourists show the coupon page on their phone at checkout, on top of tax-free shopping.

This Model Context Protocol server is read-only and needs no API key. It reads CouponJP's public data files (https://couponjp.com/coupon-api.json, data.json, stations.json), cached for an hour.

Tools

Tool

What it answers

find_coupon_stores

Stores near a shopping area, city, train station or coordinates, nearest first, with discount, address, distance, coupon link and map link. Place names work in English, Japanese, Chinese and Korean ("Namba", "心斎橋", "难波", "도톤보리").

list_coupon_brands

Every chain with a coupon: category, top discount, number of stores.

brand_coupon

One chain: discount by purchase amount or product type, validity, the store's tax refund fee.

compare_shopping_cost

The same purchase at every chain after the coupon and the tax refund fee ("is a drugstore or department store cheaper?").

tax_free_guide

Japan's tax-free rules for tourists (refund system since November 1, 2026) with links to detailed guides.

Every tool takes language (en, zh-CN, zh-TW, ja, ko, th, vi, id, ms, fil, hi, fr, de, es, it, pt, ru) for names, addresses and links.

Related MCP server: ecommerce-mcp-server

Install

Requires Python 3.10+ and uv.

Claude Desktop (claude_desktop_config.json), Cursor, Windsurf and other MCP clients:

{
  "mcpServers": {
    "couponjp": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/couponjp/couponjp-mcp", "couponjp-mcp"]
    }
  }
}

Claude Code:

claude mcp add couponjp -- uvx --from git+https://github.com/couponjp/couponjp-mcp couponjp-mcp

Example

"I'm near Shinsaibashi. Where can I use a tourist coupon?"

The assistant calls find_coupon_stores(place="Shinsaibashi") and gets the nearest stores in the Namba / Shinsaibashi / Dotonbori area, each with its discount and coupon link.

Notes

  • Discounts and conditions are set by each store and can change. The coupon shown on couponjp.com is what counts.

  • Distances are straight-line. Train station names and locations come from Wikidata (CC0).

  • Links carry utm_source=mcp so CouponJP can see how many people the tool sends.

  • Environment variables (optional): COUPONJP_DATA_DIR reads the data files from a local folder, COUPONJP_TTL sets the cache time in seconds, and COUPONJP_UTM changes the link tag.

License

MIT. Operated by NNT Corporation (NNT株式会社), Japan. Contact: info@couponjp.com

Available Tools

5 tools
brand_couponA
Read-onlyIdempotent

Coupon details for one chain (e.g. "Don Quijote", "Daimaru", "Kokumin"): discount by purchase amount or product type, validity, the store's tax refund fee and the coupon page link.

Inputs: brand (required), language.

compare_shopping_costB
Read-onlyIdempotent

Compare what the same purchase (amount in yen before tax) costs at each chain after the CouponJP coupon and the tax refund fee. Answers 'is a drugstore, department store or duty-free shop cheaper?'.

Inputs: language, amount_jpy.

find_coupon_storesA
Read-onlyIdempotent

Find stores in Japan near a place where a free CouponJP tourist coupon works.

place: a shopping area (e.g. "Namba", "Shinjuku", "Ginza", "Shinsaibashi"), a city ("Osaka") or a train station name,
in English, Japanese, Chinese or Korean. Or give latitude and longitude instead.
brand: optional chain name to filter (e.g. "Don Quijote", "Sugi Pharmacy", "Bic Camera").
language: answer language code (en, zh-CN, zh-TW, ja, ko, th, vi, id, ms, fil, hi, fr, de, es, it, pt, ru).
one_per_chain_first: list the nearest store of each chain first (default), then the rest; false = strict distance order.
Returns each store's brand, discount, address, straight-line distance, coupon page link and Google Maps link.

Inputs: brand, limit, place, language, +4 more.

list_coupon_brandsA
Read-onlyIdempotent

List every store chain with a CouponJP tourist coupon: category, top discount, number of stores and coupon page link.

Inputs: language.

tax_free_guideB
Read-onlyIdempotent

Japan tax-free shopping rules for tourists (refund system since November 1, 2026) with links to detailed guides: airport refunds, refund fees by store and common mistakes.

Inputs: language.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool targets a distinct query axis: geographic store lookup (find_coupon_stores), chain inventory (list_coupon_brands), single-chain coupon detail (brand_coupon), cost comparison (compare_shopping_cost), and policy reference (tax_free_guide). The list vs. detail pair (list_coupon_brands vs. brand_coupon) is a common and clearly delineated pattern, and descriptions reinforce the boundaries.

    Naming Consistency4/5

    Three tools follow a clean verb_noun pattern (find_coupon_stores, list_coupon_brands, compare_shopping_cost), but brand_coupon and tax_free_guide are bare noun phrases with no verb. The convention is readable and predictable overall, just with minor deviations.

    Tool Count5/5

    Five tools is tightly scoped to the coupon-discovery domain, with no redundant or filler endpoints. Each tool covers a genuinely different step in a tourist's shopping workflow (find, browse, inspect, compare, understand rules).

    Completeness4/5

    The surface covers discovery by place and by chain, per-chain detail, cost comparison, and tax-free policy, which is most of the domain. Minor gaps exist: no category-based browsing (e.g. drugstore vs. department store) independent of location, and no way to list a chain's stores directly other than via location search with a brand filter.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers