MCPHTTP Endpoints

HTTP Endpoints

REST-style endpoints available alongside JSON-RPC. All endpoints require Authorization: Bearer <token> unless noted.

Authentication

POST /api/mcp/auth/login (no auth required)

{
  "username": "user@email.com",
  "password": "..."
}

Returns an access token for subsequent requests.

Upload

POST /api/mcp/upload

Multipart form-data with fields:

FieldDescription
fileBinary file data
typecoverArt or audio

Returns fileUrl for use in submission payloads.

Draft Snapshot

POST /api/mcp/draft

Save work-in-progress metadata before final submission.

{
  "releaseId": "optional",
  "conversationId": "optional",
  "mode": "delta",
  "release": { ... },
  "tracks": [ ... ],
  "trackPatches": [ ... ],
  "uploadRequests": [ ... ],
  "status": "collecting"
}

Submit Release

POST /api/mcp/submit

{
  "release": { ... },
  "tracks": [ ... ],
  "releaseId": "optional",
  "conversationId": "optional"
}

Rate limited. On 429 response, check retryAfterSeconds.

List Releases

GET /api/mcp/releases?limit=100

Returns the most recent releases for the authenticated user.

Release Metadata

GET /api/mcp/releases/:id/metadata

Returns merged metadata for a release (draft snapshot or latest merged data).

Release Status

GET /api/mcp/releases/:id/status

Returns store and aggregate status information.

Job Status

GET /api/mcp/release-jobs/:id

Returns job processing status and error information.

Protocol & JSON-RPCUploads