Browser Automation MCP Tools

Model Context Protocol tool reference for Pauhu Browser Automation. Automated browser actions for EU procurement and regulatory workflows.

MCP Server Configuration

Add the Pauhu Browser Automation server to your MCP client configuration. The server uses Server-Sent Events (SSE) transport and requires a valid API key.

{
  "mcpServers": {
    "pauhu-cua": {
      "url": "https://pauhu.eu/v1/mcp",
      "transport": "sse",
      "headers": {
        "Authorization": "Bearer pk_your_api_key"
      }
    }
  }
}

Generate an API key at pauhu.ai/keys. All automation sessions run within an EU-jurisdiction sandboxed browser environment.

cua_click

Click an element on the page. Accepts either a CSS selector, pixel coordinates, or both for precise targeting.

Parameters

Example

{
  "name": "cua_click",
  "arguments": {
    "session_id": "cua_abc123",
    "target": "#procurement-type-dropdown",
    "coordinates": { "x": 450, "y": 200 },
    "description": "Open procurement type dropdown"
  }
}

Response

{ "action_id": "act_001", "status": "pending" }

Errors

cua_type

Type text into a form field. By default, the field is cleared before typing.

Parameters

Example

{
  "name": "cua_type",
  "arguments": {
    "session_id": "cua_abc123",
    "target": "input[name='title']",
    "value": "IT Consulting Services - Framework Agreement",
    "description": "Enter contract title"
  }
}

Errors

400 (missing required parameter), 403 (element outside sandbox), 404 (session not found), 408 (element not found within timeout).

cua_scroll

Scroll the page or a specific container element.

Parameters

Errors

400 (invalid parameters), 404 (session not found).

cua_navigate

Navigate to a URL. The target domain must be on the allowlist. Navigation to domains outside the allowlist is blocked by the safety gate (403).

Parameters

Example

{
  "name": "cua_navigate",
  "arguments": {
    "session_id": "cua_abc123",
    "url": "https://ted.europa.eu/en/notice/-/detail/123456",
    "wait_for": "#notice-content"
  }
}

Errors

cua_select

Select an option from a dropdown or list element.

Parameters

Errors

400 (missing required parameter), 403 (element outside sandbox), 404 (session not found), 408 (element not found within timeout).

cua_submit

Submit a form. This action always requires human confirmation. The system pauses execution and sends a form_confirmation SSE event containing all form field values. The user must approve via /v1/cua/confirm before the submit executes.

Parameters

Errors

cua_wait

Wait for a condition to be met before proceeding. Useful for page transitions, dynamic content loading, and network-dependent elements.

Parameters

Errors

400 (invalid parameters), 404 (session not found), 408 (condition not met within timeout).

cua_screenshot

Capture a screenshot of the current viewport. Returns a signed URL to the image.

Parameters

Response

{
  "screenshot_url": "https://...",
  "width": 1920,
  "height": 1080
}

Errors

400 (invalid parameters), 404 (session not found), 413 (screenshot too large).

Error Codes

All automation tools return standard HTTP error codes with a JSON error body. The detail field provides a human-readable explanation.

Error response format

{
  "error": {
    "code": 403,
    "type": "domain_not_allowlisted",
    "detail": "Navigation to example.com is not permitted. Only allowlisted domains can be accessed."
  }
}

Support

Technical: support@pauhu.eu

API documentation: pauhu.eu/docs