Skip to main content
POST
Retry validation

Authorizations

Authorization
string
header
required

MCPJam API key (sk_…). Create one at Settings → API keys. Guest sessions cannot use the API, and API keys cannot manage other API keys.

Path Parameters

requestId
string
required

The scr_… connection request id.

Body

application/json

Accepts an empty JSON object.

The body is of type object.

Response

Validation re-armed.

The state of one "connect this MCP server" request. Every server-connection route returns this shape, so a caller polls exactly what it created.

connectionRequestId
string
required

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

status
enum<string>
required
Available options:
discovering,
awaiting_project,
awaiting_authorization,
authorizing,
validating,
ready,
failed,
expired,
cancelled
expiresAt
string<date-time>
required
handoffUrl
string

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.

projectId
string
serverId
string
server
object
error
object