API Reference
Complete REST API documentation for Nexus MCP Orchestrator
Base URL
https://nexus-worker.nandawinartha1.workers.devAuthentication
All API requests require a Bearer token:
Authorization: Bearer YOUR_API_TOKENEndpoints
POST
/api/sessionsCreate a new orchestration session
Request Body:
{
"prompt": "Build a Next.js app with Stripe",
"mcpServers": ["stripe", "github", "vercel"]
}Response:
{
"session_id": "uuid",
"status": "generating_plan",
"plan": { ... }
}GET
/api/sessions/:idGet session status and results
{
"session_id": "uuid",
"status": "completed",
"steps": [ ... ],
"tokens_used": 450
}GET
/api/credentialsList configured MCP server credentials
POST
/api/credentialsSave MCP server credentials (encrypted)
{
"mcpServer": "supabase",
"credentials": {
"url": "https://xxx.supabase.co",
"anon_key": "xxx"
}
}GET
/api/auth/sessionVerify authentication and get user info
Rate Limits
| Tier | Requests/Year |
|---|---|
| Free | 3 |
| Standard | 2,000 |
| Premium | 15,000 |
| Lifetime | 100,000 |
Error Codes
401- Unauthorized (invalid token)402- Payment Required (quota exceeded)404- Session not found429- Rate limit exceeded500- Internal server error