Skip to main content

API Reference

Complete REST API documentation for Nexus MCP Orchestrator

Base URL

https://nexus-worker.nandawinartha1.workers.dev

Authentication

All API requests require a Bearer token:

Authorization: Bearer YOUR_API_TOKEN

Endpoints

POST/api/sessions

Create 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/:id

Get session status and results

{ "session_id": "uuid", "status": "completed", "steps": [ ... ], "tokens_used": 450 }
GET/api/credentials

List configured MCP server credentials

POST/api/credentials

Save MCP server credentials (encrypted)

{ "mcpServer": "supabase", "credentials": { "url": "https://xxx.supabase.co", "anon_key": "xxx" } }
GET/api/auth/session

Verify authentication and get user info

Rate Limits

TierRequests/Year
Free3
Standard2,000
Premium15,000
Lifetime100,000

Error Codes

  • 401 - Unauthorized (invalid token)
  • 402 - Payment Required (quota exceeded)
  • 404 - Session not found
  • 429 - Rate limit exceeded
  • 500 - Internal server error