Rakuten Travel
About
Search for hotels and check their availability using the Rakuten Travel API.
Details
- Author
- hirochachacha
- Categories
- Search, API
Jump to
Setup
Install Rakuten Travel in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/hirochachacha/rakuten_travel_mcp
Follow the installation instructions in the repository README, then restart your MCP client.
A Model Context Protocol (MCP) server that provides an interface to the Rakuten Travel API for hotel searching and availability checking.
- Hotel Search: Search for hotels by location, hotel number, or area code
- Availability Search: Find vacant hotels with real-time availability
- Area Code Resource: Access hierarchical Japanese location data
- Type-Safe: Comprehensive TypeScript types with Zod validation
- MCP Compliant: Works with any MCP-compatible client
- Denoruntime installed
- Rakuten Travel API Application ID (Get one here)
git clone https://github.com/yourusername/rakuten_travel_mcp.git cd rakuten_travel_mcp
- configure your MCP client. (following example is forClaude Desktop)
json { "mcpServers": { "rakuten_travel_mcp": { "command": "deno", "args": [ "run", "--allow-net=app.rakuten.co.jp", "--allow-env=APPLICATION_ID", "/path/to/rakuten_travel_mcp/serve.ts" ], "env": { "APPLICATION_ID": "<your_application_id>" } } } }
Search for hotels using various criteria:
{ "hotelNo": ["123456", "789012"] }
{ "latitude": 35.6762, "longitude": 139.6503, "searchRadius": 3, "datumType": 1 }
{ "largeClassCode": "japan", "middleClassCode": "tokyo", "smallClassCode": "shibuya" }
2. Vacant Hotel Search (vacant-hotel-search)
{ "checkinDate": "2024-03-15", "checkoutDate": "2024-03-17", "rooms": 1, "adultNum": 2, "largeClassCode": "japan", "middleClassCode": "tokyo" }
Area Code Resource (config://area_code)
Access hierarchical location data for Japan:
- Country level (e.g., "japan")
- Prefecture level (e.g., "tokyo", "osaka")
- City level (e.g., "shibuya", "shinjuku")
- Area level (detailed districts)
# Run all tests deno task test # Run tests in watch mode deno task test:watch
rakuten_travel_mcp/ ├── serve.ts # Main MCP server implementation ├── types.ts # TypeScript types and Zod schemas ├── area_code.json # Hierarchical location data ├── *.test.ts # Test files ├── deno.json # Deno configuration └── .env # Environment variables (create this)``
-
hits: Number of results per page (1-30, default: 30)
- page: Page number for pagination
- sort: Sort order (various options available)
-
hotelNo: Array of hotel numbers
- latitude/longitude: Coordinates for geographic search
- searchRadius: Search radius in km (1-3)
- squeezeCondition: Filter for hotels with/without vacancies
- hotelType: Filter by hotel type (0-3)
-
checkinDate/checkoutDate: Required dates (YYYY-MM-DD)
- rooms: Number of rooms (1-5)
- adultNum: Adults per room (1-5)
- minCharge/maxCharge: Price range filters
The project includes comprehensive tests for:
- Schema validation
- API parameter building
- Response processing
- Error handling
- Network timeouts
The server handles various error scenarios:
- Missing required parameters
- Invalid date formats
- API rate limits
- Network timeouts
- Invalid API responses
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature)
- Commit your changes (git commit -m 'Add some amazing feature')
- Push to the branch (git push origin feature/amazing-feature`)- Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Built withModel Context Protocol SDK
- Powered byRakuten Travel API
Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.
Search the web using Kagi's search API
Unlock geospatial intelligence through Mapbox APIs like geocoding, POI search, directions, isochrones and more.
Interact & query with Meilisearch (Full-text & semantic search API)
One API for Search, Crawling, and Sitemaps
Discover public A2A agents on the Agently platform using its public API.
Integrate with the Amazon Product Advertising API to search for products and access product information.
Multi-provider search broker for AI agents. Routes across SearXNG, Brave, Serper, Tavily, and Exa with automatic fallback, RRF ranking, content extraction, and budget enforcement.
An MCP server using the AviationStack API to fetch real-time flight data including airline flights, airport schedules, future flights and aircraft types.
A search server for the Model Context Protocol (MCP) that uses the Baidu Wenxin API.
Perform web, news, and image searches using the Microsoft Bing Search API.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
