Help

Setup guides for Orbit, MCP integration, and repository conventions.

Logged-in users can also open Settings → MCP Server for the same MCP documentation.

Prerequisites

  • Node.js 18+ or Bun
  • An Orbit account with an API token
  • Claude Code, Cursor, or another MCP-compatible client

Step 1: Install the Package

Choose your package manager:

npm install @truelabs/orbit-mcp

or: bun add @truelabs/orbit-mcp

Step 2: Authenticate

Run the login command:

npx orbit-mcp login

This will:

  • • Open your browser to authenticate with Orbit
  • • Save your API token to ~/.orbit/config.json
  • • Display your token for manual configuration

Step 3: Configure MCP Client

Add to .cursor/mcp.json (Cursor) or .claude/mcp.json (Claude Code):

{
  "mcpServers": {
    "orbit": {
      "command": "npx",
      "args": ["-y", "orbit-mcp"]
    }
  }
}

Restart your MCP client after updating the configuration file.

Cursor workflow

  1. Open an agent package in Orbit and click Copy Composer prompt.
  2. Paste into Cursor Composer in the linked repository.
  3. Use Orbit MCP to claim, report progress, and complete with a PR URL.
npx orbit-mcp cursor-session <packageId> --claim

Optional: Auto-claim assignments

Run npx orbit-mcp watch in a terminal to poll for pending packages assigned to you.

Environment Variable Setup (Advanced)

For CI/advanced setups, set the token directly:

export ORBIT_API_TOKEN="your-token-here"