How do I install the blueprint mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `AUTH_BASE_URL` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Blueprint MCP Server

Blueprint MCP monorepo - MCP server and browser extensions

Local serverstdioTypeScript

What is the Blueprint MCP Server?

Blueprint MCP monorepo - MCP server and browser extensions

What you get

An MCP (Model Context Protocol) server that lets AI assistants control your actual browser (Chrome, Firefox, or Opera) through a browser extension. Unlike headless automation tools, this uses your real browser profile with all your logged-in sessions, cookies, and extensions intact.

Configuration and credentials

Node.js 18+ - A supported browser (Chrome, Firefox, Edge, or Opera) - npm or yarn

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
enable	Activate browser automation (required first step)
disable	Deactivate browser automation
status	Check connection status
auth	Login to PRO account (for cloud relay features)
browser_tabs	List, create, attach to, or close browser tabs
browser_navigate	Navigate to a URL
browser_navigate_back	Go back in history
browser_snapshot	Get accessible page content (recommended for reading pages)
browser_take_screenshot	Capture visual screenshot
browser_console_messages	Get browser console logs
browser_network_requests	Powerful network monitoring and replay tool with multiple actions:
Filters	urlPattern (substring), method (GET/POST), status (200/404), resourceType (xhr/fetch/script)
Pagination	limit (default: 20), offset (default: 0)
Example	action='details', requestId='12345.67', jsonPath='$.data.users[0]'
browser_extract_content	Extract page content as markdown
browser_interact	Perform multiple actions in sequence (click, type, hover, wait, etc.)
browser_click	Click on elements
browser_type	Type text into inputs
browser_hover	Hover over elements
browser_select_option	Select dropdown options
browser_fill_form	Fill multiple form fields at once
browser_press_key	Press keyboard keys
browser_drag	Drag and drop elements
browser_evaluate	Execute JavaScript in page context
browser_handle_dialog	Handle alert/confirm/prompt dialogs
browser_file_upload	Upload files through file inputs
browser_window	Resize, minimize, maximize browser window
browser_pdf_save	Save current page as PDF
browser_performance_metrics	Get performance metrics
browser_verify_text_visible	Verify text is present (for testing)
browser_verify_element_visible	Verify element exists (for testing)
browser_list_extensions	List installed browser extensions
browser_reload_extensions	Reload unpacked extensions (useful during development)

How to install the Blueprint MCP Server

{
  "mcpServers": {
    "browser": {
      "command": "npx",
      "args": [
        "@railsblueprint/blueprint-mcp@latest"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Node.js 18+ - A supported browser (Chrome, Firefox, Edge, or Opera) - npm or yarn

Example prompts to try

“Use Blueprint MCP to Navigation.”
“Use Blueprint MCP to Interaction.”
“Use Blueprint MCP to Advanced.”

Frequently asked questions

Blueprint MCP monorepo - MCP server and browser extensions Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.