mcp/amazon-bedrock-agentcore-mcp-server repository overview

⁠AWS Bedrock AgentCore MCP Server

Documentation on AgentCore platform services.

What is an MCP Server?⁠

⁠MCP Info

⁠Image Building Info

⁠Available Tools (122)

---

⁠Tools Details

⁠Tool: browser_click

Click an element identified by its accessibility ref.

Use refs from the most recent browser_snapshot or navigation result. If the ref is not found, returns an error with the current page snapshot so you can retry with a correct ref.

---

⁠Tool: browser_close

Close the current page.

Closes the active page in the browser session. If multiple tabs are open, subsequent tools will use the remaining tab. Use stop_browser_session to fully terminate the session.

---

⁠Tool: browser_console_messages

Get recent browser console messages.

Returns console log, warning, and error messages captured since the Playwright connection was established. Useful for debugging JavaScript errors or inspecting application logging.

---

⁠Tool: browser_evaluate

Execute a JavaScript expression in the page context.

The expression is evaluated in the browser and its return value is serialized to JSON. Use this for extracting data, reading page state, or performing custom interactions. You can use fetch() to make HTTP requests from the browser's origin and cookies.

---

⁠Tool: browser_fill_form

Fill multiple form fields in one action.

Clears each field before filling. Optionally clicks a submit button after all fields are filled. Returns the page snapshot after completion.

---

⁠Tool: browser_handle_dialog

Configure how JavaScript dialogs are handled for a session.

Sets a persistent handler for JavaScript dialogs (alert, confirm, prompt, beforeunload). Once set, all subsequent dialogs in the session are automatically accepted or dismissed. Call again to change the behavior.

---

⁠Tool: browser_hover

Hover over an element identified by its accessibility ref.

Useful for triggering tooltips, dropdown menus, or hover states. Returns the page snapshot after hovering.

---

⁠Tool: browser_mouse_wheel

Scroll the page by the specified pixel amounts.

Default scrolls down by 500px (roughly half a viewport). Use negative delta_y to scroll up. Returns the page snapshot after scrolling.

---

⁠Tool: browser_navigate

Navigate to a URL in the browser.

Loads the specified URL and returns an accessibility tree snapshot of the loaded page. Use the element refs in the snapshot for subsequent interaction tools.

---

⁠Tool: browser_navigate_back

Navigate back in browser history.

Returns an accessibility tree snapshot of the previous page.

---

⁠Tool: browser_navigate_forward

Navigate forward in browser history.

Returns an accessibility tree snapshot of the next page.

---

⁠Tool: browser_network_requests

List recent network requests and their status.

Returns a summary of network requests made by the page, including URL, HTTP method, status code, and resource type. Useful for debugging API calls or monitoring page loading.

---

⁠Tool: browser_press_key

Press a keyboard key or key combination.

Simulates a key press on the page (not a specific element). Supports modifier combinations like "Control+a" or "Meta+c". Returns the page snapshot after the key press.

---

⁠Tool: browser_resize

Resize the browser viewport.

Changes the viewport dimensions of the active page. Useful for testing responsive layouts or viewing content at different sizes. Returns the page snapshot at the new size.

---

⁠Tool: browser_select_option

Select an option from a dropdown or combobox.

Provide one of: value (option value attribute), label (visible text), or index (zero-based position). Returns the page snapshot after selection.

---

⁠Tool: browser_snapshot

Capture an accessibility tree snapshot of the current page.

Returns a structured text view of the page with element refs. Use the refs (e.g., e1, e2) in interaction tools like browser_click and browser_type to target specific elements.

Example output:

• heading "Sign In" [ref=e1]
• textbox "Email" [ref=e2]
• textbox "Password" [ref=e3]
• button "Sign In" [ref=e4] Parameters|Type|Description -|-|- session_id|string|Browser session identifier selector|string optional|Optional CSS selector to scope the snapshot to a specific section of the page (e.g., "main", "[role=main]", "#content"). If omitted, captures the full page.

---

⁠Tool: browser_tabs

Manage browser tabs: list, create, select, or close tabs.

Actions:

• "list": Show all open tabs with their titles and URLs.
• "new": Open a new tab, optionally navigating to a URL.
• "select": Switch the active tab (subsequent tools use this tab).
• "close": Close a tab by its index. Parameters|Type|Description -|-|- session_id|string|Browser session identifier action|string optional|Tab action to perform: "list" to show all tabs, "new" to open a new tab, "select" to switch to a tab by index, "close" to close a tab by index. tab_index|string optional|Zero-based tab index for "select" and "close" actions url|string optional|URL to open in a new tab (for "new" action)

---

⁠Tool: browser_take_screenshot

Capture a visual screenshot of the page.

Returns the screenshot as a base64-encoded PNG image. Use this when you need to visually inspect the page rather than reading the accessibility tree.

---

⁠Tool: browser_type

Type text into an element identified by its accessibility ref.

By default, clears the existing content before typing. Set clear_first=False to append to existing text. Set submit=True to press Enter after typing.

---

⁠Tool: browser_upload_file

Upload files to a file input element identified by its ref.

Resolves the ref to a file input locator and sets the specified file paths. For cloud AgentCore sessions, paths refer to files on the remote VM. For local Playwright connections, paths refer to files on the local filesystem.

---

⁠Tool: browser_wait_for

Wait for text to appear or an element to become visible.

Provide either text or selector. Returns the page snapshot after the condition is met. Raises an error if the timeout is exceeded.

---

⁠Tool: create_agent_runtime

Create a new AgentCore Runtime to host an agent or tool.

This is a one-time setup operation that creates AWS infrastructure (IAM role binding, container deployment, endpoint). The DEFAULT endpoint is created automatically. Subsequent updates create new immutable versions.

Cost note: Creating a runtime provisions infrastructure. You are not billed until sessions are invoked, but the runtime definition and its resources persist until deleted.

---

⁠Tool: create_agent_runtime_endpoint

Create a custom endpoint for an AgentCore Runtime.

Endpoints provide stable access points to specific runtime versions. The DEFAULT endpoint is created automatically; use this for additional environments (dev, staging, prod).

This is a configuration operation with no per-use cost.

---

⁠Tool: delete_agent_runtime

Delete an AgentCore Runtime and all its versions.

All endpoints must be deleted first. Active sessions will be terminated. This operation cannot be undone.

---

⁠Tool: delete_agent_runtime_endpoint

Delete a runtime endpoint. Cannot delete the DEFAULT endpoint.

This operation cannot be undone.

---

⁠Tool: download_file

Download a file from the sandboxed code interpreter session.

Reads the content of a file at the specified path in the session's sandbox.

---

⁠Tool: execute_code

Execute code in a sandboxed code interpreter session.

Runs Python, JavaScript, or TypeScript code in the session's sandbox. The execution context (variables, imports) persists across calls within the same session unless clear_context is True.

---

⁠Tool: execute_command

Execute a shell command in a sandboxed code interpreter session.

Runs a shell command in the session's sandbox environment.

---

⁠Tool: fetch_agentcore_doc

Fetch full document content by URL.

Retrieves complete AgentCore documentation content from URLs found via search_agentcore_docs or provided directly. Use this to get full documentation pages including:

• Complete platform overview and service documentation
• Detailed getting started guides with step-by-step instruc

[...]