Usage

MCP Server

Browser Use provides a hosted Model Context Protocol (MCP) server that enables AI assistants to control browser automation. Works with any HTTP-based MCP client, including Claude Code.

MCP Server URL: https://api.browser-use.com/mcp

This is an HTTP-based MCP server designed for cloud integrations and remote access. If you need a local stdio-based MCP server for Claude Desktop, use the free open-source version: uvx browser-use --mcp

Quick Setup

1. Get API Key

Get your API key from the Browser Use Dashboard

2. Connect Your AI

$claude mcp add --transport http browser-use https://api.browser-use.com/mcp

Available Tools

The MCP server provides three tools:

browser_task

Creates and runs a browser automation task.

  • task (required): What you want the browser to do
  • max_steps (optional): Max actions to take (1-100, default: 8)
  • profile_id (optional): UUID of the cloud profile to use for persistent authentication

list_browser_profiles

Lists all available cloud browser profiles for the authenticated project. Profiles store persistent authentication (cookies, sessions) for websites requiring login.

monitor_task

Checks the current status and progress of a browser automation task. Returns immediately with a snapshot of the task state.

  • task_id (required): UUID of the task to monitor (returned by browser_task)

Example Usage

Once connected, ask your AI to perform web tasks:

“Search Google for the latest iPhone reviews and summarize the top 3 results”

“Go to Hacker News and get me the titles of the top 5 posts”

“Fill out the contact form on example.com with my information”

The AI will use the browser tools automatically to complete these tasks.

Smart Features

Cloud Profiles for Authentication

Use cloud browser profiles to maintain persistent login sessions across tasks. Profiles store cookies and authentication state for:

  • Social media (X/Twitter, LinkedIn, Facebook)
  • Email (Gmail, Outlook)
  • Online banking and shopping sites
  • Any website requiring login

List available profiles with list_browser_profiles, then pass the profile_id to browser_task.

Real-time Task Monitoring

Use monitor_task to check task progress while it’s running. The tool returns immediately with the current status, latest step details, and agent reasoning. Call it repeatedly to track progress live.

Conversational Progress Summaries

When you monitor tasks, the AI automatically interprets step data into natural language updates, explaining what the browser has completed and what it’s currently working on.

Troubleshooting

Connection issues?

  • Verify your API key is correct
  • Check you’re using the right headers

Task taking too long?

  • Check the live_url to see progress
  • Increase max_steps for complex tasks (max: 10)
  • Use clearer, more specific instructions

Need help? Check the v2 API Reference for detailed specifications.