auth_start_session
Acquire a session-scoped JWT for user authentication from the backend broker, enabling automatic token usage in subsequent HTTP tool calls during the session.
Instructions
Acquire a session-scoped JWT for email from the backend broker.
After a successful call every HTTP tool call in this session will
automatically use the returned token (unless the tool call provides
its own jwt_token).
Parameters
email: The user whose identity the MCP session will impersonate. reason: Optional free-text description of why this session is needed. Stored in the JWT claims for audit purposes.
Returns
dict
ok=True with email, display_name, user_name,
store on success; ok=False with error on failure.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"email": "<email>"
},
"name": "auth_start_session"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| Yes | |||
| reason | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||