nova-act-mcp

madtank/nova-act-mcp

3.4

If you are the rightful owner of nova-act-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

nova-act-mcp-server is a zero-install Model Context Protocol (MCP) server that exposes Amazon Nova Act browser-automation tools for AI agents.

Tools

Functions exposed to the LLM to take actions

start_session

Starts and initializes a new browser session controlled by Nova Act, navigating to the specified URL. Returns session details including a unique session_id required for other browser tools. This is a long-running operation (20-60s) and will send progress notifications.

execute_instruction

Executes a natural language instruction in an active browser session. Use task for the main instruction. Returns action outcome, URL, and agent thinking. For complex goals, call multiple times, verifying each step.

inspect_browser

Retrieves current state (URL, title) of an active browser session. Screenshot is omitted by default. Set include_screenshot=True to get a base64 JPEG (can be large).

end_session

Closes the specified browser session and cleans up resources. Call this when done with a session.

fetch_file

Retrieves the contents of a file from the server, with optional base64 encoding. Primarily used to access log files, screenshots, and other assets generated during browser automation. Set encode_base64=True for binary files like images. Has a configurable size limit (default 10MB) to prevent excessive token usage with large files.

view_html_log

Retrieves and displays HTML log files generated by Nova Act browser sessions. These logs contain detailed information about browser interactions, including screenshots and executed actions. Provide either a session_id to automatically find the most recent HTML log for that session, or html_path to directly specify a log file path.

compress_logs

Compresses Nova Act log files to reduce size while preserving important information. Optionally extracts embedded screenshots to a separate directory before compression. Use this tool to prepare logs for storage or transmission when they become too large for efficient handling.

view_compressed_log

Retrieves and displays the contents of a compressed log file (.gz) previously created by the compress_logs tool. Automatically decompresses the file and attempts to parse it as JSON. Use this tool to examine logs that have been compressed for storage efficiency.

list_browser_sessions

Lists all active Nova Act browser sessions managed by this MCP server. Returns details about each session including their IDs, status, creation timestamps, and associated URLs. Use this to discover existing sessions before attempting to perform operations on them with other browser tools. Sessions that have ended or timed out will be automatically cleaned up.

Prompts

Interactive templates invoked by user choice

No prompts

Resources

Contextual data attached and managed by the client

No resources