Title: Bedrock Runtime: raise the 64-character tool-name limit for MCP interoperability · Issue #99 · aws/aws-sdk-python · GitHub
Open Graph Title: Bedrock Runtime: raise the 64-character tool-name limit for MCP interoperability · Issue #99 · aws/aws-sdk-python
X Title: Bedrock Runtime: raise the 64-character tool-name limit for MCP interoperability · Issue #99 · aws/aws-sdk-python
Description: Summary Amazon Bedrock Runtime Converse limits toolConfig.tools[].toolSpec.name to 64 characters. Modern MCP clients qualify tool names with a server or application namespace, which can make otherwise valid tool names exceed this limit a...
Open Graph Description: Summary Amazon Bedrock Runtime Converse limits toolConfig.tools[].toolSpec.name to 64 characters. Modern MCP clients qualify tool names with a server or application namespace, which can make otherw...
X Description: Summary Amazon Bedrock Runtime Converse limits toolConfig.tools[].toolSpec.name to 64 characters. Modern MCP clients qualify tool names with a server or application namespace, which can make otherw...
Opengraph URL: https://github.com/aws/aws-sdk-python/issues/99
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Bedrock Runtime: raise the 64-character tool-name limit for MCP interoperability","articleBody":"## Summary\n\nAmazon Bedrock Runtime `Converse` limits `toolConfig.tools[].toolSpec.name` to 64 characters. Modern MCP clients qualify tool names with a server or application namespace, which can make otherwise valid tool names exceed this limit and cause Bedrock to reject the entire request before inference.\n\nPlease consider raising the Bedrock Runtime tool-name limit to at least 128 characters, or providing another service-supported mechanism for stable long-name aliases.\n\nThis is a Bedrock Runtime service API compatibility request rather than an SDK serialization bug. It is being filed here because the AWS SDK for Python currently targets Bedrock Runtime and provides a public AWS-owned feedback tracker.\n\n## Use case: Codex Apps over Bedrock\n\nOpenAI Codex exposes app tools through MCP using model-visible names shaped like:\n\n`mcp__codex_apps__\u003ctool_name>`\n\nThe namespace consumes 17 characters, leaving only 47 characters for the individual tool name under the Bedrock limit.\n\nCodex originally normalized MCP names to 64 bytes. OpenAI PR #39594 raised that limit to 128 bytes to match the OpenAI Responses API. Consequently, names between 65 and 128 characters are valid in Codex but fail when an OpenAI-compatible gateway forwards the request to Bedrock Runtime.\n\nThe Codex regression and reproduction details are tracked here:\nhttps://github.com/openai/codex/issues/46188\n\nOriginal Codex name-length issue and changes:\n- https://github.com/openai/codex/issues/1289\n- https://github.com/openai/codex/pull/1571\n- https://github.com/openai/codex/pull/39594\n\n## Reproduction\n\n1. Invoke Bedrock Runtime `Converse` with a model that supports tool use.\n2. Include a `toolSpec.name` containing 65 valid ASCII characters.\n3. Bedrock rejects the request with a `ValidationException` indicating that the member length must be less than or equal to 64.\n\nThe same failure occurs when one `codex_apps` MCP name exceeds the limit because Bedrock validates the complete tool configuration before model execution.\n\nAPI constraint:\nhttps://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ToolSpecification.html\n\n## Expected behavior\n\nIdeally, Bedrock Runtime would accept tool names of at least 128 characters consistently across:\n\n- `ToolSpecification.name`\n- `SpecificToolChoice.name`\n- returned `toolUse.name` values\n- tool names replayed in conversation history\n\nIf the runtime limit cannot be raised, a documented service-supported aliasing or capability-negotiation mechanism would help clients avoid provider-specific request failures.\n\n## Current workaround\n\nA proxy deterministically shortens names to 64 characters, preserves uniqueness with a hash suffix, and reverse-maps returned tool calls to their original MCP names. This works but requires every client or gateway to implement its own bidirectional mapping.\n\nRelated AWS-owned reports currently work around the same constraint by shortening names rather than changing the Runtime limit:\n- https://github.com/aws/bedrock-agentcore-starter-toolkit/issues/308\n- https://github.com/awslabs/mcp/issues/2395\n\n## Environment\n\n- Client: OpenAI Codex CLI 0.153.2 / Codex Apps MCP tools\n- Backend: Amazon Bedrock Runtime through an OpenAI-compatible gateway\n- Platform: macOS\n- SDK applicability: service-side constraint; reproducible through any AWS SDK exposing `Converse`","author":{"url":"https://github.com/gokmev","@type":"Person","name":"gokmev"},"datePublished":"2026-09-17T11:15:47Z","url":"https://github.com/aws/aws-sdk-python/issues/99"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react-reconciler,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@d5750093facf |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:bb23528f-8a86-b2c8-a8d6-184a13e6b88b |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | D5CA:1AE782:747E36:A355C4:6AFB68E4 |
| html-safe-nonce | 652fcccd71ae3b65c6e5b87c8f88ad250057ddb2e7cfa59dd9bea894e4c7e4ba |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJENUNBOjFBRTc4Mjo3NDdFMzY6QTM1NUM0OjZBRkI2OEU0IiwidmlzaXRvcl9pZCI6IjM0MjE3NzkxNTIwNzAyMDc3MTYiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ== |
| visitor-hmac | f6ef4c646d18b04d51526570c0853b68c7a35a7728e22276d5c1f9c0b16b4941 |
| hovercard-subject-tag | issue:5486606388 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/aws/aws-sdk-python/99/issue_layout |
| twitter:image | https://opengraph.githubassets.com/d586b6d2550f0aa39a8e096c3508259f1c3218296d3121c7ae5c5dc612d644ef/aws/aws-sdk-python/issues/99 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/d586b6d2550f0aa39a8e096c3508259f1c3218296d3121c7ae5c5dc612d644ef/aws/aws-sdk-python/issues/99 |
| og:image:alt | Summary Amazon Bedrock Runtime Converse limits toolConfig.tools[].toolSpec.name to 64 characters. Modern MCP clients qualify tool names with a server or application namespace, which can make otherw... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | gokmev |
| hostname | github.com |
| expected-hostname | github.com |
| None | ea33d13c96d0ff66bd8fa906b193d2213536b78cb06b0c50a4632c58b1418f94 |
| turbo-cache-control | no-preview |
| go-import | github.com/aws/aws-sdk-python git https://github.com/aws/aws-sdk-python.git |
| octolytics-dimension-user_id | 2232217 |
| octolytics-dimension-user_login | aws |
| octolytics-dimension-repository_id | 954213877 |
| octolytics-dimension-repository_nwo | aws/aws-sdk-python |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 954213877 |
| octolytics-dimension-repository_network_root_nwo | aws/aws-sdk-python |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 59ef97164c52cf59bd10558ddec9c4f482763988 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width