awslabs.amazon-bedrock-agentcore-mcp-server 0.0.15

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

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
• Browser Automation: 25 cloud-based browser tools for web navigation, interaction, and data extraction — no local browser installation required
• 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

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

Installation

Kiro	Cursor	VS Code

Configure the MCP server in your MCP client configuration:

For Kiro, see the Kiro IDE documentation or the Kiro CLI documentation for details.

For global configuration, edit ~/.kiro/settings/mcp.json. For project-specific configuration, edit .kiro/settings/mcp.json in your project directory.

Example configuration for Kiro (~/.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": []
    }
  }
}

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?"
• "Start a browser session and navigate to docs.aws.amazon.com"
• "Take a screenshot of the current page and extract all links"

Browser Tools

The server includes 25 browser automation tools powered by Amazon Bedrock AgentCore. Each session runs in an isolated Firecracker microVM — no local browser installation is needed.

Quick Start

# 1. Start a session
start_browser_session(timeout_seconds=300)

# 2. Navigate and interact
browser_navigate(session_id="...", url="https://example.com")
browser_snapshot(session_id="...")       # accessibility tree with element refs
browser_click(session_id="...", ref="e3")
browser_type(session_id="...", ref="e5", text="search query")

# 3. Clean up
stop_browser_session(session_id="...")

Tool Categories

Category	Tools	Description
Session (4)	start_browser_session, get_browser_session, list_browser_sessions, stop_browser_session	Create, inspect, list, and terminate sessions
Navigation (3)	browser_navigate, browser_navigate_back, browser_navigate_forward	URL navigation and history
Observation (6)	browser_snapshot, browser_take_screenshot, browser_evaluate, browser_wait_for, browser_console_messages, browser_network_requests	Page state, screenshots, JS execution, network
Interaction (9)	browser_click, browser_type, browser_fill_form, browser_select_option, browser_hover, browser_press_key, browser_upload_file, browser_handle_dialog, browser_mouse_wheel	Click, type, forms, keyboard, dialogs
Management (3)	browser_tabs, browser_resize, browser_close	Tab management, viewport, page lifecycle

Tips

• Use DuckDuckGo or Bing instead of Google — Google blocks cloud browser IPs with CAPTCHAs.
• Prefer browser_evaluate for data extraction — snapshots show page structure; browser_evaluate with querySelectorAll extracts actual data efficiently.
• Use browser_evaluate for long text — browser_type types character-by-character. For long inputs, use document.querySelector("selector").value = "text" instead.
• Idle timeout, not absolute — timeout_seconds on start_browser_session resets on each tool call, not wall-clock duration.

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.