Create Auth Session
Identity
Create Auth Session
Create a JIT authentication session for OAuth
POST
Create Auth Session
Create Auth Session
Create a just-in-time (JIT) authentication session. This returns a URL to redirect the user to for OAuth authorization.Request
Body Parameters
Your user’s unique identifier
OAuth provider to authenticate with. Currently supported:
googleResponse
Unique identifier for this auth session - use for polling status
URL to redirect the user to for OAuth authorization
ISO timestamp when this session expires (typically 5 minutes)
Example Response
Flow
- Call this endpoint to get an
auth_url - Redirect user to
auth_url(or open in popup/new tab) - User authorizes in Google
- Google redirects to MCP Rank’s callback
- MCP Rank stores tokens server-side
- Poll
/v1/identity/sessions/{session_id}for completion - Once complete, proxy requests will work
Example Flow
Notes
- Sessions expire after 5 minutes
- After successful auth, tokens are stored server-side (KMS encrypted)
- The same
user_idcan have multiple providers connected