orbit-api
MCP server for cross-chain bridging, enabling AI agents to find routes, estimate costs, check risks, execute transfers, and track status across blockchains.
README
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
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.