Skip to content

docs: clarify local vs signing region resolution#343

Open
anasstahr wants to merge 2 commits into
aws:mainfrom
anasstahr:docs/clarify-region-resolution
Open

docs: clarify local vs signing region resolution#343
anasstahr wants to merge 2 commits into
aws:mainfrom
anasstahr:docs/clarify-region-resolution

Conversation

@anasstahr

Copy link
Copy Markdown
Contributor

Summary

  • Adds a callout under the env-vars section explaining that --region / endpoint URL / --metadata AWS_REGION=... set the signing region for the remote MCP server, while the proxy's local boto3 session resolves its own region from the standard provider chain for credential refresh.
  • Tells users hitting NoRegionError at startup (commonly displayed as -32602: Invalid request parameters by MCP clients) — typical of AWS CLI v2 aws login profiles with no persisted region = ... line — to set AWS_REGION in the MCP server's environment block.

Refs aws/agent-toolkit-for-aws#63.

Test plan

  • Render README and confirm the new blockquote sits between the AWS_MCP_PROXY_PROFILES note and the Multi-account access heading.

@anasstahr anasstahr requested a review from a team as a code owner June 26, 2026 15:30
@anasstahr anasstahr force-pushed the docs/clarify-region-resolution branch 5 times, most recently from 2e9edb1 to 243389b Compare June 26, 2026 15:36
Document that --region / endpoint URL / --metadata AWS_REGION control
the signing region for the remote MCP server, while the proxy's local
boto3 session resolves its own region from the standard provider chain
(env or active profile) for credential refresh. Profiles without a
persisted region (common with AWS CLI v2 `aws login`) hit NoRegionError
at startup, which most MCP clients display as `-32602: Invalid request
parameters`.

Refs aws/agent-toolkit-for-aws#63
@anasstahr anasstahr force-pushed the docs/clarify-region-resolution branch from 243389b to 5c89974 Compare June 26, 2026 15:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant