Skip to main content
Glama
Orbit-bridge

orbit-api

Official
by Orbit-bridge

orbit-api

The control tower of Orbit — REST API, MCP server, and orchestration layer.

orbit-api is the public face of Orbit. It connects frontends, AI agents (via MCP), and third-party integrations to orbit-core (intelligence) and orbit-executor (execution).


What it exposes

REST API

Method

Endpoint

Description

GET

/routes?from=&to=&asset=&amount=

Find best routes (quick GET)

POST

/quote

Find and rank routes (full body)

POST

/execute

Execute a route

GET

/status/:id

Track a transfer

GET

/health

Health check

MCP tools (for Claude, Cursor, VSCode)

Tool

Description

find_best_route

Discovers and ranks cross-chain routes

estimate_bridge_cost

Returns cost breakdown for a transfer

check_bridge_risk

Safety and risk score for a route

execute_transfer

Initiates a bridge execution

check_transfer_status

Live status of an in-flight transfer


Related MCP server: bridge-rates-mcp

Quick start

npm install
cp .env.example .env
npm run dev

API runs on http://localhost:3000.


MCP setup (Claude Desktop / Cursor)

Add to your MCP config:

{
  "mcpServers": {
    "orbit": {
      "command": "node",
      "args": ["path/to/orbit-api/dist/index.js"],
      "env": { "MCP_MODE": "stdio" }
    }
  }
}

Then ask Claude:

"Find the cheapest route to send 500 USDC from Base to Stellar"


Quote example

curl -X POST http://localhost:3000/quote \
  -H 'Content-Type: application/json' \
  -d '{
    "fromChain": "base",
    "toChain":   "stellar",
    "fromAsset": "USDC",
    "toAsset":   "USDC",
    "amount":    "500"
  }'

Environment variables

PORT=3000
MCP_MODE=          # set to "stdio" to run as MCP server

Architecture

orbit-api           ← you are here
├── calls orbit-core    for route intelligence
└── calls orbit-executor for execution

Related MCP Connectors

Related MCP Servers