Role Designer + Vibe coder
Stack TypeScript · MCP · Rakuten API
Year 2026
Ship npm · Open source

I wanted to see what it takes to wrap a real Japanese production API end-to-end, not a toy one. Rakuten was the obvious candidate: I live in Japan, the Web Service API is stable and well documented, and no clean MCP wrapper existed for it.

The server exposes seven read-only tools across the three Rakuten surfaces I actually use as a customer: Ichiba for products, Travel for hotels, Books for catalog search.

Ichiba

Product search with price filters and sorting. Category browsing. Genre rankings. Product reviews.

Travel

Hotel search by keyword. Vacancy search with date, price, and location filters.

Books

Search by title, author, or ISBN.

01

Read-only

Every tool is a search. Nothing creates, modifies, or deletes. An agent with a prompt-injection problem should not be able to buy something on my behalf, so I made sure that the surface area where that could happen does not exist.

02

Depth over breadth

Rakuten publishes thirty-something endpoints. I wrapped three: Ichiba, Travel, Books. Together they cover three distinct query shapes worth learning. Keyword search with pagination. Date-range availability. ISBN lookup. Anything more would have been padding.

03

Unofficial, and honest about it

Not affiliated with Rakuten Group. The README says so at the top, MIT licensed as well. This is a respectful wrapper around a documented public API.

Open source on GitHub. Published on npm. One command install with npx rakuten-mcp.

npm · rakuten-mcp GitHub
Learning an API surface by wrapping it into callable tools forces you to read the docs in a way that casual use does not. The exercise is the value. That the server now quietly serves a few hundred downloads a month is a bonus, not the point.
Next The Seer