Use the MCP server

obscura mcp exposes obscura as a Model Context Protocol server so MCP-capable clients (Claude Desktop, Claude Code, etc.) can drive it.

Run

Stdio (default, for direct client integration):

obscura mcp

HTTP (for remote or shared use):

obscura mcp --http --port 3000

With stealth and proxy:

obscura mcp --stealth --proxy http://proxy.example.com:8080

Tools exposed

The server keeps a live browser session, so tools operate on the current page rather than taking a URL each call. Navigate first, then read or act.

Navigation and lifecycle:

• browser_navigate, browser_back, browser_forward, browser_reload, browser_close

Read the page:

• browser_snapshot: accessibility/DOM snapshot of the current page.
• browser_markdown, browser_links, browser_extract: page as markdown, link list, or structured content.
• browser_interactive_elements, browser_detect_forms: actionable elements and form fields.
• browser_get_attribute, browser_count, browser_search: read an attribute, count matches, find text.

Interact:

• browser_click, browser_fill, browser_fill_form, browser_type, browser_press_key, browser_select_option, browser_scroll

Wait and run JS:

• browser_wait_for, browser_wait_for_text, browser_evaluate

Diagnostics:

• browser_network_requests, browser_console_messages

Cookies and storage:

• browser_get_cookies, browser_set_cookie, browser_clear_cookies, browser_storage_state, browser_set_storage_state

Tabs:

• browser_tab_new, browser_tab_list, browser_tab_switch, browser_tab_close

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "obscura": {
      "command": "/path/to/obscura",
      "args": ["mcp"]
    }
  }
}

Restart Claude Desktop. The obscura tools appear in the tool list.

Claude Code

claude mcp add obscura /path/to/obscura mcp

With stealth in config

{
  "mcpServers": {
    "obscura": {
      "command": "/path/to/obscura",
      "args": ["mcp", "--stealth"]
    }
  }
}