Skip to content

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

Open
Sagargupta16 wants to merge 1 commit 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 1 commit intoawslabs:mainfrom
Sagargupta16:fix/shorten-mcp-server-names

Conversation

@Sagargupta16
Copy link
Copy Markdown

@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
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
@Sagargupta16 Sagargupta16 force-pushed the fix/shorten-mcp-server-names branch from bb84d66 to 1db3d47 Compare April 16, 2026 01:59
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

2 participants