Orbiter Dev MCP Server

Air Traffic Control for your AI Agents. Stop babysitting your terminal, and stop YOLO-ing your codebase.

Overview

The Orbiter Dev MCP (Model Context Protocol) server integrates directly with Claude Code, Cursor, Windsurf, and other MCP-compatible agents. It intercepts risky actions (like deploying to production, modifying databases, or installing packages) and sends them to your phone for explicit biometric approval.

Stop bypassing safety by running --dangerously-skip-permissions. Use Orbiter Dev to auto-approve safe tasks via our Policy Engine, and securely gate destructive commands via your iOS/Android device.

Installation

We recommend using npx so your agents always pull the latest hardened release.

Prerequisites:

• Node.js 18+

Configuration

Configure your AI IDE to use the Orbiter Dev MCP server. Add the following to your MCP configuration file (e.g., in Claude Code, Cursor, or Windsurf):

{
  "mcpServers": {
    "orbiter-dev": {
      "command": "npx",
      "args": ["-y", "@orbiterdev/mcp-server@latest"],
      "env": {
        "ORBITER_SERVER_URL": "https://api.orbiterdev.ai"
      }
    }
  }
}

How It Works

1. Agent Signals: Your AI attempts to execute a risky sequence.
2. Intercept: The Orbiter MCP server pauses the agent and streams a summary/diff to your phone.
3. Approve: You review the risk level on the Orbiter mobile app. Tap "Approve" (with FaceID for critical actions).
4. Resume: The agent picks up exactly where it left off.

Core Capabilities Exposed to Agents

The server exposes the following tools directly to the AI agent:

request_approval

Pauses the agent execution, sends a high-priority push notification containing the action plan, files, and risk analysis to the developer's mobile device, and waits for explicit approval before continuing.

Device Pairing & Authentication

Agents can securely pair your local IDE workspace directly to your Orbiter Dev mobile application using secure short-lived pairing codes, eliminating the need to store static tokens in plain text configurations.

Async Notifications (Hooks)

You can use the Orbiter notifier to send background push updates when your agent completes a long-running process (like dropping a database, running a lengthy test suite, or finishing a build pipeline).

Local Usage:

export ORBITER_TOKEN="your-app-token"
npx @orbiterdev/mcp-server notify --event "Test Suite" --message "Tests passed successfully"

Claude Code Hook Example (.claudecode.json):

{
  "hooks": {
    "PostToolUse": {
      "command": "npx @orbiterdev/mcp-server notify --event 'Tool Execution' --message '{{tool_name}} completed'",
      "async": true
    }
  }
}

Website • Documentation • Support