Server connections

Get a connection request

Changed on

Current state of one connection request. Metered on its own poll budget rather than the shared per-caller one, so polling on a short interval is expected and will not spend the budget your other calls need. A 429 here means the poll interval itself is too fast; honour Retry-After.

get/server-connections/{requestId}

Request

  • Base URL
    https://app.mcpjam.com/api/v1
  • URL
    https://app.mcpjam.com/api/v1/server-connections/{requestId}
  • Auth
    HTTP bearer

Path parameters

requestIdstring required

The scr_… connection request id.

Response

Current state.

connectionRequestIdstring required

Public scr_… identifier. Safe to print; it is never sufficient to act on a request.

status'discovering' | 'awaiting_project' | 'awaiting_authorization' | 'authorizing' | 'validating' | 'ready' | 'failed' | 'expired' | 'cancelled' required
handoffUrlstring

Where the user finishes in a browser, for both awaiting_project and awaiting_authorization. Returned ONLY by the create call — the raw token behind it is minted once and never stored. Treat it as a private, single-person capability: never post it to a shared channel.

expiresAtstring date-time required
projectIdstring
serverIdstring

Changes