CUA MCP Tools

Model Context Protocol tool reference for the Pauhu Computer Use Agent. Playwright-based browser automation for EU procurement and regulatory workflows.

MCP Server Configuration

Add the Pauhu CUA 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://staging.pauhu.eu/v1/mcp",
      "transport": "sse",
      "headers": {
        "Authorization": "Bearer pk_your_api_key"
      }
    }
  }
}

Generate an API key at pauhu.ai/keys. All CUA 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 CUA 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