aws-sso-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AWS_SSO_MCP_CONFIG | No | Optional path to the aws-sso-mcp TOML config file. Defaults to ~/.config/aws-sso-mcp/config.toml (or %USERPROFILE%\.config\aws-sso-mcp\config.toml on Windows). |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| orgs_listA | List every org configured in the aws-sso-mcp TOML config. |
| use_orgB | Set the active org for this session (one-off org= overrides still win). |
| current_orgA | Report the currently active org, if any. |
| org_statusB | Report token validity and cache freshness for an org (defaults to the active org). |
| token_statusB | Check cached SSO token validity WITHOUT ever opening a browser. |
| loginA | Authenticate to an org via SSO device authorization (opens a browser for approval). This is the only tool that will ever open a browser. Queries never start a sign-in on your behalf; they fail with a message telling you to call this first, so a browser window never appears unexpectedly mid-query. |
| refresh_accountsA | Force a refresh of the cached account directory for one org, or every configured org. |
| cache_statusA | Report cache freshness for one org, or every configured org. |
| search_accountsB | Search the cached account directory by exact name, substring, or account id. |
| list_rolesC | List the IAM roles granted to you on one account, via that account's SSO portal. |
| explain_role_selectionA | Dry-run deterministic role resolution for one account; makes no service call. Shows exactly which role would be assumed and why - explicit override, TOML environment mapping, or sole granted role - without the model ever choosing a role itself. |
| aws_queryA | Run one AWS API call across every account a selector resolves to. |
| run_dagB | Run a small declarative multi-step query DAG against every resolved account. |
| config_showA | Show the resolved, loaded configuration (it never contains secrets). |
| config_validateA | Re-load and validate the config file, reporting errors without applying them. |
| perf_statsA | Report cache hit/miss counts and executor sizing for the running server. Answers "why was that fan-out slow?" without turning on debug logging. A high credential-broker miss rate points to short-lived sessions or role churn; a high role-cache miss rate suggests the directory TTL is too short. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 16 tools
Most tools have clearly distinct responsibilities, and aws_query versus run_dag is well separated by single-call versus dependent multi-step execution. The main ambiguity is among token_status, cache_status, and org_status, since org_status substantially combines the other two.
All names use readable snake_case, but their structure is inconsistent: list_roles and refresh_accounts are verb-first, while orgs_list, config_show, and config_validate are noun-first. Names such as current_org and perf_stats add further noun-phrase patterns, making the convention only moderately predictable.
Sixteen tools is slightly above the ideal range, and the separate status and diagnostic views add some weight. However, the server covers org and session management, account and role discovery, configuration, query execution, and performance diagnostics, so the count remains reasonable.
The primary workflow is covered end to end, from org selection and authentication through account discovery, deterministic role resolution, and arbitrary AWS operations, with run_dag supporting dependent calls. Minor administrative omissions such as explicit logout/session revocation and cache clearing remain, but they do not block normal discovery and querying.