rakuten-mcp

Model Context Protocol server for the Rakuten Web Service API. Covers Rakuten Ichiba (marketplace), Rakuten Books, and Rakuten Travel.

Install

npm install -g rakuten-mcp

Or run on demand with npx rakuten-mcp.

Configuration

1. Sign in at Rakuten Web Service and click + New App.
2. Pick Web Application as the type, set Allowed Websites to github.com (and any other domain you'll send the Origin header from), and tick the API scopes you need (Ichiba, Books, Travel).
3. Copy the Application ID (UUID) and Access Key from the app dashboard.

Variable	Required	Description
RAKUTEN_APP_ID	yes	Application ID (UUID format)
RAKUTEN_ACCESS_KEY	yes	Access Key (pk_...)
RAKUTEN_ORIGIN	no	Origin/Referer header sent with every request. Defaults to https://github.com. Must match one of the Allowed Websites you configured on the app.

Note: Rakuten migrated their API platform in 2026. Old-format numeric Application IDs no longer work. If you have a pre-2026 numeric app ID, you must register a new app to get the UUID + Access Key pair this server requires.

Claude Desktop

Edit claude_desktop_config.json:

{
  "mcpServers": {
    "rakuten": {
      "command": "npx",
      "args": ["-y", "rakuten-mcp"],
      "env": {
        "RAKUTEN_APP_ID": "your-app-id",
        "RAKUTEN_ACCESS_KEY": "your-access-key"
      }
    }
  }
}

Claude Code

claude mcp add rakuten -e RAKUTEN_APP_ID=... -e RAKUTEN_ACCESS_KEY=... -- npx -y rakuten-mcp

Cursor

Add to ~/.cursor/mcp.json with the same shape as Claude Desktop.

Tools

Tool	Description
search_products	Full-text product search with price filters, sorting, and pagination.
get_genre_ranking	Bestseller rankings, overall or by category.
search_genres	Browse the product category hierarchy.
search_books	Search Rakuten Books by title, author, or ISBN.
search_travel	Search hotels on Rakuten Travel by keyword.
search_travel_vacancy	Search available rooms with date, price, and location filters.

Prompts

Prompt	Description
search_products	Search for products with optional price filters.
compare_products	Compare products sorted by reviews or price.
category_bestsellers	Bestseller ranking for a category.
find_hotel	Find hotels available on specific dates.
budget_hotel	Find hotels within a budget.
find_book	Search for a book by title, author, or ISBN.
books_by_author	Find all books by an author.

Resources

Resource	URI	Description
Supported Genres	rakuten://genres	Top-level Rakuten Ichiba product categories.

Example queries

Find wireless earphones under ¥10,000 with good reviews.
楽天で1万円以下のワイヤレスイヤホンを探して。

What are the top sellers on Rakuten right now?
楽天の今の売れ筋ランキングを見せて。

Search for hotels in Kyoto on Rakuten Travel.
楽天トラベルで京都のホテルを探して。

Find available rooms near Tokyo Station for April 15-17 under ¥15,000.
東京駅近くで4月15〜17日、1万5千円以下の空室を探して。

Find books by Haruki Murakami on Rakuten Books.
村上春樹の本を楽天ブックスで探して。

Safety

All tools in this server are read-only searches against the Rakuten Web Service API. No tool creates, modifies, or deletes any resource. Rakuten enforces a

... View full README on GitHub