# io.github.mrslbt/rakuten-mcp (npm · rakuten-mcp)

Rakuten Web Service for AI: Ichiba, Books, Travel, Recipe, Kobo, GORA — bilingual, read-only.

- Trust score: 68/100 (medium)
- Change this week: +18
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `rakuten-mcp`: 68/100 (this document), [markdown](https://verifymcp.io/servers/mrslbt-rakuten-mcp/rakuten-mcp.md), [page](https://verifymcp.io/servers/mrslbt-rakuten-mcp/rakuten-mcp)

## Channel facts

- Registry: `npm`
- Package: `rakuten-mcp`
- Version: `1.2.2`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 86/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 17 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 75/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 7526 tokens (~259/item across 29 items; 28 tools + 1 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 23/100
  - Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.
  - Supports UI / widget rendering.

## Install

### Claude

```bash
claude mcp add mrslbt-rakuten-mcp -- npx -y rakuten-mcp
```

### Codex

```bash
codex mcp add mrslbt-rakuten-mcp -- npx -y rakuten-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mrslbt-rakuten-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "rakuten-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add mrslbt-rakuten-mcp --command npx --arg -y --arg rakuten-mcp
```

### Hermes

```yaml
mcp_servers:
  mrslbt-rakuten-mcp:
    command: "npx"
    args: ["-y", "rakuten-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "mrslbt-rakuten-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "rakuten-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 68, +44)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Malware scan: unverified → pass
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Schema quality: 100 → unverified
- [functional improvement] License: unverified → pass
- [functional improvement] Schema quality: unverified → excellent
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] Stability: unverified → 0.20
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional] First check of Capabilities: pass
- [functional] Licence: MIT
- [functional] Package version: 1.1.0 → 1.2.2

### 2026-08-01 (score 24, +19)

- [functional improvement] Schema quality: unverified → 100
- [functional improvement] Tool coverage: unverified → 100

### 2026-07-31 (score 5, −45)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-27 (score 50)

First indexed and scored.

## MCP tools (28)

### `ichiba_item_search` (~402 tokens)

Search Rakuten Ichiba Products

Search products on Rakuten Ichiba (Japan's largest e-commerce marketplace) by keyword. Supports price range filtering, sorting by review count/average/price, and restricting results to a specific genre or shop. Returns a paginated list of items with prices, review stats, images, and direct purchase URLs.

[JA] 楽天市場(日本最大のEコマースモール)で商品をキーワード検索します。価格範囲フィルタ、レビュー数/平均/価格による並び替え、ジャンルや店舗での絞り込みに対応。価格、レビュー、画像、購入URLを含む商品一覧をページング形式で返します。

Input parameters:

- `genre_id` (string): Restrict to a specific genre ID. Browse genres via ichiba_genre_search. ジャンルIDで絞り込み。
- `hits` (integer): Number of results to return per page (1–30, default 10). 1ページあたりの取得件数(1〜30、デフォルト10)。
- `keyword` (string, required): Search keyword. Accepts Japanese or English. 検索キーワード。日本語または英語。
- `max_price` (integer): Maximum price in JPY (integer, inclusive). 最高価格(円、整数、以下)。
- `min_price` (integer): Minimum price in JPY (integer, inclusive). 最低価格(円、整数、以上)。
- `page` (integer): Page number (1+, default 1). ページ番号(1以上、デフォルト1)。
- `shop_code` (string): Restrict to a specific shop. 特定の店舗で絞り込み。
- `sort` (string): Sort order. Prefix '+' = ascending, '-' = descending. 並び順。'+' は昇順、'-' は降順。

### `ichiba_genre_search` (~209 tokens)

Browse Rakuten Ichiba Genres

Browse the Rakuten Ichiba genre (category) hierarchy. Pass '0' to list top-level genres, or a specific genre ID to fetch its ancestors, siblings, and direct children. Useful for narrowing item searches to a specific category, or for discovering what categories exist.

[JA] 楽天市場のジャンル(カテゴリ)階層を参照します。'0' を渡すとトップレベル、特定のジャンルIDを渡すと祖先・兄弟・直下の子ジャンルを取得します。商品検索を特定カテゴリに絞り込んだり、カテゴリ構造を発見するのに使えます。

Input parameters:

- `genre_id` (string): Genre ID to query. '0' returns the top-level genres; pass a child genre ID to drill down. ジャンルID。'0' はトップレベル。子ジャンルIDを渡して掘り下げます。

### `ichiba_tag_search` (~226 tokens)

Look up Rakuten Ichiba Tag Details

Look up details for a specific Rakuten Ichiba tag by tag ID. Tags are facet-style attributes (size, color, etc.) attached to items. Returns the tag group this tag belongs to, the tag name, and any parent tag. Tag IDs surface in ichiba_item_search item responses (each item carries an attributeIds array) and in ichiba_genre_search.

[JA] 特定のタグIDの詳細を取得します。タグはファセット属性(サイズ、色など)で商品に紐づいています。タグ名、所属タググループ、親タグを返します。タグIDは ichiba_item_search の各商品 attributeIds や ichiba_genre_search から取得できます。

Input parameters:

- `tag_id` (integer, required): Tag ID to fetch details for. Tag IDs are discoverable from ichiba_item_search responses (each item carries tagIds) and from ichiba_genre_search. タグID。ichiba_item_search のレスポンス内 tagIds や ichiba_genre_…

### `ichiba_item_ranking` (~279 tokens)

Get Rakuten Ichiba Bestseller Ranking

Get the Rakuten Ichiba bestseller ranking — overall or filtered by genre, time period, age, and gender demographic. Returns ranked items with their rank, price, review stats, and purchase URL. Use ichiba_genre_search to find specific genre IDs.

[JA] 楽天市場の売れ筋ランキングを取得します。総合または、ジャンル/集計期間/年代/性別で絞り込み可能。順位、価格、レビュー、購入URLを含むランキング一覧を返します。ジャンルIDの検索には ichiba_genre_search を使用してください。

Input parameters:

- `age` (string): Filter to a specific age demographic (e.g., '20s' = users in their 20s). 年代フィルタ。
- `genre_id` (string): Genre ID for the ranking. '0' returns the overall ranking. 0はジャンル全体のランキング。
- `page` (integer): Page number (1–34; Rakuten caps rankings at ~1000 items). ページ番号(1〜34)。
- `period` (string): Time window for the ranking. Default depends on Rakuten's current configuration. ランキングの集計期間。
- `sex` (string): Filter to a specific gender demographic. 性別フィルタ。

### `ichiba_product_search` (~377 tokens)

Search Rakuten Ichiba Products (Cross-Seller, with Min/Max Pricing)

Search Rakuten's Item Price Navi — cross-seller product catalogue that groups identical products across multiple shops. Returns each product with its min/max/average price across all sellers and the total number of shops carrying it. Use this (instead of ichiba_item_search) when you want to compare prices for a specific product or answer 'is this a fair price?'. Filter by maker_code to restrict to a brand.

[JA] 楽天市場の商品価格ナビを検索します。同一商品を複数店舗にまたがって集約し、最安値/最高値/平均価格と取扱店舗数を返します。特定商品の価格比較や「妥当な価格か?」を判断する用途では、ichiba_item_search ではなくこちらを使用してください。maker_code でブランド絞り込みも可能。

Input parameters:

- `genre_id` (string): Restrict results to a specific genre. ジャンルIDで絞り込み。
- `hits` (integer): Number of results per page (1–30, default 10). 1ページあたりの取得件数。
- `keyword` (string): Product keyword. Required unless product_id is provided. 商品キーワード。product_id 省略時は必須。
- `maker_code` (string): Restrict results to a specific manufacturer (maker code). メーカーコードで絞り込み。
- `page` (integer): Page number (1+, default 1). ページ番号。
- `product_id` (string): Specific product ID (format like '1:12345'). When provided, returns that product. 特定の商品ID。指定時はその商品を返します。
- `sort` (string): Sort order. '+' ascending, '-' descending. 並び順。

### `books_total_search` (~310 tokens)

Search Rakuten Books (All Categories)

Cross-category search across Rakuten Books — books, CDs, DVDs, video games, software, magazines, and foreign-language books. Use this when you don't know which category contains the target item. For category-specific results with category-specific fields, use the books_book_search / books_cd_search / etc. tools.

[JA] 楽天ブックス(本、CD、DVD、ゲーム、ソフトウェア、雑誌、洋書)を横断検索します。カテゴリが不明な検索に使用してください。カテゴリ固有のフィールドが必要な場合は books_book_search / books_cd_search などを使用してください。

Input parameters:

- `booksGenreId` (string): Restrict to a specific Books genre (3-character IDs, hierarchical). Use books_genre_search to discover. ジャンルIDで絞り込み(books_genre_search で取得)。
- `hits` (integer): Number of results per page (1–30, default 10). 1ページあたりの取得件数(1〜30、デフォルト10)。
- `keyword` (string, required): Search keyword across all Rakuten Books categories (books, CDs, DVDs, software, games, magazines). 楽天ブックス全カテゴリ横断キーワード検索。
- `page` (integer): Page number (1+, default 1). ページ番号(1以上、デフォルト1)。
- `sort` (string): Sort order. 並び順。

### `books_book_search` (~356 tokens)

Search Rakuten Books (Printed Books)

Search Rakuten Books for printed books by title, author, ISBN, publisher, or free-text keyword. Returns book details including ISBN, author, publisher, series, table of contents, preview URL, list price, and review stats. Pass at least one search field.

[JA] 楽天ブックスで紙の書籍を、書名・著者・ISBN・出版社・キーワードで検索します。ISBN、著者、出版社、シリーズ、目次、立ち読みURL、定価、レビューを含む書籍詳細を返します。検索条件は少なくとも1つ必須。

Input parameters:

- `author` (string): Author name. 著者名。
- `booksGenreId` (string): Restrict to a specific Books genre (3-character IDs, hierarchical). Use books_genre_search to discover. ジャンルIDで絞り込み(books_genre_search で取得)。
- `hits` (integer): Number of results per page (1–30, default 10). 1ページあたりの取得件数(1〜30、デフォルト10)。
- `isbnjan` (string): ISBN or JAN code. ISBN または JAN コード。
- `keyword` (string): Free-text keyword across all fields. 全フィールド横断のキーワード。
- `page` (integer): Page number (1+, default 1). ページ番号(1以上、デフォルト1)。
- `publisherName` (string): Publisher name. 出版社。
- `sort` (string): Sort order. 並び順。
- `title` (string): Book title (partial match). 書名(部分一致)。

### `books_cd_search` (~312 tokens)

Search Rakuten Books (CDs / Music)

Search Rakuten Books for music CDs by title, artist, label, or JAN code. Returns album/single details including artist, label, JAN, track list, list price, and review stats.

[JA] 楽天ブックスで音楽CDを、タイトル・アーティスト・レーベル・JANで検索します。アーティスト、レーベル、JAN、収録曲、定価、レビューを含む詳細を返します。

Input parameters:

- `artistName` (string): Artist name. アーティスト名。
- `booksGenreId` (string): Restrict to a specific Books genre (3-character IDs, hierarchical). Use books_genre_search to discover. ジャンルIDで絞り込み(books_genre_search で取得)。
- `hits` (integer): Number of results per page (1–30, default 10). 1ページあたりの取得件数(1〜30、デフォルト10)。
- `jan` (string): JAN code. JANコード。
- `keyword` (string): Free-text keyword. キーワード。
- `label` (string): Record label. レーベル。
- `page` (integer): Page number (1+, default 1). ページ番号(1以上、デフォルト1)。
- `sort` (string): Sort order. 並び順。
- `title` (string): Album/single title. アルバム/シングル名。

### `books_dvd_search` (~308 tokens)

Search Rakuten Books (DVDs / Blu-ray)

Search Rakuten Books for DVDs and Blu-ray discs by title, performer, label, or JAN. Returns title details with performer, label, JAN, list price, and review stats.

[JA] 楽天ブックスでDVD・Blu-rayを、タイトル・出演者・レーベル・JANで検索します。出演者、レーベル、JAN、定価、レビューを含む詳細を返します。

Input parameters:

- `artistName` (string): Performer/artist. 出演者/アーティスト。
- `booksGenreId` (string): Restrict to a specific Books genre (3-character IDs, hierarchical). Use books_genre_search to discover. ジャンルIDで絞り込み(books_genre_search で取得)。
- `hits` (integer): Number of results per page (1–30, default 10). 1ページあたりの取得件数(1〜30、デフォルト10)。
- `jan` (string): JAN code. JANコード。
- `keyword` (string): Free-text keyword. キーワード。
- `label` (string): Label/studio. レーベル/スタジオ。
- `page` (integer): Page number (1+, default 1). ページ番号(1以上、デフォルト1)。
- `sort` (string): Sort order. 並び順。
- `title` (string): Title (movie or show). タイトル。

### `books_foreign_book_search` (~286 tokens)

Search Rakuten Books (Foreign-Language Books)

Search Rakuten Books for foreign-language (non-Japanese) books by title, author, ISBN, or publisher. Returns book details plus a Japanese-translated title field when available.

[JA] 楽天ブックスで洋書を、タイトル・著者・ISBN・出版社で検索します。書籍詳細に加え、邦題が存在する場合は japaneseTitle を返します。

Input parameters:

- `author` (string): Author. 著者。
- `booksGenreId` (string): Restrict to a specific Books genre (3-character IDs, hierarchical). Use books_genre_search to discover. ジャンルIDで絞り込み(books_genre_search で取得)。
- `hits` (integer): Number of results per page (1–30, default 10). 1ページあたりの取得件数(1〜30、デフォルト10)。
- `isbn` (string): ISBN. ISBN。
- `keyword` (string): Free-text keyword. キーワード。
- `page` (integer): Page number (1+, default 1). ページ番号(1以上、デフォルト1)。
- `publisherName` (string): Publisher. 出版社。
- `sort` (string): Sort order. 並び順。
- `title` (string): Title (English or other). タイトル。

### `books_magazine_search` (~270 tokens)

Search Rakuten Books (Magazines)

Search Rakuten Books for magazines by title, publisher, or JAN. Returns issue details including publisher, JAN, publication cycle, preview URL, and review stats.

[JA] 楽天ブックスで雑誌を、タイトル・出版社・JANで検索します。出版社、JAN、発行サイクル、立ち読みURL、レビューを含む詳細を返します。

Input parameters:

- `booksGenreId` (string): Restrict to a specific Books genre (3-character IDs, hierarchical). Use books_genre_search to discover. ジャンルIDで絞り込み(books_genre_search で取得)。
- `hits` (integer): Number of results per page (1–30, default 10). 1ページあたりの取得件数(1〜30、デフォルト10)。
- `jan` (string): JAN code. JAN。
- `keyword` (string): Free-text keyword. キーワード。
- `page` (integer): Page number (1+, default 1). ページ番号(1以上、デフォルト1)。
- `publisherName` (string): Publisher. 出版社。
- `sort` (string): Sort order. 並び順。
- `title` (string): Magazine title. 雑誌名。

### `books_game_search` (~314 tokens)

Search Rakuten Books (Video Games)

Search Rakuten Books for video games by title, platform/hardware (e.g., 'Nintendo Switch', 'PlayStation 5'), or JAN. Returns title details with hardware, label, JAN, list price, and review stats.

[JA] 楽天ブックスでビデオゲームを、タイトル・ハード(例: 'Nintendo Switch', 'PlayStation 5')・JANで検索します。ハード、レーベル、JAN、定価、レビューを含む詳細を返します。

Input parameters:

- `booksGenreId` (string): Restrict to a specific Books genre (3-character IDs, hierarchical). Use books_genre_search to discover. ジャンルIDで絞り込み(books_genre_search で取得)。
- `hardware` (string): Platform/hardware (e.g., 'Nintendo Switch'). ハードウェア(例: 'Nintendo Switch')。
- `hits` (integer): Number of results per page (1–30, default 10). 1ページあたりの取得件数(1〜30、デフォルト10)。
- `jan` (string): JAN code. JAN。
- `keyword` (string): Free-text keyword. キーワード。
- `page` (integer): Page number (1+, default 1). ページ番号(1以上、デフォルト1)。
- `sort` (string): Sort order. 並び順。
- `title` (string): Game title. ゲームタイトル。

### `books_software_search` (~306 tokens)

Search Rakuten Books (Computer Software)

Search Rakuten Books for computer software by title, target OS (e.g., 'Windows', 'macOS'), or JAN. Returns software details with target OS, label, JAN, list price, and review stats.

[JA] 楽天ブックスでPCソフトウェアを、タイトル・対応OS(例: 'Windows', 'macOS')・JANで検索します。対応OS、レーベル、JAN、定価、レビューを含む詳細を返します。

Input parameters:

- `booksGenreId` (string): Restrict to a specific Books genre (3-character IDs, hierarchical). Use books_genre_search to discover. ジャンルIDで絞り込み(books_genre_search で取得)。
- `hits` (integer): Number of results per page (1–30, default 10). 1ページあたりの取得件数(1〜30、デフォルト10)。
- `jan` (string): JAN code. JAN。
- `keyword` (string): Free-text keyword. キーワード。
- `os` (string): Target OS (e.g., 'Windows', 'macOS'). 対応OS。
- `page` (integer): Page number (1+, default 1). ページ番号(1以上、デフォルト1)。
- `sort` (string): Sort order. 並び順。
- `title` (string): Software title. ソフトウェア名。

### `books_genre_search` (~190 tokens)

Browse Rakuten Books Genres

Browse the Rakuten Books genre (category) hierarchy. Pass '000' to list top-level genres, or a specific 3-character genre ID to fetch its parents and direct children. Useful for narrowing book searches to a specific category.

[JA] 楽天ブックスのジャンル(カテゴリ)階層を参照します。'000' を渡すとトップレベル、特定の3文字ジャンルIDを渡すと親ジャンルと直下の子ジャンルを取得します。検索の絞り込みに利用できます。

Input parameters:

- `booksGenreId` (string): Books genre ID (e.g., '000' = top, '001' = books, '004' = CD). Three-character codes are hierarchical levels. ジャンルID('000' がトップ、'001' が書籍、'004' がCD)。

### `travel_simple_hotel_search` (~358 tokens)

Search Rakuten Travel Hotels (by Area)

Search Rakuten Travel hotels by area code (japan → prefecture → city → district) or by latitude/longitude coordinates. Returns hotel summaries with prices, addresses, review stats, and ratings. Use travel_get_area_class to discover area codes.

[JA] 楽天トラベルのホテルをエリアコード階層(日本→都道府県→市区町村→詳細)、または緯度経度で検索します。価格、住所、レビュー、評価を含むホテル一覧を返します。エリアコードは travel_get_area_class で取得できます。

Input parameters:

- `detailClassCode` (string): District-level code (e.g., 'A'). 詳細エリア。
- `hits` (integer): Results per page (1–30). 取得件数。
- `largeClassCode` (string): Large area class (e.g., 'japan'). Use travel_get_area_class to discover. 大エリア(例: 'japan')。
- `latitude` (number): Latitude (decimal degrees) for coordinate search. 緯度。
- `longitude` (number): Longitude (decimal degrees) for coordinate search. 経度。
- `middleClassCode` (string): Prefecture-level code (e.g., 'tokyo'). 都道府県。
- `page` (integer): Page number. ページ番号。
- `searchRadius` (number): Search radius in kilometers (0.1–3.0) when using lat/lon. 検索半径(km、0.1〜3.0)。
- `smallClassCode` (string): City-level code (e.g., 'tokyo'). 市区町村。

### `travel_vacant_hotel_search` (~377 tokens)

Search Rakuten Travel Hotels (Available on Dates)

Search Rakuten Travel for hotels with rooms available on specific check-in/check-out dates. Returns each hotel together with its available room plans (plan name, price per night, total price, with-breakfast flag, reserve URL). Same area-code or lat/lon parameters as travel_simple_hotel_search.

[JA] 指定のチェックイン/チェックアウト日に空室がある楽天トラベルのホテルを検索します。各ホテルと利用可能なプラン(プラン名、1泊あたりの価格、合計金額、朝食有無、予約URL)を返します。エリア/座標パラメータは travel_simple_hotel_search と同じ。

Input parameters:

- `adultNum` (integer): Number of adult guests. 大人人数。
- `checkinDate` (string, required): Check-in date (YYYY-MM-DD). チェックイン日(YYYY-MM-DD)。
- `checkoutDate` (string, required): Check-out date (YYYY-MM-DD). チェックアウト日(YYYY-MM-DD)。
- `detailClassCode` (string): District code. 詳細エリア。
- `hits` (integer): Results per page. 取得件数。
- `largeClassCode` (string): Large area class. 大エリア。
- `latitude` (number): Latitude. 緯度。
- `longitude` (number): Longitude. 経度。
- `middleClassCode` (string): Prefecture code. 都道府県。
- `page` (integer): Page number. ページ番号。
- `roomNum` (integer): Number of rooms. 部屋数。
- `searchRadius` (number): Search radius km. 検索半径(km)。
- `smallClassCode` (string): City code. 市区町村。

### `travel_hotel_detail_search` (~124 tokens)

Get Rakuten Travel Hotel Details

Fetch detailed information for a specific Rakuten Travel hotel by its hotelNo. Returns the same Hotel shape as search endpoints but with the per-axis ratings and detail fields populated.

[JA] 特定の楽天トラベルホテルの詳細情報を hotelNo で取得します。検索系と同じ Hotel 形式で、評価軸(サービス/立地/部屋など)や詳細情報も含めて返します。

Input parameters:

- `hotelNo` (integer, required): Hotel number (from search results). ホテル番号(検索結果から取得)。

### `travel_get_area_class` (~112 tokens)

Get Rakuten Travel Area Classification

Get the full Rakuten Travel area-code hierarchy: Japan → prefecture (middle) → city (small) → district (detail). Use the returned codes as largeClassCode/middleClassCode/etc. in the hotel search tools.

[JA] 楽天トラベルのエリアコード階層を取得します(日本→都道府県→市区町村→詳細)。返されたコードを largeClassCode/middleClassCode 等としてホテル検索ツールに渡してください。

### `travel_keyword_hotel_search` (~149 tokens)

Search Rakuten Travel Hotels (by Keyword)

Search Rakuten Travel hotels by free-text keyword (hotel name, area name, landmark). Returns the same Hotel shape as travel_simple_hotel_search. Useful when you don't know the area code.

[JA] 楽天トラベルのホテルをフリーキーワード(ホテル名、エリア名、ランドマーク)で検索します。エリアコードが分からないときに有用です。

Input parameters:

- `hits` (integer): Results per page. 取得件数。
- `keyword` (string, required): Free-text keyword (min 2 characters). フリーキーワード(2文字以上)。
- `page` (integer): Page number. ページ番号。

### `travel_get_hotel_chain_list` (~89 tokens)

Get Rakuten Travel Hotel Chains

List all Rakuten Travel hotel chains (Marriott, APA, Hilton, Toyoko Inn, etc.) with their codes. Useful for filtering or grouping search results by chain.

[JA] 楽天トラベルに登録されている全ホテルチェーン(マリオット、APA、ヒルトン、東横INN等)とコードを返します。

### `travel_hotel_ranking` (~176 tokens)

Get Rakuten Travel Hotel Ranking

Get the top-ranked hotels on Rakuten Travel, overall or by ranking genre (onsen, ryokan, city, resort, businesshotel, pension, publichouse). Returns ranked hotels with rank, name, area, review stats, and information URLs.

[JA] 楽天トラベルのホテルランキングを取得します。'all'(総合)、または温泉/旅館/シティ/リゾート/ビジネス/ペンション/公共の宿でタイプ別に絞り込めます。順位、ホテル名、エリア、レビュー、URLを返します。

Input parameters:

- `genre` (string): Ranking genre. 'all' is overall; others narrow by hotel type. ランキング種別。'all' は総合、他はタイプ別。

### `recipe_category_list` (~243 tokens)

List Rakuten Recipe Categories

Get the full Rakuten Recipe category hierarchy (43 large → ~540 medium → ~1500 small categories). Each category has a categoryId, name, and URL on recipe.rakuten.co.jp. Use 'large' depth when you only need the top-level menu (much smaller payload). Medium and small categories include parentCategoryId for tree assembly.

[JA] 楽天レシピのカテゴリ階層(43大カテゴリ→約540中カテゴリ→約1500小カテゴリ)を取得します。各カテゴリにID、名前、recipe.rakuten.co.jp のURLが付きます。トップレベルだけ必要な場合は 'large' を指定(ペイロード大幅小)。中・小には parentCategoryId が付与されます。

Input parameters:

- `level` (string): Which depth(s) to return. 'all' returns the full tree (~2000 categories, ~430KB). Use 'large' for the 43 top-level categories only. 取得階層。'all' は全階層(約2000カテゴリ、430KB)、'large' はトップレベル43件のみ。

### `recipe_category_ranking` (~176 tokens)

Get Rakuten Recipe Category Ranking

Get the top recipes in a Rakuten Recipe category. Returns ranked recipes with title, ingredient list, cooking time (indication), cost estimate, image URLs, author nickname, and a direct URL to recipe.rakuten.co.jp. Use recipe_category_list to find category IDs.

[JA] 指定カテゴリの楽天レシピ人気ランキングを取得します。順位、タイトル、材料一覧、調理時間目安、費用目安、画像、投稿者ニックネーム、レシピURLを返します。カテゴリIDは recipe_category_list で取得。

Input parameters:

- `categoryId` (string, required): Category ID to rank within. Pass a large/medium/small categoryId from recipe_category_list. ランキング対象のカテゴリID(recipe_category_list の large/medium/small から取得)。

### `kobo_ebook_search` (~274 tokens)

Search Rakuten Kobo eBooks

Search Rakuten Kobo's eBook catalogue by keyword, title, author, publisher, or genre. Returns eBook details with title, series, author, publisher, price, sale URL, language code, image URL, and review stats. Pass at least one search field.

[JA] 楽天Kobo電子書籍カタログを、キーワード/タイトル/著者/出版社/ジャンルで検索します。タイトル、シリーズ、著者、出版社、価格、購入URL、言語、画像、レビューを含む書籍詳細を返します。検索条件は1つ以上必須。

Input parameters:

- `author` (string): Author name. 著者名。
- `hits` (integer): Results per page. 取得件数。
- `keyword` (string): Free-text keyword. キーワード。
- `koboGenreId` (string): Restrict to a Kobo genre ID. Use kobo_genre_search to discover. ジャンルIDで絞り込み。
- `page` (integer): Page number. ページ番号。
- `publisherName` (string): Publisher name. 出版社。
- `sort` (string): Sort order. 並び順。
- `title` (string): Title (partial match). タイトル(部分一致)。

### `kobo_genre_search` (~193 tokens)

Browse Rakuten Kobo Genres

Browse the Rakuten Kobo eBook genre hierarchy. Top-level is '101' (電子書籍). Pass a child genre ID returned by this tool to drill down. Returns the current genre, its ancestors, and its direct children — useful for narrowing kobo_ebook_search results.

[JA] 楽天Koboのジャンル階層を参照します。最上位は '101'(電子書籍)。子IDを渡して掘り下げ可能。現在のジャンル、祖先、子ジャンルを返します。kobo_ebook_search の絞り込みに利用してください。

Input parameters:

- `koboGenreId` (string): Kobo genre ID. Top-level is '101' (電子書籍). Drill down with returned child IDs. ジャンルID。トップは '101'(電子書籍)。子IDで掘り下げ。

### `gora_golf_course_search` (~338 tokens)

Search Rakuten GORA Golf Courses

Search Rakuten GORA golf courses by area code, keyword, or coordinates. Returns each course with name, address, nearest highway IC, distance from IC, evaluation score, image URL, and a direct reservation calendar URL. Use gora_golf_course_detail for full information including plans, course layout, and facilities.

[JA] 楽天GORAのゴルフ場を、エリアコード/キーワード/座標で検索します。コース名、住所、最寄りIC、IC距離、評価、画像、予約カレンダーURLを返します。プラン詳細やコースレイアウト等の全情報は gora_golf_course_detail を使用してください。

Input parameters:

- `areaCode` (string): Area code (e.g. '13' = Tokyo, '14' = Kanagawa, '23' = Aichi). Either areaCode or keyword is required. エリアコード(例: '13' 東京、'14' 神奈川)。areaCode または keyword が必要。
- `hits` (integer): Results per page. 取得件数。
- `keyword` (string): Free-text keyword (course name, location). 検索キーワード(コース名/エリア)。
- `latitude` (number): Latitude. 緯度。
- `longitude` (number): Longitude. 経度。
- `page` (integer): Page number. ページ番号。
- `searchRange` (number): Search radius in km (1–80) when using lat/lon. 検索半径(km、1〜80)。

### `gora_golf_course_detail` (~205 tokens)

Get Rakuten GORA Golf Course Detail

Get full details for a Rakuten GORA golf course by ID — postal address, phone, designer, hole/par count, course distance, green type, dress code, practice/lodging/meal facilities, credit card acceptance, layout map URL, and weekday/holiday base prices. Use this after gora_golf_course_search to drill into a specific course.

[JA] 楽天GORAのゴルフ場詳細をIDで取得します。郵便番号、電話、設計者、ホール数、パー数、コース距離、グリーン種別、ドレスコード、練習場/宿泊/食事/クレジットカード可否、レイアウトURL、平日/休日の基準最安値を返します。

Input parameters:

- `golfCourseId` (integer, required): Golf course ID (from gora_golf_course_search). ゴルフ場ID(検索結果から取得)。

### `gora_plan_search` (~338 tokens)

Search Rakuten GORA Reservation Plans

Search Rakuten GORA for available reservation plans on a specific play date. Returns each golf course together with its available plans (plan name, price per player, base price, cart/caddie/lunch/drink inclusions, start time zone, points). Filter by area code, specific golfCourseId, player count, or budget cap. Use this to compare options across courses before reserving.

[JA] 指定のプレー日における楽天GORAの予約可能プランを検索します。各ゴルフ場と利用可能プラン(プラン名、1人あたりの価格、基準価格、カート/キャディ/昼食/ドリンクの付帯、スタート時間帯、ポイント)を返します。エリアコード、ゴルフ場ID、プレイヤー数、予算で絞り込み可能。

Input parameters:

- `areaCode` (string): Area code (e.g. '13' = Tokyo). エリアコード。
- `budget` (integer): Max budget per player (JPY). 1人あたりの予算上限(円)。
- `golfCourseId` (integer): Restrict to a specific course. 特定のゴルフ場で絞り込み。
- `hits` (integer): Results per page. 取得件数。
- `page` (integer): Page number. ページ番号。
- `playDate` (string, required): Play date (YYYY-MM-DD). プレー日(YYYY-MM-DD)。
- `playerNum` (integer): Number of players (1–4). プレイヤー数。

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/mrslbt-rakuten-mcp/rakuten-mcp#diagnostics

## Score history

- 2026-08-03: 68
- 2026-08-02: 68
- 2026-08-01: 24
- 2026-07-31: 5
- 2026-07-30: 50
- 2026-07-28: 50
- 2026-07-27: 50

## Links

- npm package: https://www.npmjs.com/package/rakuten-mcp
- Socket report: https://socket.dev/npm/package/rakuten-mcp
- Repository: https://github.com/mrslbt/rakuten-mcp
- Changelog RSS feed: https://verifymcp.io/servers/mrslbt-rakuten-mcp/rakuten-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/mrslbt-rakuten-mcp/rakuten-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/mrslbt-rakuten-mcp/rakuten-mcp