Skip to main content
Glama

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

rms_daily_sales

Daily sales summary (count, tax, coupons, shipping)

rms_product_ranking

Product ranking (quantity, sales, average unit price)

rms_order_detail

Full detail JSON by specifying order number

rms_cancel_rate

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 sync

Authentication

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_sales

  • Product 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_rate

  • Order 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 tools
rms_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

    A3.5/5.0

    Scored across 4 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables searching and retrieving information from Rakuten services (Ichiba, Books, Travel, Recipe, Kobo, GORA) via the new API endpoints with secure authentication.
      1
      MIT
    • F
      license
      A
      quality
      C
      maintenance
      Enables 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
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      1
      MIT