ContextQMD
Back to Browser Use

Integrations (MCP, Skills, Docs)

skills/open-source/references/integrations.md

0.12.64.6 KB
Original Source

Integrations (MCP, Skills, Docs)

Table of Contents

MCP Server (Cloud)

HTTP-based MCP server at https://api.browser-use.com/mcp

Setup

Claude Code:

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

Claude Desktop (macOS ~/Library/Application Support/Claude/claude_desktop_config.json):

json
{
  "mcpServers": {
    "browser-use": {
      "type": "http",
      "url": "https://api.browser-use.com/mcp",
      "headers": { "x-browser-use-api-key": "your-api-key" }
    }
  }
}

Cursor (~/.cursor/mcp.json):

json
{
  "mcpServers": {
    "browser-use": {
      "type": "http",
      "url": "https://api.browser-use.com/mcp",
      "headers": { "x-browser-use-api-key": "your-api-key" }
    }
  }
}

Windsurf (~/.codeium/windsurf/mcp_config.json):

json
{
  "mcpServers": {
    "browser-use": {
      "type": "http",
      "url": "https://api.browser-use.com/mcp",
      "headers": { "x-browser-use-api-key": "your-api-key" }
    }
  }
}

Cloud MCP Tools

ToolCostDescription
browser_task$0.01 + per-stepRun browser automation task
execute_skill$0.02Execute a skill
list_skillsFreeList available skills
get_cookiesFreeGet cookies
list_browser_profilesFreeList cloud profiles
monitor_taskFreeCheck task progress

browser_task params: task (required), max_steps (1-10, default 8), profile_id (UUID)

MCP Server (Local)

Free, self-hosted stdio-based server:

bash
uvx --from 'browser-use[cli]' browser-use --mcp

Claude Desktop Config

macOS (~/Library/Application Support/Claude/claude_desktop_config.json):

json
{
  "mcpServers": {
    "browser-use": {
      "command": "/Users/your-username/.local/bin/uvx",
      "args": ["--from", "browser-use[cli]", "browser-use", "--mcp"],
      "env": {
        "OPENAI_API_KEY": "your-key"
      }
    }
  }
}

Note: Use full path to uvx on macOS/Linux (run which uvx to find it).

Local MCP Tools

Agent: retry_with_browser_use_agent — full automation task

Direct Control:

  • browser_navigate — Go to URL
  • browser_click — Click element by index
  • browser_type — Type text
  • browser_get_state — Page state + interactive elements
  • browser_scroll — Scroll page
  • browser_go_back — Back in history

Tabs: browser_list_tabs, browser_switch_tab, browser_close_tab

Extraction: browser_extract_content — Structured extraction

Sessions: browser_list_sessions, browser_close_session, browser_close_all

Environment Variables

  • OPENAI_API_KEY or ANTHROPIC_API_KEY — LLM key (required)
  • BROWSER_USE_HEADLESS — false to show browser
  • BROWSER_USE_DISABLE_SECURITY — true to disable security
  • BROWSER_USE_LOGGING_LEVEL — DEBUG for verbose logs

Programmatic Usage

python
from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

async def use_browser_mcp():
    server_params = StdioServerParameters(
        command="uvx",
        args=["--from", "browser-use[cli]", "browser-use", "--mcp"]
    )
    async with stdio_client(server_params) as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()
            result = await session.call_tool("browser_navigate", arguments={"url": "https://example.com"})

Skills

Load cloud skills into agents as reusable API endpoints:

python
agent = Agent(
    task='Analyze TikTok and Instagram profiles',
    skills=[
        'a582eb44-e4e2-4c55-acc2-2f5a875e35e9',  # TikTok Scraper
        'f8d91c2a-3b4e-4f7d-9a1e-6c8e2d3f4a5b',  # Instagram Scraper
    ],
    llm=ChatBrowserUse()
)
await agent.run()
  • Use skills=['*'] for all skills (each adds ~200 tokens to prompt)
  • Requires BROWSER_USE_API_KEY
  • Browse/create at cloud.browser-use.com/skills
  • Cookies auto-injected from browser; if missing, LLM navigates to obtain them

Documentation MCP

Read-only docs access (no browser automation):

Claude Code:

bash
claude mcp add --transport http browser-use-docs https://docs.browser-use.com/mcp

Cursor (~/.cursor/mcp.json):

json
{
  "mcpServers": {
    "browser-use-docs": { "url": "https://docs.browser-use.com/mcp" }
  }
}

No API key needed. Provides API reference, config options, best practices, examples.