hotel-searchLABSCO SUMMARY
Two searches, and the area codes to drive them.
Discovery and availability are separate calls here, which matches how a trip actually gets planned: find candidates first, then test dates against them. The area-code resource is what makes that work from a conversation — an assistant can look up the codes for a district rather than invent them. It reads Rakuten Travel and stops there; booking happens elsewhere.
What it is
A Deno MCP server over the Rakuten Travel API. It covers the two questions a trip plan actually runs into: which hotels exist where you are looking, and which of them are still bookable on the nights you want. Japanese location data ships as a resource, so an assistant can resolve a district into the codes the API expects instead of guessing them.
What you get
- Hotel search by hotel number, by coordinates with a search radius, or by the three-level Japanese area code —
hotel-search - Vacancy search for a check-in and check-out pair, with room count, adults per room and a price range —
vacant-hotel-search - Hierarchical Japanese location data — country, prefecture, city and district — read as a resource —
config://area_code - Result shaping shared by both searches:
hitsper page,page, andsort
Requirements
The Deno runtime and a Rakuten Travel Application ID, supplied as APPLICATION_ID. Clone the repository and point the client at serve.ts; the documented Claude Desktop entry runs deno run with --allow-net=app.rakuten.co.jp and --allow-env=APPLICATION_ID, so the process can reach exactly one host and read exactly one variable.
Setup effort
Build from source — git clone https://github.com/hirochachacha/rakuten_travel_mcp.git
USE CASES
01
Finding hotels in a Tokyo district
Resolve the district to its area codes, then search that area and read back the candidates.
02
Checking what is still free for specific nights
Pass check-in and check-out dates with room and guest counts, and get back only hotels with vacancies.
03
Searching around a point on the map
Give a latitude and longitude with a radius instead of a place name.
04
Staying inside a budget
Filter the vacancy search by a minimum and maximum charge so only affordable rooms come back.
2 tools
Listed in project docs. Your client may show a different list.
vacant-hotel-searchBEFORE YOU INSTALL
What to know first
Tools you get
2 tools named in the project's documentation. Both tools only search Japanese properties; there is no booking or cancellation. config://area_code is a resource, not a tool.
Requires
APPLICATION_ID in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone this one yourself.
Server setup
TERMINAL
git clone https://github.com/hirochachacha/rakuten_travel_mcp.git
cd rakuten_travel_mcpMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"rakuten_travel_mcp": {
"command": "deno",
"args": [
"run",
"--allow-net=app.rakuten.co.jp",
"--allow-env=APPLICATION_ID",
"<YOUR_PATH_TO_RAKUTEN_TRAVEL_MCP>/serve.ts"
],
"env": {
"APPLICATION_ID": "<YOUR_APPLICATION_ID>"
}
}
}
}
