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 devAPI 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
