SSyncDev

Ruby Native MCP Server

Lets a coding agent check native signals in a Rails app, track App Store progress and stage store submissions.

Local server

What is the Ruby Native MCP Server?

A typo in a native attribute fails silently. The phone app ignores a data-native-* attribute it does not recognise, so a misspelling renders nothing and logs nothing until someone notices the missing button. The Ruby Native MCP server exists largely to catch that class of mistake before it ships.

Background

Ruby Native turns a Rails app into iOS and Android apps. The ruby_native gem is the Rails side: view helpers, a config/ruby_native.yml file, an engine mounted at /native, and a CLI. Builds happen in the cloud, without Xcode or Android Studio. Running ruby_native mcp starts a stdio MCP server inside your project.

Tools that stay on your machine

Three tools answer from the working copy, with no account:

  • check_views finds misspelled, duplicated or too-new signals in templates (it needs the herb gem).
  • lookup_signals lists every data-native-* attribute, the gem version it requires and the helper that emits it.
  • validate_config reports what in the YAML the apps would reject or quietly ignore.

Tools that read your account

Four more use the token stored by ruby_native login: status (progress toward the App Store and what blocks it), config_errors (decode failures real devices reported in the last 48 hours), deployed_builds and build_status. Pairing them is the useful part: validate_config predicts a failure, config_errors confirms it happened.

A further set stages store work: permissions_set, testers_add, icon_set, screenshots_setup, screenshots_capture, listing_push, listing_pull and demo_account_set. Only submit reaches Apple directly, and it needs two calls with a token in between, so the agent must show you what is being sent. withdraw pulls a submission back before approval.

Getting it running

Add gem "ruby_native", run rails generate ruby_native:install, then bundle exec ruby_native mcp install, which registers the server in the project's .mcp.json for Claude Code. A Claude Code plugin is also available, and JSON-config clients can launch bundle exec ruby_native mcp.

Costs and limits

Phone preview is free and needs no account. Publishing is a paid plan per app, indicatively $199 a month or $1,990 a year; confirm current pricing on your own account. Apple still requires a few manual clicks the agent cannot make. Everything beyond the first three tools sends your CLI token to Ruby Native's service. For related tooling, see the GitHub server or other developer tools.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
check_viewsFinds misspelled, duplicated or too-new native signals in templates.
lookup_signalsLists every data-native attribute, the gem version it needs and the helper that emits it.
validate_configReports what in config/ruby_native.yml the apps reject or ignore.
statusShows where the app stands on the way to the App Store and what is blocking it.
config_errorsLists decode failures reported by real devices in the last 48 hours.
deployed_buildsShows the installable build and which signals it is too old to understand.
build_statusReports whether a build succeeded, and its error if not.
permissions_setStages app permissions, matching the CLI command.
testers_addAdds testers, matching the CLI command.
icon_setSets the app icon, matching the CLI command.
screenshots_setupPrepares store screenshot capture.
screenshots_captureCaptures store screenshots.
listing_pushPushes the store listing.
listing_pullPulls the store listing.
demo_account_setSets the demo account for app review.
submitSubmits to Apple in two calls with a token in between, so the user sees what is sent.
withdrawWithdraws a submission from the review queue before approval.

How to install the Ruby Native MCP Server

{
  "mcpServers": {
    "ruby-native": {
      "command": "bundle",
      "args": [
        "exec",
        "ruby_native",
        "mcp"
      ]
    }
  }
}

Requires the ruby_native gem in the Rails app's Gemfile, since the server runs through bundle exec. Account tools use the login stored by ruby_native login.

Frequently asked questions

Not for check_views, lookup_signals and validate_config, which work from your working copy. The account tools use the token saved by ruby_native login.