Log inSubmit server
Rakuten MCP logo

Rakuten MCP

by mrslbt

Search Rakuten products, books, hotels, recipes, eBooks, and golf services through read-only MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Rakuten MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "mrslbt-rakuten-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "rakuten-mcp"
      ],
      "env": {
        "RAKUTEN_APP_ID": "YOUR_VALUE_HERE",
        "RAKUTEN_ACCESS_KEY": "YOUR_VALUE_HERE",
        "RAKUTEN_AFFILIATE_ID": "YOUR_VALUE_HERE",
        "RAKUTEN_MAX_RETRIES": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 28 tools correctly (1mo ago).

Overview

mrslbt/rakuten-mcp MCP server exposes Rakuten Web Service APIs through 28 read-only MCP tools. It covers Rakuten Ichiba, Books, Travel, Recipe, Kobo, and GORA, with search, category browsing, rankings, hotel availability, recipe rankings, and golf reservation-plan lookup. Running it requires a Rakuten application ID and access key, supplied through environment variables, and it communicates with MCP clients over stdio or HTTP. Reach for it when an agent needs Japanese Rakuten catalogue, travel, recipe, eBook, or golf data without creating or modifying records.

Use cases

  • Search Japanese marketplace products by price, genre, shop, or review metrics
  • Compare prices for the same product across Rakuten sellers
  • Find hotels with dated availability and booking plans
  • Browse popular recipes by category
  • Compare golf courses and reservation plans for a play date

Key features

  • 28 read-only Rakuten API tools
  • Ichiba product search, filtering, rankings, and price comparison
  • Rakuten Books and Kobo catalogue search
  • Hotel, golf, and recipe discovery tools
  • Category and area hierarchy browsing
  • Retry handling for rate limits and server errors

Tools28

What Rakuten MCP lets your agent do. Expand a tool for its parameters.

Verified live~8.4k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

5/5 checks healthy over the last 80d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · rakuten-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars6Stargazers on the source repository.
npm downloads548Package downloads in the last 30 days.
Last commit25d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed28Callable tools this server registers over MCP.
Directory activity6 viewsConfig copies, upvotes, and views on AllMCPs.

How Rakuten MCP works

What mrslbt/rakuten-mcp MCP server does

mrslbt/rakuten-mcp MCP server connects MCP-compatible agents to the Rakuten Web Service API. Its 28 read-only tools cover six product families: Rakuten Ichiba marketplace, Rakuten Books, Rakuten Travel, Rakuten Recipe, Rakuten Kobo, and Rakuten GORA.

The server supports product discovery, catalogue lookup, category exploration, rankings, price comparison, hotel searches, recipe rankings, eBook searches, and golf-course or reservation-plan searches. Responses can include prices, review information, images, addresses, availability, direct product or booking URLs, and service-specific metadata. The tools perform HTTP GET requests only; they do not create, update, or delete Rakuten data.

How it works

The MCP process accepts tool calls from an agent and forwards them to the corresponding Rakuten API endpoint. Each API family is organized separately, and tool descriptions are provided in English and Japanese.

For multi-step searches, use the hierarchy tools first. For example, ichiba_genre_search can provide a genre ID for marketplace searches, books_genre_search narrows Rakuten Books queries, travel_get_area_class supplies hotel area codes, and recipe_category_list supplies recipe category IDs. Kobo and GORA also provide dedicated discovery tools for genres and golf courses.

The server includes retry handling for HTTP 429 and 5xx responses, including support for Retry-After, and exposes typed errors for configuration, authentication, rate limits, server responses, missing resources, malformed responses, and other failures.

Setup and configuration

Install the published npm package with npx -y rakuten-mcp, or install it globally with npm. A Rakuten Web Service application is required. Registration provides an application ID and an access key; both must be available to the process.

Required environment variables are:

  • RAKUTEN_APP_ID: the application ID, documented as a UUID on Rakuten's newer platform.
  • RAKUTEN_ACCESS_KEY: the access key, documented as beginning with pk_.

RAKUTEN_AFFILIATE_ID is optional and adds an affiliate ID to item URLs. RAKUTEN_MAX_RETRIES optionally changes the retry count; the documented default is 3. The README provides MCP configuration examples for Claude Desktop, Claude Code, Cursor, Cline, and Continue. HTTP and stdio transports are supported.

Tools and capabilities

The tool groups provide these capabilities:

  • Search Ichiba items, compare cross-seller product prices, inspect genres and tags, and retrieve bestseller rankings.
  • Search Books across categories or target printed books, CDs, DVDs, foreign-language books, magazines, games, and software.
  • Find hotels by area, coordinates, or keywords; check dated availability; inspect hotel details, chains, and rankings.
  • Browse Recipe categories and retrieve popular recipes with ingredients, estimated time, cost, images, and author information.
  • Search Kobo eBooks and navigate its genre hierarchy.
  • Find GORA golf courses, inspect course details, and compare date-specific plans by area, course, player count, or budget.

Limitations and notes

Results come from Rakuten's APIs and remain subject to Rakuten terms of service and rate limits. Product and booking responses are promotional listings, so prices and availability should be verified on Rakuten before taking action. mrslbt/rakuten-mcp MCP server is unofficial and is not affiliated with or endorsed by Rakuten Group. Access credentials are required, and the material does not describe the API as paid or provide guaranteed availability for any listing.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Rakuten MCP

Run `npx -y rakuten-mcp`, or install it globally with `npm install -g rakuten-mcp`.

Set `RAKUTEN_APP_ID` and `RAKUTEN_ACCESS_KEY`.

Yes. The README provides a Claude Desktop configuration using the `npx -y rakuten-mcp` command and the two required Rakuten environment variables.

No. All 28 tools are read-only HTTP GET operations. They return hotel and reservation-plan information but do not create, modify, or delete anything.

Related MCP servers

All in E-Commerce All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewRakuten MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/mrslbt-rakuten-mcp?style=directory)](https://allmcps.com/mcp/mrslbt-rakuten-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/mrslbt-rakuten-mcp"><img src="https://allmcps.com/api/badge/mrslbt-rakuten-mcp?style=directory" alt="Rakuten MCP on AllMCPs" /></a>