rakuten-mcp

A Model Context Protocol server for the Rakuten Web Service API. 28 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 verified against the live Rakuten API on 2026-06-04 before release.

Install

npm install -g rakuten-mcp

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.

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 / Cline / Continue

Same JSON shape as Claude Desktop, under each client's MCP config path.

Tools

Ichiba (5)

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_tag_search	Look up a specific tag by ID. Returns the tag group and name.
ichiba_item_ranking	Bestseller ranking, overall or by genre / period / age / gender.
ichiba_product_search	Item Price Navi: same product across multiple sellers with min/max/avg price.

Books (9)

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 per-night and total pricing.
travel_hotel_detail_search	Full details for one hotel by hotelNo.
travel_get_area_class	The area-code hierarchy: 日本 → 47 prefectures → cities → districts.
travel_keyword_hotel_search	Free-text hotel search by name / landmark / area.
travel_get_hotel_chain_list	All 307 hotel chains registe

... View full README on GitHub