Run agents over MCP

Computer-Use Agents ship an official Model Context Protocol server, so hosts like Cursor, Claude Code, VS Code, Codex, and Hermes can run and manage H agents as tools, with no HTTP or SDK code. The server is a remote streamable-HTTP endpoint at /mcp on your region’s host, authenticated with the same H API key (Authorization: Bearer hk-...). Any client that can send a bearer header works; clients that require OAuth, like Claude.ai web or the ChatGPT app, aren’t supported.

Add to your editor

One click installs the hai-agents server, then paste your API key when prompted. The buttons target the EU region (the default):

https://cdn.simpleicons.org/cursor/6b6b70

Add to Cursor

Opens Cursor and prompts to install.

https://cdn.jsdelivr.net/gh/devicons/devicon/icons/vscode/vscode-original.svg

Add to VS Code

Opens VS Code and prompts to install.

On the US region, use Add to Cursor or Add to VS Code instead. Registry-aware clients can also find it in the MCP Registry as io.github.hcompai/hai-agents.

Connect manually

Point your client at the /mcp URL for your region and add the Authorization header.

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "hai-agents": {
      "url": "https://agp.eu.hcompany.ai/mcp",
      "headers": { "Authorization": "Bearer hk-..." }
    }
  }
}

claude mcp add --scope user --transport http hai-agents https://agp.eu.hcompany.ai/mcp \
  --header "Authorization: Bearer hk-..."

// user mcp.json (MCP: Open User Configuration)
{
  "servers": {
    "hai-agents": {
      "type": "http",
      "url": "https://agp.eu.hcompany.ai/mcp",
      "headers": { "Authorization": "Bearer hk-..." }
    }
  }
}

# ~/.codex/config.toml
[mcp_servers.hai-agents]
url = "https://agp.eu.hcompany.ai/mcp"
bearer_token_env_var = "HAI_API_KEY"   # export HAI_API_KEY=hk-...

# ~/.hermes/config.yaml
mcp_servers:
  hai-agents:
    url: https://agp.eu.hcompany.ai/mcp
    headers:
      Authorization: "Bearer hk-..."

Your API key is a secret: keep it in your local client config, never in a committed or shared workspace file. In a network-restricted sandbox (for example NVIDIA NemoClaw / OpenShell), also allow your region’s /mcp host in the sandbox egress policy, scoped to the process that makes the call, or the agent can’t reach the server. The computer-use-agents-demos repo has a worked NemoClaw example.

Tools

Tool	What it does
`run_agent`	Start an agent on a task. Returns the answer, or a session handle to wait on if the task runs long.
`wait_for_session`	Long-poll a session for its answer, or fetch its current snapshot.
`list_agents`	List the agents you can run: your org’s agents plus the public `h/` ones. Pass an agent’s `name` as the `agent` for `run_agent`.
`send_message`	Send a follow-up message to a running session.
`cancel_session`	Cancel a session.
`share_session`	Make a session publicly viewable and return a share link.

Next steps

Quickstart

Run your first session end to end with the API or SDKs.

SDKs

The typed Python and TypeScript clients and the hai CLI.

Agents

Configure the agents the MCP tools run, including the public h/ ones.

Coding assistants

Teach your assistant the H APIs with the hai-agents skill.

Get started

Concepts

Browser

Desktop

Integrations

Guides

Platform

Add to your editor

Add to Cursor

Add to VS Code

Connect manually

Tools

Next steps

Quickstart

SDKs

Agents

Coding assistants

​Add to your editor

Add to Cursor

Add to VS Code

​Connect manually

​Tools

​Next steps

Quickstart

SDKs

Agents

Coding assistants

Add to your editor

Connect manually

Tools

Next steps