Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
COUPONJP_TTLNoSets the cache time in seconds.
COUPONJP_UTMNoChanges the link tag (utm_source) carried by generated coupon links.
COUPONJP_DATA_DIRNoReads 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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
find_coupon_storesA

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.
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

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