In this post we introduce the new AgentCore MCP server and walk through the installation steps so you can get started.<\/p>\n
AgentCore MCP server capabilities <\/p>\n
The AgentCore MCP server brings a new agentic development experience to AWS, providing specialized tools that automate the complete agent lifecycle, eliminate the steep learning curve, and reduce development friction that can slow innovation cycles.\u00a0To address specific agent development challenges the AgentCore MCP server:<\/p>\n
Transforms agents for AgentCore Runtime integration by providing guidance to your coding assistant on the minimum functionality changes needed\u2014adding Runtime library imports, updating dependencies, initializing apps with BedrockAgentCoreApp(), converting entrypoints to decorators, and changing direct agent calls to payload handling\u2014while preserving your existing agent logic and Strands Agents features.
\n Automates development environment provisioning by handling the complete setup process through your coding assistant: installing required dependencies (bedrock-agentcore SDK, bedrock-agentcore-starter-toolkit CLI helpers, strands-agents SDK), configuring AWS credentials and AWS Regions, defining execution roles with Bedrock AgentCore permissions, setting up ECR repositories, and creating .bedrock_agentcore.yaml configuration files.
\n Simplifies tool integration with Bedrock AgentCore Gateway for seamless agent-to-tool communication in the cloud environment.
\n Enables simple agent invocation and testing by providing natural language commands through your coding assistant to invoke provisioned agents on AgentCore Runtime and verify the complete workflow, including calls to AgentCore Gateway tools when applicable. <\/p>\n
Layered approach <\/p>\n
When using the AgentCore MCP server with your favorite client, we encourage you to consider a layered architecture designed to provide comprehensive AI agent development support:<\/p>\n
Layer 1: Agentic IDE or client \u2013 Use Kiro, Claude Code, Cursor, VS Code extensions, or another natural language interface for developers. For very simple tasks, agentic IDEs are equipped with the right tools to look up documentation and perform tasks specific to Bedrock AgentCore. However, with this layer alone, developers may observe sub-optimal performance across AgentCore developer paths. Each layer builds upon the previous one, providing increasingly specific context so your coding assistant can handle everything from basic AWS operations to complex agent transformations and deployments.<\/p>\n Installation <\/p>\n To get started with the Amazon Bedrock AgentCore MCP server you can use the one-click install on the Github repository<\/a>.<\/p>\n Each IDE integrates with an MCP differently using the mcp.json file. Review the MCP documentation for your IDE, such as Kiro<\/a>, Cursor<\/a>, Q CLI<\/a>, and Claude Code<\/a> to determine the location of the mcp.json.<\/p>\n Use the following in your mcp.json:<\/p>\n { For example, here is what the IDE looks like on Kiro, with the AgentCore MCP server and the two tools, search_agentcore_docs and fetch_agentcore_doc, connected:<\/p>\n Using the AgentCore MCP server for agent development <\/p>\n While we show demos for various use cases below using the Kiro IDE, the AgentCore MCP server has also been tested to work on Claude Code, Amazon Q CLI, Cursor, and the VS Code Q plugin. First, let\u2019s take a look at a typical agent development lifecycle using AgentCore services (remember that this is only one example with the tools available, and you are free to explore more such use cases simply by instructing the agent in your favorite Agentic IDE):<\/p>\n The agent development lifecycle follows these steps:<\/p>\n The user takes a local set of tools or MCP servers and <\/p>\n Creates a lambda target for AgentCore Gateway; or The user prepares the actual agent code using a preferred framework like Strands Agents or LangGraph. The user can either: <\/p>\n Start from scratch (the server can fetch docs from the Strands Agents or LangGraph documentation) The user asks the agent to transform the code into a format compatible with AgentCore Runtime with the intention to deploy the agent later. This causes the agent to: <\/p>\n Write an appropriate requirements.txt\u00a0file The user may then ask the agent to deploy to AgentCore Runtime. The agent can look up documentation and can use the AgentCore CLI to deploy the agent code to Runtime The agent modifies the original code to add an MCP client that can call the deployed gateway Here is a demo of the MCP server working with Cursor IDE. We see the agent perform the following steps:<\/p>\n Transform the weather_agent.py to be compatible with AgentCore runtime Here\u2019s another example of deploying a LangGraph agent to AgentCore Runtime with the Cursor IDE performing similar steps as seen above.<\/p>\n Clean up <\/p>\n If you\u2019d like to uninstall the MCP server, follow the MCP documentation for your IDE, such as Kiro<\/a>, Cursor<\/a>, Q CLI<\/a>, and Claude Code<\/a> for instructions.<\/p>\n Conclusion <\/p>\n In this post, we showed how you can use the AgentCore MCP server with your favorite Agentic IDE of choice to speed up your development workflows.<\/p>\n We encourage you to review the Github repository<\/a>, as well read through and use the following resources in your development:<\/p>\n We encourage you to try out the AgentCore MCP server and provide any feedback through issues in our GitHub repository<\/a>.<\/p>\n About the authors <\/p>\n Shreyas Subramanian <\/p>\n
\n Layer 2: AWS service documentation \u2013 Install the AWS Documentation MCP Server\u00a0<\/a>for comprehensive AWS service documentation, including context about Bedrock AgentCore.
\n Layer 3: Framework documentation \u2013 Install the Strands<\/a>, LangGraph<\/a>, or other framework docs MCP servers or use the llms.txt for framework-specific context.
\n Layer 4: SDK documentation \u2013 Install the MCP or use the llms.txt for the Agent Framework SDK and Bedrock AgentCore SDK for a combined documentation layer that covers the Strands Agents SDK documentation and Bedrock AgentCore API references.
\n Layer 5: Steering files \u2013 Task-specific guidance for more complex and repeated workflows. Each IDE has a different approach to using steering files (for example, see Steering<\/a> in the Kiro documentation). <\/p>\n
\n\u00a0\u00a0“mcpServers”: {
\n\u00a0\u00a0 \u00a0“awslabs.amazon-bedrock-agentcore-mcp-server”: {
\n\u00a0\u00a0 \u00a0 \u00a0“command”: “uvx”,
\n\u00a0\u00a0 \u00a0 \u00a0“args”: [“awslabs.amazon-bedrock-agentcore-mcp-server@latest”],
\n\u00a0\u00a0 \u00a0 \u00a0“env”: {
\n\u00a0\u00a0 \u00a0 \u00a0 \u00a0“FASTMCP_LOG_LEVEL”: “ERROR”
\n\u00a0\u00a0 \u00a0 \u00a0},
\n\u00a0\u00a0 \u00a0 \u00a0“disabled”: false,
\n\u00a0\u00a0 \u00a0 \u00a0“autoApprove”: []
\n\u00a0\u00a0 \u00a0}
\n\u00a0\u00a0}
\n} <\/p>\n![](\"https:\/\/www.newsbeep.com\/il\/wp-content\/uploads\/2025\/10\/ML-19737-2.jpg\"\/)
<\/p>\n![](\"https:\/\/www.newsbeep.com\/il\/wp-content\/uploads\/2025\/10\/ML-19737-4.png\"\/)
<\/p>\n
\n Deploys the MCP server as-is on AgentCore Runtime <\/p>\n
\n Start from fully or partially working agent code <\/p>\n
\n import necessary libraries including bedrock_agentcore
\n decorate the main handler (or create one) to access the core agent calling logic or input handler <\/p>\n
\n The user can test the agent by asking the agent to do so. The AgentCore CLI command required for this is written and executed by the client
\n The user then asks to modify the code to use the deployed AgentCore Gateway MCP server within this AgentCore Runtime agent. <\/p>\n
\n The agent then deploys a new version v2 of the agent to Runtime
\n The agent then tests this integration with a new prompt <\/p>\n
\n Use the AgentCore CLI to deploy the agent
\n Test the deployed agent with a successful prompt <\/p>\n![\"Shreyas](\"https:\/\/www.newsbeep.com\/il\/wp-content\/uploads\/2025\/10\/subshrey.jpg\")
<\/p>\n
![\"Primo](\"https:\/\/www.newsbeep.com\/il\/wp-content\/uploads\/2025\/10\/IMG_1032.jpg\")
<\/p>\n