What can you do with this server?

The rakuten-mcp server provides read-only access to Rakuten's e-commerce and travel APIs. All operations are read-only; creating, modifying, or deleting resources is not supported. * Search Products (search_products): Full-text search on Rakuten Ichiba with filters for price range (min/max in yen), sorting options (price, review count, review average, etc.), and pagination. * Get Genre Ranking (get_genre_ranking): Retrieve bestseller rankings overall or filtered by a specific product genre/category. * Search Genres (search_genres): Browse and navigate Rakuten Ichiba's product category hierarchy from the top level or any parent genre. * Search Books (search_books): Search Rakuten Books by title, author, ISBN, or general keyword. * Search Travel Hotels (search_travel): Search for hotels on Rakuten Travel by keyword (e.g., hotel name or area). * Search Travel Vacancy (search_travel_vacancy): Find available hotel rooms by specifying check-in/check-out dates, location (coordinates or hotel number), number of adults, max nightly price, and search radius. * Get Product Reviews (get_product_reviews): Retrieve reviews for a specific Rakuten product using its item code, with sorting by date or rating.

Which integrations are available for this server?

Provides integration with Rakuten Web Service APIs, enabling search across Rakuten Ichiba (products), Rakuten Books, and Rakuten Travel with tools for product search, category browsing, bestseller rankings, hotel availability, and book searches.

de en es ja ko ru zh

rakuten-mcp

by mrslbt

Overview Schema Related Servers Score Discussions

TypeScript

Remote

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. 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.

Related MCP server: rippr

Configuration

Register at Rakuten Web Service.
Create an application. You get a UUID Application ID and a pk_-prefixed Access Key.
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 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 8 classes covering Config / Auth / 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 28 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

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

4wRelease cycle

3Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Tools

View all tools

Related MCP Servers

Mercari MCP Server
E-commerce & Retail Search
purebaba
F
license
-
quality
D
maintenance
An MCP server that enables users to search for products on the Mercari marketplace using keywords, categories, and specific filters like price and condition. It provides comprehensive tools for retrieving item details and browsing search results via standard or SSE protocols.
Last updated 2025-07-21
rippr
RAG Systems Web Scraping
mrslbt
A
license
A
quality
A
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.
Last updated 2026-07-10
1
4
MIT
ai-furniture-hub
E-commerce & Retail Product Management Search
ONE8943
A
license
A
quality
D
maintenance
MCP server for AI agents providing 300 curated Japanese home & lifestyle products across 31 categories. Features mm-precision dimension search, related-item chains (1 product → 3-5 accessories), shelf+storage coordination, and Rakuten/Amazon affiliate links.
Last updated 2026-04-16
15
65
1
MIT
xendit-mcp
Payments & Billing Finance E-commerce & Retail
mrslbt
A
license
A
quality
B
maintenance
MCP server for Xendit payment APIs. Invoices, disbursements, balance checks, and bank transfers across Southeast Asia.
Last updated 2026-07-10
6
232
4
MIT

View all related MCP servers

Related MCP Connectors

1stay
Hotel booking MCP server. Search, book, and manage reservations across 250K+ properties worldwide.
JP Bids MCP
Read-only MCP server for searching Japan government procurement bid information from the KKJ portal.
SUZURI MCP Server
Official remote MCP server for SUZURI.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mrslbt/rakuten-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

rakuten-mcp

Install

Configuration

Claude Desktop

Claude Code

Cursor / Cline / Continue

Tools

Ichiba (5)

Books (9)

Travel (7)

Recipe (2)

Kobo (2)

GORA (3)

Example queries

Architecture

Safety

Disclaimer

License

Maintenance

Resources

Tools

Related MCP Servers

Mercari MCP Server

rippr

ai-furniture-hub

xendit-mcp

Related MCP Connectors

Latest Blog Posts

MCP directory API