RuStore MCP Server

MCP server for managing app publishing on RuStore (Android app store). Provides 34 tools: APK/AAB uploads, icon and screenshot management, version control, moderation, reviews, payments, subscriptions, access control, and product catalog.

Status

Warning

The package is not yet published to PyPI. Only local installation is available at this time.

Prerequisites

• Python 3.11+
• RuStore Console API key (keyId + Base64-encoded private key)

Local Installation

Windows (PowerShell)

git clone https://github.com/eustatos/RuStoreMcp.git
cd RuStoreMcp
python -m venv .venv
.venv\Scripts\activate
pip install -e ".[dev]"

Windows (CMD)

git clone https://github.com/eustatos/RuStoreMcp.git
cd RuStoreMcp
python -m venv .venv
.venv\Scripts\activate.bat
pip install -e ".[dev]"

macOS / Linux

git clone https://github.com/eustatos/RuStoreMcp.git
cd RuStoreMcp
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

After installation, the rustore-mcp executable (rustore-mcp.exe on Windows) is available inside the virtual environment at:

Platform	Path
Windows	.venv\Scripts\rustore-mcp.exe
macOS	.venv/bin/rustore-mcp
Linux	.venv/bin/rustore-mcp

Configuration

Create a .env file in the project root based on .env.example:

RUSTORE_KEY_ID=your_key_id
RUSTORE_PRIVATE_KEY=your_base64_private_key
RUSTORE_PACKAGE_NAME=com.example.app  # optional

• RUSTORE_KEY_ID — key identifier from RuStore Console
• RUSTORE_PRIVATE_KEY — Base64-encoded private key
• RUSTORE_PACKAGE_NAME — default package name (can be overridden per-request)

Usage

Direct execution

# Windows
.venv\Scripts\rustore-mcp.exe

# macOS / Linux
.venv/bin/rustore-mcp

Claude Desktop integration

Add to your Claude Desktop configuration (claude_desktop_config.json):

Windows:

{
  "mcpServers": {
    "rustore": {
      "command": "C:\\Users\\<user>\\path\\to\\RuStoreMcp\\.venv\\Scripts\\rustore-mcp.exe",
      "env": {
        "RUSTORE_KEY_ID": "your_key_id_here",
        "RUSTORE_PRIVATE_KEY": "your_base64_private_key_here",
        "RUSTORE_PACKAGE_NAME": "com.example.app"
      }
    }
  }
}

macOS / Linux:

{
  "mcpServers": {
    "rustore": {
      "command": "/path/to/RuStoreMcp/.venv/bin/rustore-mcp",
      "env": {
        "RUSTORE_KEY_ID": "your_key_id_here",
        "RUSTORE_PRIVATE_KEY": "your_base64_private_key_here",
        "RUSTORE_PACKAGE_NAME": "com.example.app"
      }
    }
  }
}

Logging

Log level is controlled via the RUSTORE_LOG_LEVEL environment variable:

# Windows (CMD)
set RUSTORE_LOG_LEVEL=DEBUG
.venv\Scripts\rustore-mcp.exe

# macOS / Linux
RUSTORE_LOG_LEVEL=DEBUG .venv/bin/rustore-mcp

Supported values: DEBUG, INFO, WARNING, ERROR, CRITICAL. Default: INFO.

Available Tools (34)

Publishing

Tool	Description
get_app_list	List applications
create_draft_version	Create a draft version
get_version_status	Get version status
upload_apk	Upload APK file
upload_aab	Upload AAB file
upload_icon	Upload app icon
upload_screenshot	Upload screenshot
delete_draft	Delete a draft version
change_publish_settings	Update publish settings
commit_to_moderation	Submit for moderation
publish_version	Publish a version
archive_version	Archive a version

Reviews & Rating

Tool	Description
get_feedback_list	List reviews
get_feedback_csv	Export reviews as CSV
answer_feedback	Reply to a review
get_answer_status	Get reply status
get_answers_statuses	Get reply statuses in bulk
change_answer	Edit a reply
delete_answer	Delete a reply
get_app_rating	Get app rating stats

Payments

Tool	Description
get_payment_info	Get payment details
refund_payment	Refund a payment
get_invoices_by_date	Get invoices by date range
confirm_purchase	Confirm a purchase
cancel_purchase	Cancel a purchase
get_user_purchases	Get user purchases

Subscriptions

Tool	Description
get_subscription_info	Get subscription details
cancel_subscription	Cancel a subscription
approve_subscription	Approve a subscription

Access & Catalog

Tool	Description
get_access_list	List access grants
grant_access	Grant access to a user
revoke_access	Revoke access from a user
get_catalog_products	List catalog products
get_catalog_subscriptions	List catalog subscriptions

Development

# Install dev dependencies
pip install -e ".[dev]"

# Run all tests
pytest -v

# Run tests with coverage
pytest -v --cov=rustore_mcp --cov-report=term-missing

# Type checking
mypy rustore_mcp/

# Run a single test file
pytest tests/test_auth.py -v

License

MIT