# Ornold MCP - Full Documentation

> AI browser automation for authorized QA, internal operations, and repeatable workflows.

Ornold is a Model Context Protocol (MCP) server that connects compatible AI agents to browser profiles an operator owns or is authorized to manage. It provides typed tools for navigation, page inspection, visual interaction, form testing, workflow recovery, and controlled parallel execution.

## Supported AI agents

- Claude Code
- Codex
- Cursor
- Windsurf
- Claude Desktop
- Other MCP-compatible clients

## Supported browser connections

Ornold connects through supported vendor APIs or Chrome DevTools Protocol (CDP). Integrations include Linken Sphere, Dolphin Anty, Octo Browser, AdsPower, Multilogin, GoLogin, Incogniton, Vision, Wade X, and other browsers that expose a compatible debugging endpoint.

Ornold is an independent software provider. Compatibility references do not imply affiliation with or endorsement by third-party browser vendors.

## Public MCP tool scope

### Browser management

- `browser_list` - list connected browser profiles and status
- `browser_status` - inspect connection and page state

### Navigation

- `browser_parallel_navigate` - navigate approved sessions
- `browser_parallel_go_back` - move back in browser history
- `browser_parallel_go_forward` - move forward in browser history
- `browser_parallel_reload` - reload current pages

### Vision and inspection

- `browser_parallel_vision_analyze_grouped` - analyze screenshots and group matching layouts
- `browser_parallel_snapshot` - return structured accessibility snapshots
- `browser_parallel_screenshot` - capture screenshots for review

### Interaction

- `browser_parallel_click` - click elements by structured reference or selector
- `browser_parallel_click_normalized_box` - click a detected visual element
- `browser_parallel_fill` - fill approved test inputs
- `browser_parallel_fill_form` - fill a controlled test form
- `browser_parallel_type` - type text with configurable timing
- `browser_parallel_select_option` - select an option
- `browser_parallel_press_key` - send a keyboard action
- `browser_parallel_upload_file` - upload an approved file

### Execution and recovery

- `browser_parallel_run_code` - execute approved JavaScript
- `browser_parallel_wait_for` - pause until a state or operator checkpoint is satisfied
- `browser_run_recorded_flow` - replay an authorized recorded workflow
- `browser_parallel_handle_dialog` - handle expected browser dialogs
- `browser_parallel_console_messages` - collect diagnostic console output
- `browser_parallel_network_requests` - inspect network diagnostics

## Recommended use cases

### Web application QA

Validate interfaces your organization owns. Compare visual states, fill test forms, capture screenshots, and retry only failed sessions.

### Internal operations

Automate repetitive actions inside approved internal dashboards with clear logs and operator confirmation for sensitive steps.

### Authorized data collection

Collect permitted information from owned or licensed sources in accordance with access rules, applicable law, and contractual obligations.

### Workflow development

Build a workflow on one authorized profile, verify the result, then replay it across an approved test set with bounded concurrency.

## Responsible operation

- Confirm authorization before connecting a profile or target system.
- Use bounded concurrency and respect target service limits.
- Pause sensitive actions for operator approval.
- Keep clear logs and minimize collected data.
- Stop when authorization is unclear or revoked.

Prohibited uses are listed in the [Acceptable Use Policy](https://ornold.com/acceptable-use). They include unauthorized access, deceptive accounts or activity, invalid advertising traffic, evasion of platform enforcement, and collection of restricted data without permission.

## Installation

Prerequisites:

- Node.js 18+
- An Ornold API token from https://mcp.ornold.com
- Access to a supported browser profile you are authorized to manage

Claude Code:

```bash
claude mcp add --transport stdio ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --linken-port 40080
```

Codex:

```bash
codex mcp add ornold-browser -- npx ornold-mcp --token YOUR_TOKEN --linken-port 40080
```

Cursor and other JSON-configured clients:

```json
{
  "mcpServers": {
    "ornold-browser": {
      "command": "npx",
      "args": ["ornold-mcp", "--token", "YOUR_TOKEN", "--linken-port", "40080"]
    }
  }
}
```

## Policies and support

- Website: https://ornold.com
- Dashboard: https://mcp.ornold.com
- Pricing: https://ornold.com/pricing
- Privacy: https://ornold.com/privacy
- Terms: https://ornold.com/terms
- Acceptable Use: https://ornold.com/acceptable-use
- Contact: https://ornold.com/contact