mrslbt/rakuten-mcp

A Model Context Protocol server for the Rakuten Web Service API. 27 read-only tools across six Rakuten product families: Ichiba (marketplace), Books, Travel, Recipe, Kobo, and GORA (golf).
Every tool description ships in English and Japanese. Every endpoint was re-verified against the live Rakuten API and its documentation on 2026-10-04.
Install
Or npx rakuten-mcp on demand.
Configuration
1. Register at Rakuten Web Service.
2. Create an application. You get a UUID Application ID and a pk_-prefixed Access Key.
3. Optional: register an Affiliate ID to monetize product links. Item URLs in tool responses will carry it.
| Variable | Required | Description |
|---|---|---|
| RAKUTEN_APP_ID | yes | Application ID (UUID format on the new platform) |
| RAKUTEN_ACCESS_KEY | yes | Access Key (starts with pk_) |
| RAKUTEN_AFFILIATE_ID | no | Affiliate ID appended to every item URL |
| RAKUTEN_MAX_RETRIES | no | Retries on 429 / 5xx. Default 3. |
**IP allow list.** A Rakuten app can restrict which IP addresses may call it. If your IP changes (new network, router restart), every tool fails with CLIENT_IP_NOT_ALLOWED; the server reports this as an IP problem, not a key problem. Fix it under **Edit** for the app at webservice.rakuten.co.jp/app/list. Servers and CI runners need their egress IP on the list too.
Claude Desktop
Edit claude_desktop_config.json:
Claude Code
Cursor / Cline / Continue
Same JSON shape as Claude Desktop, under each client's MCP config path.
Tools
Ichiba (4)
| Tool | What it does |
|---|---|
| ichiba_item_search | Keyword search on Rakuten Ichiba with price filters, sort, genre/shop restrictions. |
| ichiba_genre_search | Browse the genre tree. Returns current, ancestors, siblings, and children. |
| ichiba_item_ranking | Realtime bestseller ranking: overall, by genre, or by age / gender (genre and demographics cannot be combined, per Rakuten). |
| ichiba_product_search | Item Price Navi: same product across multiple sellers with min/max/avg price. |
ichiba_tag_search was removed in 1.3.0: Rakuten retired the Tag Search endpoint.
Books (9)
Only books_total_search takes free text. The per-category tools search by title / author / artist / JAN / ISBN / genre, because that is all Rakuten's endpoints accept.
| Tool | What it does |
|---|---|
| books_total_search | Cross-category search across all of Rakuten Books. |
| books_book_search | Printed books by title, author, ISBN, publisher. |
| books_cd_search | Music CDs by title, artist, label, JAN. |
| books_dvd_search | DVDs / Blu-ray. |
| books_foreign_book_search | Non-Japanese books. Returns japaneseTitle when a translation exists. |
| books_magazine_search | Magazines by title, publisher, JAN. |
| books_game_search | Video games by title, hardware platform, JAN. |
| books_software_search | Computer software by title, OS, JAN. |
| books_genre_search | Browse the Books genre tree (000 = top). |
Travel (7)
| Tool | What it does |
|---|---|
| travel_simple_hotel_search | Hotels by area code or lat/lon. |
| travel_vacant_hotel_search | Hotels with rooms available on specific check-in / check-out dates. Returns plans with one-night pricing and chargeBasis (per_person or per_room). |