aws_login_start
Starts an AWS SSO device-code login without opening a browser and returns a verification URL and code for the user to authenticate; call aws_login_complete afterward to confirm.
Instructions
Start an AWS SSO login via the device-code flow (no browser spawned from this process). Returns a verification URL and short code -- surface these to the user so they can open the URL in their own browser and paste the code. After they auth, call aws_login_complete with the returned sessionId to confirm completion. For a user with NO profile yet, pass ssoSession plus startUrl and ssoRegion instead of profile: this writes a managed [sso-session] block to the AWS config file (never touching one the user wrote) and logs in to IAM Identity Center directly; then use aws_sso_list_assignments and aws_sso_generate_profiles.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "aws_login_start"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| profile | No | AWS profile configured for SSO. Defaults to $AWS_PROFILE or 'default'. Mutually exclusive with ssoSession. | |
| startUrl | No | Identity Center start URL (https://...). Only with ssoSession. | |
| ssoRegion | No | Region of the Identity Center instance, e.g. us-east-1. Only with ssoSession. | |
| ssoSession | No | Log in to an IAM Identity Center sso-session directly, without any profile. Use with startUrl + ssoRegion to create the [sso-session] block on first use; omit them to log in to an existing block. |