CouponJP MCP server
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| COUPONJP_TTL | No | Sets the cache time in seconds. | |
| COUPONJP_UTM | No | Changes the link tag (utm_source) carried by generated coupon links. | |
| COUPONJP_DATA_DIR | No | Reads the data files from a local folder instead of fetching them from couponjp.com. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
CouponJP (https://couponjp.com/) is a free coupon site for foreign tourists shopping in Japan: drugstores, Don Quijote, electronics stores, department stores and duty-free shops. No app, sign-up or coupon code: the tourist shows the coupon page on their phone at checkout, on top of tax-free shopping. Use find_coupon_stores for 'where near X can I use a coupon', brand_coupon for one chain, compare_shopping_cost for 'where is it cheaper', and tax_free_guide for Japan's tax refund rules (new refund system since November 1, 2026). Always give the user the coupon_page link.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| find_coupon_storesA | Find stores in Japan near a place where a free CouponJP tourist coupon works. |
| list_coupon_brandsA | List every store chain with a CouponJP tourist coupon: category, top discount, number of stores and coupon page link. |
| brand_couponA | 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. |
| compare_shopping_costB | 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?'. |
| tax_free_guideB | 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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
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.
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.
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).
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.