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-mcpOr npx rakuten-mcp on demand.
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"
}
}
}
}
