Find toilets, trash cans, coin lockers, smoking areas, vending machines and stamps in Japan.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Find the closest vending machines, toilets, smoking areas, trash cans, stamp stations or coin lockers in Japan around a point or in one of Ippuku's areas, closest first, with distance, attributes and a link to the map. Use it whenever the user asks where the nearest such place is, for example "Where can I smoke near Namba?". Pass either area (see list_areas) or lat and lon, not both. If nothing is found, retry with a larger radius.
Latitude of the center, WGS84. Required with lon unless area is given.
Longitude of the center, WGS84. Required with lat unless area is given.
An area from GET /v1/areas, such as osaka/namba. Uses the area's center and radius. Pass either area or lat and lon, not both.
Maximum number of places, closest first.
Search radius in meters. Default 1000, with area the area's radius (and at most that).
Only places of this category. Without it, all categories.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http ippuku https://api.ippuku.app/mcp
Find the closest vending machines, toilets, smoking areas, trash cans, stamp stations or coin lockers in Japan around a point or in one of Ippuku's areas, closest first, with distance, attributes and a link to the map. Use it whenever the user asks where the nearest such place is, for example "Where can I smoke near Namba?". Pass either area (see list_areas) or lat and lon, not both. If nothing is found, retry with a larger radius.
| Argument | Type | Description |
|---|---|---|
| lat | number | Latitude of the center, WGS84. Required with lon unless area is given. |
| lon | number | Longitude of the center, WGS84. Required with lat unless area is given. |
| area | string | An area from GET /v1/areas, such as osaka/namba. Uses the area's center and radius. Pass either area or lat and lon, not both. |
| limit | integer | Maximum number of places, closest first. |
| radius | integer | Search radius in meters. Default 1000, with area the area's radius (and at most that). |
| category | string | Only places of this category. Without it, all categories. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"lat": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude of the center, WGS84. Required with lon unless area is given."
},
"lon": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude of the center, WGS84. Required with lat unless area is given."
},
"area": {
"enum": [
"tokyo/shinjuku",
"tokyo/shibuya",
"tokyo/ikebukuro",
"tokyo/tokyo-station",
"tokyo/ginza",
"tokyo/asakusa",
"tokyo/ueno",
"tokyo/akihabara",
"tokyo/roppongi",
"tokyo/shinagawa",
"tokyo/odaiba",
"osaka/namba",
"osaka/umeda",
"osaka/shinsaibashi",
"osaka/tennoji",
"osaka/shin-osaka",
"kyoto/kyoto-station",
"kyoto/gion",
"kyoto/arashiyama",
"yokohama/yokohama-station",
"yokohama/minatomirai",
"nara/nara-park",
"kobe/sannomiya",
"hiroshima/hiroshima-center",
"fukuoka/hakata",
"fukuoka/tenjin",
"sapporo/sapporo-center",
"nagoya/nagoya-station",
"kanazawa/kanazawa-center",
"takayama/takayama-old-town",
"kamakura/kamakura-center",
"nikko/nikko-center",
"fujikawaguchiko/kawaguchiko",
"sendai/sendai-station",
"naha/kokusai-dori"
],
"type": "string",
"description": "An area from GET /v1/areas, such as osaka/namba. Uses the area's center and radius. Pass either area or lat and lon, not both."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "Maximum number of places, closest first."
},
"radius": {
"type": "integer",
"maximum": 2000,
"minimum": 10,
"description": "Search radius in meters. Default 1000, with area the area's radius (and at most that)."
},
"category": {
"enum": [
"vending_machine",
"toilet",
"smoking_area",
"waste_basket",
"stamp",
"coin_locker"
],
"type": "string",
"description": "Only places of this category. Without it, all categories."
}
}
}Show one place with all its attributes, votes, photo count and its link to the map. Use it when the user wants details about a place from find_nearby_places, such as opening hours or whether it is indoors.
| Argument | Type | Description |
|---|---|---|
| id* | string | The id of a place, from find_nearby_places. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "The id of a place, from find_nearby_places."
}
}
}List the areas Ippuku knows (neighborhoods of big cities such as Shinjuku, Namba or Gion, and smaller towns such as Kamakura), with their slug, center, radius and the number of places per category. Use it to find the slug to pass as area to find_nearby_places, or to see where Ippuku has data.
No arguments.
{
"type": "object",
"properties": {}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 18, 2026.