Computer-Use Agents API

Working · 1.6 s

io.github.hcompai/hai-agentsv1.0.0

Run and manage H Company's Computer-Use Agents from any MCP client.

AI & Agents Browser Automation

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

Authorization (required)

Bearer hk- API key

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

cancel_session

Cancel a session; a no-op if it does not exist or already finished.

session_idstring, required

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (9)

cancel_session

Cancel a session; a no-op if it does not exist or already finished.

Argument	Type	Description
session_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "session_id"
  ],
  "properties": {
    "session_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

list_agents

List agents the caller can run: their org's agents plus the public ``h/`` ones.

Argument	Type	Description
page	integer
size	integer

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1
    },
    "size": {
      "type": "integer",
      "default": 20
    }
  },
  "additionalProperties": false
}

list_files

List files on a browser session's machine (e.g. downloads), newest first. ``session_id`` is the browser session id issued by env-manager when the session was created, not the id ``run_agent`` returns. When a listing is truncated, page on the last entry's modified_at (ISO-8601) and name, passed as modified_before and name_after. Send both: modification times are not unique, and a timestamp alone skips the rest of a tied group.

Argument	Type	Description
path	string
name_after	any
session_id*	string
max_entries	integer
modified_before	any

Input schema (JSON)

{
  "type": "object",
  "required": [
    "session_id"
  ],
  "properties": {
    "path": {
      "type": "string",
      "default": "~/Downloads"
    },
    "name_after": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "session_id": {
      "type": "string"
    },
    "max_entries": {
      "type": "integer",
      "default": 500
    },
    "modified_before": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "additionalProperties": false
}

read_file

Read a file from a browser session's machine; returns base64 content and metadata. ``session_id`` is the browser session id issued by env-manager when the session was created, not the id ``run_agent`` returns.

Argument	Type	Description
path*	string
session_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "session_id",
    "path"
  ],
  "properties": {
    "path": {
      "type": "string"
    },
    "session_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

run_agent

Start an agent on a task; return the answer or a session handle to wait on. ``agent`` is a name from list_agents, which runs its latest revision, or ``name:N`` to run revision N.

Argument	Type	Description
task*	string
agent*	string
max_steps	any
max_time_s	any
idempotency_key	any

Input schema (JSON)

{
  "type": "object",
  "required": [
    "task",
    "agent"
  ],
  "properties": {
    "task": {
      "type": "string"
    },
    "agent": {
      "type": "string"
    },
    "max_steps": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "max_time_s": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "idempotency_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "additionalProperties": false
}

send_message

Send a follow-up message to a running session.

Argument	Type	Description
message*	string
session_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "session_id",
    "message"
  ],
  "properties": {
    "message": {
      "type": "string"
    },
    "session_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

share_session

Make a session publicly readable and return its absolute share URL.

Argument	Type	Description
session_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "session_id"
  ],
  "properties": {
    "session_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

wait_for_session

Poll a session: with ``wait`` long-poll for the answer, else return the current snapshot.

Argument	Type	Description
wait	boolean
session_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "session_id"
  ],
  "properties": {
    "wait": {
      "type": "boolean",
      "default": true
    },
    "session_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

write_file

Write base64-encoded content to a file on a browser session's machine. ``session_id`` is the browser session id issued by env-manager when the session was created, not the id ``run_agent`` returns.

Argument	Type	Description
path*	string
session_id*	string
content_base64*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "session_id",
    "path",
    "content_base64"
  ],
  "properties": {
    "path": {
      "type": "string"
    },
    "session_id": {
      "type": "string"
    },
    "content_base64": {
      "type": "string"
    }
  },
  "additionalProperties": false
}