
Amazon Bedrock AgentCore MCP Server: Setup for Claude, Cursor and Other Apps
awslabs.amazon-bedrock-agentcore-mcp-serverawslabs/mcp/tree/HEAD/src/amazon-bedrock-agentcore-mcp-serverLets your coding assistant create and manage Amazon Bedrock AgentCore agents, memory and gateways, and use its cloud browser and code sandbox.
This is AWS's open-source server for Amazon Bedrock AgentCore, the AWS service for running AI agents. It runs on your computer and uses your own AWS credentials to call the AgentCore APIs. It covers agent runtimes, memory, identity, gateways, policies, a cloud browser and a code sandbox.
Many tools create, change or delete AWS resources, and some start billable sessions. You can turn whole groups off with an environment variable, and the README suggests leaving off what you do not use.
Good for
- Developers deploying AI agents on Amazon Bedrock AgentCore who want their coding assistant to do the AWS setup
- Platform teams that manage AgentCore gateways, identities and policies
- Agent builders who want a cloud browser or code sandbox from inside their assistant
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install amazon-bedrock-agentcore-mcp-server
Claude Code
- 1
Copy this prompt.
Add the amazon-bedrock-agentcore-mcp-server server to Claude Code. Run this command: claude mcp add amazon-bedrock-agentcore -- uvx awslabs.amazon-bedrock-agentcore-mcp-server Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires uv (Python).
Built from the package data we hold. Not yet tested by us.
Tools
Creates an AgentCore runtime to host an agent or tool
Creates a new AgentCore Runtime in your AWS account to host an agent or tool. This creates a billable AWS resource.
Try: “Create an AgentCore runtime for my agent container image.”
Write ·
create_agent_runtimeCreates a custom endpoint for a runtime
Creates a custom endpoint for an existing AgentCore Runtime.
Try: “Create an endpoint called prod for my support-agent runtime.”
Write ·
create_agent_runtime_endpointSends a request to an agent hosted on AgentCore
Calls an agent hosted in AgentCore Runtime with the payload you give it and returns the reply.
Try: “Ask my support-agent runtime how to reset a password.”
Runs code ·
invoke_agent_runtimeLists the runtimes in your account
Lists every AgentCore Runtime in the account. Use get_agent_runtime for the configuration of one.
Try: “List my AgentCore runtimes.”
Network ·
list_agent_runtimesShows the details and settings of a runtime
Returns one AgentCore Runtime with its configuration.
Try: “Show me the configuration of my support-agent runtime.”
Network ·
get_agent_runtimeUpdates a runtime and creates a new version
Updates an AgentCore Runtime. Each update creates a new immutable version.
Try: “Update my support-agent runtime to use the new container image.”
Write ·
update_agent_runtimeStops a running session to free its microVM
Stops a running runtime session so its microVM is released.
Try: “Stop runtime session abc123 on my support-agent runtime.”
Write ·
stop_runtime_sessionDeletes a runtime and all its versions
Deletes an AgentCore Runtime and every version of it. This cannot be undone.
Try: “Delete the old test-agent runtime.”
Delete ·
delete_agent_runtimeLists the memory resources in your account
Lists every AgentCore Memory resource in the account.
Try: “List my AgentCore memories.”
Network ·
memory_listCreates a new memory resource
Creates an AgentCore Memory resource for an agent to store short-term events and long-term memories.
Try: “Create a memory called support-bot-memory.”
Write ·
memory_createStores a conversation event in short-term memory
Creates an event in an AgentCore Memory resource, which is its short-term memory.
Try: “Save this exchange as an event in the support-bot memory.”
Write ·
memory_create_eventFinds stored memories by meaning
Runs a semantic search for memory records in a memory resource, filtered by a namespace prefix.
Try: “Search the support-bot memory for what this customer prefers.”
Network ·
memory_retrieve_recordsAdds many memory records at once
Creates several memory records in one call.
Try: “Add these five customer notes to the support-bot memory.”
Write ·
memory_batch_create_recordsStarts or restarts a memory extraction job
Starts, or restarts, a job that extracts long-term memories from stored events.
Try: “Restart extraction job job-42 on the support-bot memory.”
Write ·
memory_start_extraction_jobDeletes a memory resource
Deletes an AgentCore Memory resource.
Try: “Delete the test memory resource.”
Delete ·
memory_deleteCreates an identity for an agent workload
Creates a new AgentCore workload identity.
Try: “Create a workload identity for my support agent.”
Write ·
identity_create_workload_identitySets up an OAuth2 sign-in provider for agents
Creates an OAuth2 credential provider in AgentCore Identity.
Try: “Create an OAuth2 credential provider for our Slack app.”
Write ·
identity_create_oauth2_providerRegisters an API key provider for agents
Creates an API key credential provider in AgentCore Identity. The README says tools that return live tokens or keys are left out.
Try: “Create an API key provider for the weather service.”
Write ·
identity_create_api_key_providerShows details of the token vault
Returns the details of an AgentCore Identity token vault.
Try: “Show me my AgentCore token vault.”
Network ·
identity_get_token_vaultSets the encryption key for the token vault
Sets the customer master key (CMK) for an AgentCore Identity token vault.
Try: “Use our KMS key for the token vault.”
Write ·
identity_set_token_vault_cmkCreates a gateway that exposes APIs as agent tools
Creates an AgentCore Gateway, which turns existing APIs into tools an agent can call.
Try: “Create a gateway called orders-gateway.”
Write ·
gateway_createAdds a target to a gateway
Creates a gateway target to expose tools through a gateway. Targets can be Lambda functions, OpenAPI or Smithy APIs, or MCP servers.
Try: “Add our orders Lambda as a target on orders-gateway.”
Write ·
gateway_target_createRefreshes a gateway target's tool list
Synchronizes gateway targets with their upstream tool catalog.
Try: “Synchronize the targets on orders-gateway.”
Write ·
gateway_target_synchronizeSets who can use a gateway
Creates or updates a resource-based policy on a gateway.
Try: “Allow our production account to call orders-gateway.”
Write ·
gateway_resource_policy_putDeletes a gateway
Deletes an AgentCore Gateway.
Try: “Delete the test gateway.”
Delete ·
gateway_deleteCreates a policy engine
Creates an AgentCore Policy Engine, which enforces access rules on agent actions.
Try: “Create a policy engine for the orders agents.”
Write ·
policy_engine_createCreates a Cedar policy in an engine
Creates a Cedar policy inside an AgentCore Policy Engine.
Try: “Add a policy that blocks refunds over 500 dollars.”
Write ·
policy_createDrafts a Cedar policy from plain words
Starts an AI-powered Cedar policy generation from a natural-language description.
Try: “Generate a policy that lets support agents read but not edit orders.”
Write ·
policy_generation_startOpens a cloud browser session
Starts a cloud browser session through AgentCore. Sessions run in AWS and incur charges until stopped.
Try: “Start a cloud browser session.”
Runs code ·
start_browser_sessionOpens a web address in the cloud browser
Navigates to a URL in the cloud browser session.
Try: “Open example.com in the cloud browser.”
Runs code ·
browser_navigateReads the page the browser is showing
Captures an accessibility-tree snapshot of the current page.
Try: “Take a snapshot of the page.”
Network ·
browser_snapshotClicks an element on the page
Clicks an element identified by its accessibility reference.
Try: “Click the Sign in button.”
Runs code ·
browser_clickRuns JavaScript in the page
Executes a JavaScript expression in the page context of the cloud browser.
Try: “List all link addresses on the page.”
Runs code ·
browser_evaluateTakes a picture of the page
Captures a visual screenshot of the page.
Try: “Take a screenshot of the page.”
Network ·
browser_take_screenshotCloses the cloud browser session
Stops a browser session and releases its resources.
Try: “Stop the browser session.”
Runs code ·
stop_browser_sessionStarts a sandboxed code session
Starts a new sandboxed code interpreter session in AWS. Sessions incur charges until stopped.
Try: “Start a code interpreter session.”
Runs code ·
start_code_interpreter_sessionRuns code in the sandbox
Executes code in a sandboxed code interpreter session.
Try: “Run a Python script that sums the numbers in my data file.”
Runs code ·
execute_codeRuns a shell command in the sandbox
Executes a shell command in the sandboxed session.
Try: “List the files in the sandbox with a shell command.”
Runs code ·
execute_commandInstalls Python packages in the sandbox
Installs Python packages in the sandboxed session, with an option to upgrade.
Try: “Install pandas in the sandbox.”
Runs code ·
install_packagesSends a file into the sandbox
Uploads a file to the sandboxed session.
Try: “Upload this CSV to the sandbox.”
Write ·
upload_fileGets a file out of the sandbox
Downloads a file from the sandboxed session.
Try: “Download results.csv from the sandbox.”
Network ·
download_fileLists the files in the sandbox
Lists files in the sandboxed session.
Try: “What files are in the sandbox?”
Network ·
list_filesSearches the AgentCore documentation
Searches AgentCore documentation and returns ranked results with snippets. It is always on.
Try: “How do AgentCore memory namespaces work?”
Network ·
search_agentcore_docsFetches one AgentCore documentation page
Retrieves the full content of an AgentCore document by URL. It is always on.
Try: “Fetch the page you just found and summarize it.”
Network ·
fetch_agentcore_docUsed by the assistant behind the scenes
Returns a built-in guide to AgentCore Runtime
Returns a reference guide with CLI commands, the config schema, session lifecycle, IAM permissions and cost tiers. Each other area has its own guide tool.
Try: “Show me the AgentCore Runtime guide.”
Read ·
get_runtime_guide
Read from the source code
Permissions
high risk · 5 things to watch
High risk
The assistant can create, change and delete AgentCore resources in your AWS account, and some actions cost money. Use an AWS role limited to what you need and switch off the tool groups you do not use.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It can delete runtimes, gateways and memories
Delete tools exist for runtimes, endpoints, memories, gateways, identities and policies, and they cannot be undone. Use an AWS role without delete permissions. github.com
Some tools start billable AWS sessions
Creating resources, invoking agents and running browser or code sessions incur AWS charges. Stop sessions when you finish. github.com
It can run code and drive a web browser
The code sandbox runs code and shell commands, and the cloud browser can open pages and run JavaScript. Turn both off if you do not need them. github.com
Retrieved content may carry hidden instructions
The README says memory records and gateway responses should be treated as untrusted input. Review what the assistant plans to do after reading them. github.com
Calls that return secrets are left out
The README says token retrieval and gateway invocation are excluded so live credentials do not pass through the assistant. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | There is no read-only mode in the README. AGENTCORE_ENABLE_TOOLS (only these groups) or AGENTCORE_DISABLE_TOOLS (all but these) switch whole groups off, and the documentation tools stay on. |
|---|---|
| Talks to | Amazon Bedrock AgentCore APIs in your AWS region. AgentCore cloud browser (opens websites you ask for). docs.aws.amazon.com (documentation search) |
| Sign-in and keys | Uses your AWS credentials from AWS_PROFILE, environment variables or an IAM role. The server keeps no separate account. |
Questions
Can it delete my AgentCore resources?
Yes. It has delete tools for runtimes, memories, gateways, identities and policies. Use an AWS role without delete permissions if you do not want that.
Does it cost money?
The server is open source. The AWS actions it triggers can cost money, including creating resources, invoking agents and running browser or code sessions. Stop sessions when you are done.
How do I turn off tool groups I don't need?
Set AGENTCORE_DISABLE_TOOLS to a comma list such as browser,code_interpreter, or set AGENTCORE_ENABLE_TOOLS to list only the groups you want. The documentation tools stay on either way.
Is the tool list on this page complete?
No. The README counts 122 tools across runtime, memory, identity, gateway, policy, browser, code interpreter and documentation groups. The list here shows the main ones from each group.
Can it read my API keys or tokens?
The README says calls that return live tokens, keys or secrets are left out on purpose. It can still create and manage the providers and settings that hold them.
Do I need the agentcore command line tool?
Not for the memory tools. The README says they call the AgentCore APIs directly.
What AWS permissions does it need?
Whatever the actions you use require. The README does not list a minimum policy, so start with a role limited to the groups you leave on.
Information
updated Nov 2, 2026
- Publisher
- Amazon Web Services (official)
- Package
awslabs.amazon-bedrock-agentcore-mcp-server- Registry
- PyPI
- Transport
- stdio
- Auth
- token in env
- License
- Apache-2.0
- Last commit
- Oct 30, 2026
- Open issues
- 143
- Listed in
- Docker MCP Catalog
Other AWS MCP servers
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 3Hide
- Amazon Bedrock AgentCore MCP Server README · github.com
- AgentCore server source · github.com
- AgentCore tool source · github.com