Skip to content

fix(deploy-on-aws): shorten MCP server names for Bedrock 64-char limit#133

Open
Sagargupta16 wants to merge 2 commits intoawslabs:mainfrom
Sagargupta16:fix/shorten-mcp-server-names
Open

fix(deploy-on-aws): shorten MCP server names for Bedrock 64-char limit#133
Sagargupta16 wants to merge 2 commits intoawslabs:mainfrom
Sagargupta16:fix/shorten-mcp-server-names

Conversation

@Sagargupta16
Copy link
Copy Markdown
Contributor

@Sagargupta16 Sagargupta16 commented Apr 15, 2026

Summary

  • Rename MCP server keys: awsiac -> iac, awsknowledge -> knowledge, awspricing -> pricing
  • Prevents ValidationException when using the plugin through AWS Bedrock's Converse API

Problem

Claude Code constructs MCP tool names as mcp__plugin_<plugin-name>_<server-name>__<tool-name>. With the old server names, the prefix alone was 40+ characters, causing several tool names to exceed Bedrock's 64-character toolSpec.name limit:

mcp__plugin_deploy-on-aws_awsknowledge__get_regional_availability  (69 chars)
mcp__plugin_deploy-on-aws_awsknowledge__search_documentation       (65 chars)

Fix

Shortened server keys by dropping the aws prefix (redundant since the plugin is already called deploy-on-aws):

Before After Savings
awsiac iac 3 chars
awsknowledge knowledge 3 chars
awspricing pricing 3 chars

After: mcp__plugin_deploy-on-aws_knowledge__get_regional_availability (63 chars)

Updated all references in .mcp.json, README.md, SKILL.md, and reference docs.

Related

Fixes #131

Changes

Renamed MCP server keys in .mcp.json and updated all documentation references across README.md, SKILL.md, and reference files.

Acknowledgment

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

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Updates the deploy-on-aws plugin’s MCP server keys to shorter names to avoid exceeding AWS Bedrock Converse API’s 64-character toolSpec.name limit.

Changes:

  • Renamed MCP server keys in deploy-on-aws from awsiac/awsknowledge/awspricing to iac/knowledge/pricing.
  • Updated plugin documentation and skill reference docs to use the new MCP server names.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
plugins/deploy-on-aws/.mcp.json Renames MCP server keys to shorter identifiers.
plugins/deploy-on-aws/README.md Updates MCP server names in plugin documentation.
plugins/deploy-on-aws/skills/deploy/SKILL.md Updates skill docs to refer to knowledge/pricing/iac.
plugins/deploy-on-aws/skills/deploy/references/security.md Updates MCP references to new server keys.
plugins/deploy-on-aws/skills/deploy/references/defaults.md Updates awsknowledge mention to knowledge.
plugins/deploy-on-aws/skills/deploy/references/cost-estimation.md Updates awspricing mention to pricing.

Comment thread plugins/deploy-on-aws/.mcp.json
@Sagargupta16 Sagargupta16 force-pushed the fix/shorten-mcp-server-names branch from bb84d66 to 1db3d47 Compare April 16, 2026 01:59
Copilot AI review requested due to automatic review settings April 29, 2026 19:12
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated 2 comments.

Comment thread plugins/deploy-on-aws/.mcp.json
Comment thread plugins/deploy-on-aws/.mcp.json
@krokoko
Copy link
Copy Markdown
Contributor

krokoko commented Apr 29, 2026

thanks @Sagargupta16 , could you pelase have a look at the copilot comments ?
Also the build checks are failing
Thank you!

Rename MCP server keys from awsiac/awsknowledge/awspricing to
iac/knowledge/pricing. Claude Code constructs tool names as
mcp__plugin_<plugin>_<server>__<tool>, and the old names caused
the full tool name to exceed Bedrock Converse API's 64-character
constraint (ValidationException).

Before: mcp__plugin_deploy-on-aws_awsknowledge__get_regional_availability (69 chars)
After:  mcp__plugin_deploy-on-aws_knowledge__get_regional_availability (63 chars)

Updated all references in SKILL.md, README.md, and reference docs.

Fixes awslabs#131
Copilot review flagged references to the old server keys (awsknowledge/
awspricing/awsiac) in repo-level docs that were missed in the initial
commit.

Updated only references scoped to the deploy-on-aws plugin:
- AGENTS.md: glossary example + deploy-on-aws server table
- README.md: deploy-on-aws MCP Servers table
- README.jp.md: deploy-on-aws MCP Servers table (Japanese)
- docs/TROUBLESHOOTING.md: generic MCP troubleshooting reference
- .github/copilot-instructions.md: generic tools list

Intentionally left alone: awsknowledge/awsiac references inside
codebase-documentor-for-aws and databases-on-aws sections, which are
separate plugins whose own .mcp.json still uses those keys.
@Sagargupta16 Sagargupta16 force-pushed the fix/shorten-mcp-server-names branch from 98beea0 to a899e94 Compare April 30, 2026 02:57
@Sagargupta16
Copy link
Copy Markdown
Contributor Author

Sagargupta16 commented Apr 30, 2026

Thanks @krokoko — fixed both:

Stale doc refs — updated the deploy-on-aws references in AGENTS.md, README.md, README.jp.md, docs/TROUBLESHOOTING.md, and .github/copilot-instructions.md. Left awsknowledge/awsiac references in other plugin sections alone since those plugins still use the old keys.

64-char validation — checked every tool name:

  • Knowledge (key knowledge): all 6 tools pass, worst is get_regional_availability at 62 chars
  • Pricing: well under limit ✓
  • IAC (key iac): 5 pass, 4 still over — the longest (get_cloudformation_pre_deploy_validation_instructions) is 84 chars. Can't fix via server-key rename; needs a tool-name change upstream in awslabs/mcp/aws-iac-mcp-server.

So this PR fully resolves #131 for Knowledge + Pricing, and shrinks the IAC problem from 9 tools to 4. Happy to file the upstream issue if useful.

Build was just flaky (git-cleanup log, no real failure) — re-running now.

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.

deploy-on-aws: MCP tool names exceed Bedrock Converse API 64-char limit

3 participants