CouponJP MCP server
OfficialSupplies train station names and their geographic locations (CC0 data) used to resolve place and station names so the server can return coupon stores nearest to a given station.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@CouponJP MCP server I'm near Shinsaibashi. Where can I use a tourist coupon?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| 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", "心斎橋", "难波", "도톤보리"). |
| Every chain with a coupon: category, top discount, number of stores. |
| One chain: discount by purchase amount or product type, validity, the store's tax refund fee. |
| The same purchase at every chain after the coupon and the tax refund fee ("is a drugstore or department store cheaper?"). |
| 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-mcpExample
"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=mcpso CouponJP can see how many people the tool sends.Environment variables (optional):
COUPONJP_DATA_DIRreads the data files from a local folder,COUPONJP_TTLsets the cache time in seconds, andCOUPONJP_UTMchanges the link tag.
License
MIT. Operated by NNT Corporation (NNT株式会社), Japan. Contact: info@couponjp.com
Available Tools
5 toolsbrand_couponARead-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_costBRead-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_storesARead-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_brandsARead-onlyIdempotent
List every store chain with a CouponJP tourist coupon: category, top discount, number of stores and coupon page link.
Inputs: language.
tax_free_guideBRead-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
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.
Maintenance
Related MCP Connectors
Official Japan inbound travel & cross-border rules for AI Agents (Tax-Free, Shinkansen).
Pickup orders at Japanese restaurants for AI agents: find stores, read menus, place orders. No auth.
Free coupon codes, deals and sale prices for stores and products while your AI shops.
Human task execution in Japan, exclusively for AI agents: shopping, stock checks, photos, bookings.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to search products, manage shopping carts, place orders, and retrieve order history from Amazon and Target accounts.3MIT
- AlicenseAqualityDmaintenanceEnables AI agents to search products, lookup barcodes, and manage shopping carts and wishlists using free e-commerce APIs.8MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to perform Japanese invoice and tax calculations, including consumption tax, withholding tax, invoice number validation, and invoice data generation, all locally without external APIs.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to search local merchants and products, find nearby or open stores, assess item stock likelihood with reasons, and validate merchant listings through receipts and tiers.76 npmMIT