rms-mcp
The rms-mcp server provides 26 tools for AI agents to manage Rakuten Ichiba operations via the Rakuten RMS API, covering:
Sales & Analysis: Daily sales summaries, product rankings by revenue, and cancellation rates.
Order Management: View order details, list unconfirmed/pending orders, confirm orders, update shipping info, sub-statuses, memos, and cancel orders.
Product Management: Search and list products, create/update products, and change prices.
Inventory Management: Get and update inventory for specific products and variants.
Coupons: Search issued coupons and issue new ones.
Inquiries: View counts, lists, details, and send replies to customer inquiries.
Browser Automation: Post review replies, set RPP ad budgets, check event calendars, and generate R-Mail (newsletter) drafts.
Authentication uses RMS API credentials (service secret and license key), and the server supports both stdio (local) and HTTP (remote) connection modes.
Provides tools for accessing Rakuten RMS data including daily sales summaries, product rankings, order details, and cancel rates.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@rms-mcp show me today's Rakuten sales summary"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
rms-mcp
MCP server for Rakuten RMS API — Sales Dashboard & Order Management
Capabilities
Retrieve Rakuten RMS data from Claude Code (or any MCP client):
Tool | Description |
| Daily sales summary (count, tax, coupons, shipping) |
| Product ranking (quantity, sales, average unit price) |
| Full detail JSON by specifying order number |
| Cancel rate and count |
Related MCP server: Amazon Orders MCP
Setup
git clone https://github.com/yasuhidekoizumi-afk/rms-mcp.git
cd rms-mcp
uv syncAuthentication
Issue serviceSecret and licenseKey from the RMS management screen → API settings.
export RMS_SERVICE_SECRET="SP404839_xxxxxxxxxx"
export RMS_LICENSE_KEY="SL404839_xxxxxxxxxx"Verification
RMS_SERVICE_SECRET="..." RMS_LICENSE_KEY="..." uv run python -c "
from rms_mcp.order_api import OrderAPI
from rms_mcp.client import RMSClient
c = RMSClient('SP...', 'SL...')
api = OrderAPI(c)
r = api.search_orders('2026-05-01T00:00:00+0900','2026-05-08T23:59:59+0900')
print(len(r.get('orderNumberList',[])), '件')
c.close()
"Claude Code Configuration
.mcp.json:
{
"mcpServers": {
"rms-mcp": {
"command": "uv",
"args": ["run", "rms-mcp"],
"cwd": "/path/to/rms-mcp",
"env": {
"RMS_SERVICE_SECRET": "SP404839_xxx",
"RMS_LICENSE_KEY": "SL404839_xxx"
}
}
}
}Quick Reference
Daily sales:
Show me today's Rakuten sales→rms_daily_salesProduct ranking:
What are the top 10 Rakuten items this month?→rms_product_ranking(top_n=10)Cancel rate:
What is this month's cancel rate?→rms_cancel_rateOrder details:
Details for this order→rms_order_detail(order_numbers=[...])
API Coverage
[x] RakutenPayOrderAPI (searchOrder, getOrder)
[x] PurchaseItemAPI (searchOrderItem)
[ ] InventoryAPI
[ ] ProductAPI
[ ] CouponAPI
📖 Installation Manual
For detailed installation steps, please refer to SETUP.md.
License
MIT — ORYZAE Inc.
Available Tools
4 toolsrms_cancel_rateC
Cancellation rate and counts
Inputs: start_date, end_date.
rms_daily_salesB
Daily sales summary (orders, revenue, tax, coupons, delivery)
Inputs: start_date, end_date.
rms_order_detailC
Full order detail by order number(s)
Inputs: order_numbers (required).
rms_product_rankingC
Product sales ranking by revenue (from PackageModelList)
Inputs: start_date, end_date, top_n.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a distinct aspect of RMS data: cancellation rates, daily sales, order details, and product rankings. There is no overlap in functionality, making it easy for an agent to select the correct tool.
All tools follow a consistent pattern: 'rms_' prefix followed by a descriptive noun phrase using underscores (cancel_rate, daily_sales, order_detail, product_ranking). This predictability aids both human and agent understanding.
With 4 tools, this server is well-scoped for a focused analytics/reporting domain. Each tool serves a clear purpose without unnecessary bloat, and the count fits comfortably within the optimal range of 3-15 tools.
The tool set covers key reporting and analytics needs for an RMS: cancellation, sales summary, order details, and product ranking. Minor gaps exist, such as the absence of time-range filtering or trend comparisons, but the core query functionality is present.
Maintenance
Related MCP Connectors
Products, customers, orders, subscriptions, benefits, revenue metrics and refunds.
Read-only Amazon seller analytics: sales, Buy Box, FBA inventory, alerts, revenue and fees.
Read your Cakto sales: orders, revenue analytics, subscriptions, churn, customers and products.
Read-only zobrx e-commerce data: P&L, orders, inventory, marketplace, tax & shelf insights.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables searching and retrieving information from Rakuten services (Ichiba, Books, Travel, Recipe, Kobo, GORA) via the new API endpoints with secure authentication.1MIT
- FlicenseAqualityCmaintenanceEnables importing and querying historical Amazon consumer order data from multiple accounts, with tools for syncing orders, retrieving filtered order details, and managing account sessions.5-
- AlicenseNot gradedqualityDmaintenanceEnables read-only access to retail ERP data through the official output WebService, letting users query products, stock and inventory, customers and suppliers, sales movement and billing, orders, salespeople, and store information with date-window and store filters.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables merchants to generate charts and read-only insights from their food-delivery store inside AI assistant chats, covering sales, payouts, average ticket, fees, menu mix, and ratings through the official API.1MIT