AWS Bedrock AgentCore MCP Server

Model Context Protocol (MCP) server for Amazon Bedrock AgentCore services

This MCP server provides comprehensive access to Amazon Bedrock AgentCore documentation, enabling developers to search and retrieve detailed information about AgentCore platform services, APIs, tutorials, and best practices.

Features

Search Documentation: Search through curated AgentCore documentation with ranked results and contextual snippets
Fetch Full Documents: Retrieve complete documentation pages for in-depth understanding
Comprehensive Coverage: Access documentation for all AgentCore services including Runtime, Memory, Code Interpreter, Browser, Gateway, Observability, and Identity
Smart Caching: Efficient document caching with on-demand content loading for optimal performance
Curated Documentation List: Uses llm.txt as a curated list of relevant AgentCore documentations, always fetching the latest version of the file

Prerequisites

Installation Requirements

Install uv from Astral or the GitHub README
Install Python 3.10 or newer using uv python install 3.10 (or a more recent version)

Installation

Cursor	VS Code

Configure the MCP server in your MCP client configuration:

For Kiro, add at the project level .kiro/settings/mcp.json

{
  "mcpServers": {
    "bedrock-agentcore-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.amazon-bedrock-agentcore-mcp-server@latest"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

For Amazon Q Developer CLI, add the MCP client configuration and tool command to the agent file in ~/.aws/amazonq/cli-agents.

Example, ~/.aws/amazonq/cli-agents/default.json

{
  "mcpServers": {
    "bedrock-agentcore-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.amazon-bedrock-agentcore-mcp-server@latest"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "disabled": false,
      "autoApprove": []
    }
  },
  "tools": [
    // .. other existing tools
    "@awslabs.amazon-bedrock-agentcore-mcp-server"
  ]
}

Windows Installation

For Windows users, the MCP server configuration format is slightly different:

{
  "mcpServers": {
    "bedrock-agentcore-mcp-server": {
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--from",
        "awslabs.amazon-bedrock-agentcore-mcp-server@latest",
        "awslabs.amazon-bedrock-agentcore-mcp-server.exe"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

Or using Docker after a successful docker build -t mcp/amazon-bedrock-agentcore .:

{
  "mcpServers": {
    "bedrock-agentcore-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "--interactive",
        "--env",
        "FASTMCP_LOG_LEVEL=ERROR",
        "mcp/amazon-bedrock-agentcore:latest"
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

Basic Usage

The server provides access to comprehensive Amazon Bedrock AgentCore documentation covering:

Platform Services:

AgentCore Runtime (serverless deployment and scaling)
AgentCore Memory (persistent knowledge with event and semantic memory)
AgentCore Code Interpreter (secure code execution in isolated sandboxes)
AgentCore Browser (fast, secure cloud-based browser for web interaction)
AgentCore Gateway (transform existing APIs into agent tools)
AgentCore Observability (real-time monitoring and tracing)
AgentCore Identity (secure authentication and access management)

Development Resources:

Getting started guides and prerequisites
Building your first agent or transforming existing code
Local development and testing workflows
Deployment to AgentCore using CLI
API reference documentation
Examples and tutorials for various use cases

Example queries:

"How do I set up AgentCore Memory for my agent?"
"Show me examples of using the Code Interpreter service"
"What are the deployment options for AgentCore Runtime?"
"How do I integrate AgentCore Browser with my application?"

Tools

search_agentcore_docs

Search curated AgentCore documentation and return ranked results with snippets.

search_agentcore_docs(query: str, k: int = 5) -> List[Dict[str, Any]]

Parameters:

query: Search query string (e.g., "bedrock agentcore", "memory integration", "deployment guide")
k: Maximum number of results to return (default: 5)

Returns:List of dictionaries containing:

url: Document URL
title: Display title
score: Relevance score (0-1, higher is better)
snippet: Contextual content preview

fetch_agentcore_doc

Fetch full document content by URL.

fetch_agentcore_doc(uri: str) -> Dict[str, Any]

Parameters:

uri: Document URI (supports http/https URLs)

Returns:Dictionary containing:

url: Canonical document URL
title: Document title
content: Full document text content
error: Error message (if fetch failed)

Use this tool to get complete documentation pages when search snippets aren't sufficient for understanding or implementing AgentCore features.

manage_agentcore_runtime

Provides comprehensive information on deploying and managing agents in AgentCore Runtime.

manage_agentcore_runtime() -> Dict[str, Any]

Returns:Detailed deployment guide covering:

Code requirements and validation checklist
Step-by-step CLI deployment workflow (configure, launch, invoke, status, destroy)
Required code patterns with BedrockAgentCoreApp
Common issues and troubleshooting
Session management and cleanup procedures

Use this tool when you need to deploy agents to AgentCore Runtime or troubleshoot deployment issues.

manage_agentcore_memory

Provides comprehensive information on managing AgentCore Memory resources.

manage_agentcore_memory() -> Dict[str, Any]

Returns:Complete memory management guide covering:

Memory resource creation and configuration
Short-term memory (STM) and long-term memory (LTM) concepts
Semantic memory strategies for facts and knowledge
Full CLI command reference (create, get, list, delete, status)
Common workflows and examples

Use this tool when working with AgentCore Memory for persistent knowledge storage.

manage_agentcore_gateway

Provides comprehensive information on deploying and managing MCP Gateways in AgentCore.

manage_agentcore_gateway() -> Dict[str, Any]

Returns:Complete gateway deployment guide covering:

Gateway creation and configuration requirements
Step-by-step CLI deployment workflow
Target management for Lambda, OpenAPI, and Smithy models
Authentication and authorization setup (Cognito, OAuth2, API keys)
Management commands (list, get, delete)
Common patterns and troubleshooting

Use this tool when deploying MCP Gateways to provide managed endpoints for Model Context Protocol servers.

AWS Bedrock AgentCore MCP Server