Deployments and runtime APIs

Deployment reads

GET /api/v1/deployments
GET /api/v1/deployment
GET /api/v1/deployment/events
GET /api/v1/deployment/health

Request

curl "$MCPFACTORY_BASE_URL/api/v1/deployments?organizationId=<organization-id>&status=active" \
  -H "Authorization: Bearer $MCPFACTORY_API_KEY"

Response

{
  "deployments": [
    {
      "id": "dep_123",
      "serverId": "srv_123",
      "status": "active",
      "runtimeUrl": "https://runtime.mcpcloud.sh/dep_123"
    }
  ]
}

Runtime auth flows

POST /api/v1/runtime/auth/token
POST /oauth/runtime/token

Request

curl -X POST "$MCPFACTORY_BASE_URL/api/v1/runtime/auth/token" \
  -H "Authorization: Bearer $MCPFACTORY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"deploymentId":"<deployment-id>","organizationId":"<organization-id>"}'

Response

{
  "token": "<runtime-token>",
  "expiresAt": "2026-05-28T21:00:00.000Z",
  "deploymentId": "dep_123"
}