Skip to main content
Glama

rakuten-mcp

npm version npm downloads rakuten-mcp MCP server MCP Badge License: MIT

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

npm install -g rakuten-mcp

Or npx rakuten-mcp on demand.

Related MCP server: xendit-mcp

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:

{
  "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 (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).

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 registered on Rakuten Travel.

travel_hotel_ranking

Top hotels by ranking genre (all / onsen / ryokan / city / resort / business / pension / publichouse).

Recipe (2)

Tool

What it does

recipe_category_list

The full Rakuten Recipe category tree (43 large → ~540 medium → ~1500 small). Pass level to fetch one tier.

recipe_category_ranking

Top recipes in a category with title, ingredient list, prep time, cost estimate, image, and author.

Kobo (2)

Tool

What it does

kobo_ebook_search

Search Rakuten Kobo's eBook catalogue. Returns title, series, author, publisher, language code, price, and sale URL.

kobo_genre_search

Browse the Kobo genre tree. Top-level is 101 (電子書籍).

GORA (3)

Tool

What it does

gora_golf_course_search

Golf courses by area code, keyword, or coordinates.

gora_golf_course_detail

Full course profile: designer, hole/par, course distance, green type, dress code, facilities, base prices.

gora_plan_search

Reservation plans on a specific play date. Returns per-plan prices, cart/caddie/lunch inclusions, player-count constraints.

Example queries

楽天で1万円以下のワイヤレスイヤホンを探して。レビュー4以上。
村上春樹の楽天Kobo電子書籍を新着順で。
東京駅近くのホテル、7月1〜2日、2名で1泊1万5千円以下の空室。
今週末東京近郊のゴルフ場で安いプランは?
楽天レシピで人気の鶏胸肉料理を5件、材料と所要時間込みで。
JANコード 4988601009447 のCDの取扱店舗。

Architecture

Modular: one file per API family under src/tools/. Stdio and HTTP transports both supported. Typed error tree with 9 classes covering Config / Auth / IpNotAllowed / RateLimit / Server / NotFound / BadRequest / MalformedResponse / Unknown. Retry-with-backoff on 429 and 5xx, parses Retry-After as both seconds and HTTP-date. See AGENTS.md for the architecture brief, conventions, and how to add a new tool.

Safety

All 27 tools are read-only HTTP GETs against the Rakuten Web Service API. No tool creates, modifies, or deletes anything. Rakuten's terms of service and rate limits apply. Returned items are promotional listings — verify prices and availability on Rakuten before acting on them.

Disclaimer

Unofficial. Not affiliated with, endorsed by, or sponsored by Rakuten Group, Inc. Rakuten, Rakuten Ichiba, Rakuten Books, Rakuten Travel, Rakuten Recipe, Rakuten Kobo, and Rakuten GORA are trademarks of Rakuten Group, Inc. Use at your own risk.

License

MIT

Available Tools

27 tools
gora_golf_course_detailGet Rakuten GORA Golf Course DetailA
Read-onlyIdempotent

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、平日/休日の基準最安値を返します。

Inputs: golfCourseId (required).

ichiba_item_rankingGet Rakuten Ichiba Bestseller RankingA
Read-onlyIdempotent

Get the Rakuten Ichiba realtime bestseller ranking: overall, for one genre, or for an age/gender demographic. Genre and demographic filters are mutually exclusive (Rakuten restriction). Returns ranked items with their rank, price, review stats, and purchase URL. Use ichiba_genre_search to find genre IDs.

[JA] 楽天市場のリアルタイム売れ筋ランキングを取得します。総合、ジャンル別、または年代/性別で絞り込み可能。ジャンルと年代/性別は併用できません(楽天の仕様)。順位、価格、レビュー、購入URLを含むランキング一覧を返します。ジャンルIDの検索には ichiba_genre_search を使用してください。

Inputs: age, sex, page, genre_id.

recipe_category_listList Rakuten Recipe CategoriesA
Read-onlyIdempotent

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 が付与されます。

Inputs: level.

recipe_category_rankingGet Rakuten Recipe Category RankingA
Read-onlyIdempotent

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 で取得。

Inputs: categoryId (required).

travel_get_area_classGet Rakuten Travel Area ClassificationA
Read-onlyIdempotent

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 等としてホテル検索ツールに渡してください。

Inputs: no named parameters.

travel_get_hotel_chain_listGet Rakuten Travel Hotel ChainsA
Read-onlyIdempotent

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等)とコードを返します。

Inputs: no named parameters.

travel_hotel_rankingGet Rakuten Travel Hotel RankingA
Read-onlyIdempotent

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を返します。

Inputs: genre.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 27 tools

    Disambiguation5/5

    Each tool targets a distinct service and resource-action combination (e.g., books_book_search vs books_cd_search, travel_simple_hotel_search vs travel_keyword_hotel_search). Overlaps like books_total_search vs category-specific searches and ichiba_item_search vs ichiba_product_search are explicitly differentiated in descriptions, leaving no real ambiguity.

    Naming Consistency4/5

    Names follow a consistent service_resource_action pattern in snake_case (books_, gora_, ichiba_, travel_, recipe_, kobo_). Minor deviation: two travel tools use a get_ verb prefix (travel_get_area_class, travel_get_hotel_chain_list) while others use trailing action nouns like _search, _detail, or _ranking.

    Tool Count4/5

    27 tools is above the typical 3–15 range, but the server aggregates six distinct Rakuten services (Books, Ichiba, Travel, Recipe, Kobo, GORA), each with multiple endpoints. Each tool maps to a unique operation, so the count is justified despite being slightly heavy.

    Completeness4/5

    Most services have thorough coverage: Books offers total and category-specific searches, Travel has multiple search modes plus detail/area/chain/ranking tools, and Ichiba includes search, genre, ranking, and price comparison. Notable gaps: Recipe only has category listing and ranking (no keyword or ingredient search), and Ichiba lacks a dedicated shop search tool.

    Maintenance

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Extract YouTube transcripts for AI agents, RAG pipelines, and LLM workflows. Supports any YouTube URL. Returns clean text or timestamped segments. No API keys required.
      1
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A MCP server for Walmart Marketplace and Affiliate APIs, enabling sellers to manage items, inventory, prices, and orders, and consumers to search, lookup products, reviews, and store locations.
      24 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server for Rakuten Ichiba that enhances product search with quantity parsing, unit price calculation, and shipping cost analysis, enabling cost-effective bulk purchasing decisions.
      5
      1
      MIT