Skip to content

docs(iam-mcp-server): fix stale --readonly flag references - #4349

Open
AmirF194 wants to merge 1 commit into
awslabs:mainfrom
AmirF194:fix/3531-iam-readonly-flag-doc-drift
Open

docs(iam-mcp-server): fix stale --readonly flag references#4349
AmirF194 wants to merge 1 commit into
awslabs:mainfrom
AmirF194:fix/3531-iam-readonly-flag-doc-drift

Conversation

@AmirF194

@AmirF194 AmirF194 commented Jul 26, 2026

Copy link
Copy Markdown

Summary

The IAM MCP server's README still documents the --readonly flag in four places, but PR #2861 (2026-04-09) replaced it with --allow-write and made read-only the default. Following the README literally makes argparse reject the server's own CLI with unrecognized arguments: --readonly (exit 2), so the server never starts.

Fix

Updated the "Read-Only Mode" section to describe the current default: no flag is needed for read-only, and --allow-write opts into write mode. Updated the four --readonly references (CLI examples, Kiro config, other-clients note) accordingly.

Verification

Confirmed on current HEAD, in a clean python:3.12-slim container with the package installed via pip install -e .:

  • python -m awslabs.iam_mcp_server.server --readonlyerror: unrecognized arguments: --readonly, exit 2.
  • python -m awslabs.iam_mcp_server.server --allow-write → starts and logs "Server started in WRITE mode".

This is a documentation-only change; no server code was touched, so no test changes are needed.

Fixes #3531

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of the project license.

PR awslabs#2861 replaced --readonly with --allow-write and made read-only
the default, but the README's Read-Only Mode section was never
updated. Following it literally makes argparse reject the flag with
exit 2, so the server never starts.

Fixes awslabs#3531
@AmirF194
AmirF194 requested review from a team as code owners July 26, 2026 09:15
Copilot AI review requested due to automatic review settings July 26, 2026 09:15

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@AmirF194

AmirF194 commented Aug 2, 2026

Copy link
Copy Markdown
Author

Gentle bump, no rush. Let me know if the PR body's contributor statement needs anything else, that was the one check that needed a fix on our side and it's already addressed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: To triage

Development

Successfully merging this pull request may close these issues.

iam-mcp-server: --readonly flag doesn't exist

2 participants