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 |

---

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