Claude Desktop

Integrate RelayRail with Claude Desktop for human-in-the-loop AI assistance.

Prerequisites

  • Claude Desktop installed
  • A RelayRail account with an API key
  • Node.js 18+ installed

Configuration

Edit your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

claude_desktop_config.json
{
  "mcpServers": {
    "relayrail": {
      "command": "npx",
      "args": ["@relayrail/server", "start"],
      "env": {
        "RELAYRAIL_API_KEY": "rr_your_api_key_here"
      }
    }
  }
}

Restart Claude

After saving the configuration, restart Claude Desktop. You should see the RelayRail tools available.

Testing

Try asking Claude to use RelayRail:

"Send me a test notification using RelayRail"

You should receive an SMS within seconds.

Available Tools

Claude will have access to these RelayRail tools:

  • register_agent - Register with RelayRail
  • request_approval - Ask for human approval
  • send_notification - Send one-way messages
  • await_response - Wait for approval response
  • get_pending_commands - Check for commands

Example Prompts

"Ask me for approval before making any file changes"

Claude will use request_approval before editing files

"Notify me when you've completed the task"

Claude will send a notification when done

"Check if I've sent you any commands"

Claude will poll for pending commands