Installation

Install Human Browser

Cloud Chromium for AI agents — A2A endpoint, MCP server, residential proxies, captcha solving, all behind one token. Try it for $1 — about 4 typical tasks. After that, pay-as-you-go: $0.02 per agent step with the AI included plus $0.10/browser-hour — no subscription.

Terminal installing the humanbrowser npm package connected to a cloud browser and residential proxy
Step 1 — Get your hb_live_* token Email-only signup; try it for $1 by card. Same token works for both the MCP endpoint and the A2A endpoint.
Get Token →
★ Recommended · npm

Node.js / TypeScript

npm install @virixlabs/humanbrowser
SDK + MCP server in one package. Tap to copy.
Claude Desktop · Cursor · Cline

MCP Server

npx -y @virixlabs/humanbrowser mcp
Drop into your MCP config. Tap to copy.
GitHub

Clone / Fork

npm install @virixlabs/humanbrowser
Full source code. Apache-2.0 license. Tap to copy.

Token, billing, env var

  1. Top up when you're ready$20, $80, $200, or any custom amount via Stripe or crypto. Prepaid pay-as-you-go: $0.10/browser-hour, $0.02 per agent step (AI included), $4/GB residential proxy, $0.005 / solved captcha. No subscription, no auto-renew.
  2. Set the env varHUMANBROWSER_API_TOKEN=hb_live_… — that's the only credential you need. Residential proxy + captcha solver are managed by the cloud automatically.

Quick start — Cloud (recommended)

const { runOnCloud } = require('@virixlabs/humanbrowser');

// Single A2A call — proxy, captcha, stealth all included
const { result, viewerUrl } = await runOnCloud({
  goal: 'Search "best espresso 2026" on Reddit, return top 5 thread titles',
  country: 'us',  // optional — 60+ supported
});

console.log(viewerUrl);  // live preview URL — share with humans
console.log(result);     // the extracted data

MCP — Claude Desktop / Cursor / Cline

Remote (recommended). No install, no npm. Just point your MCP client at our hosted endpoint. For Cursor / Cline (native HTTP transport):

{
  "mcpServers": {
    "humanbrowser": {
      "url": "https://agent.humanbrowser.cloud/mcp",
      "headers": { "Authorization": "Bearer hb_live_..." }
    }
  }
}

For Claude Desktop, wrap with mcp-remote until native HTTP transport ships:

{
  "mcpServers": {
    "humanbrowser": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://agent.humanbrowser.cloud/mcp", "--header", "Authorization: Bearer hb_live_..."]
    }
  }
}

Local stdio. Runs the MCP server in-process via npx:

{
  "mcpServers": {
    "humanbrowser": {
      "command": "npx",
      "args": ["-y", "@virixlabs/humanbrowser", "mcp"],
      "env": { "HUMANBROWSER_API_TOKEN": "hb_live_..." }
    }
  }
}

Self-host (advanced)

If you want to run the stealth library locally with your own residential proxy + 2captcha key:

const { launchHuman } = require('@virixlabs/humanbrowser');

// Bring your own PROXY_USER / PROXY_PASS / TWOCAPTCHA_KEY in .env
const { browser, page } = await launchHuman({
  proxy: { provider: 'decodo', country: 'us' },
  device: 'win-chrome',  // or 'iphone-15-pro'
});

await page.goto('https://example.com');

Works with

Claude Code
ChatGPT
Codex
Cursor
Gemini
Kimi
OpenClaw
Hermes
LangChain
LangGraph
CrewAI
Google ADK

FAQ

Is Human Browser free?

The script is 100% free and MIT-licensed. The hosted residential proxy + stealth API is prepaid pay-as-you-go — try it for $1 (your first top-up can be $1), then top up from $5 — $20, $80, $200 or any custom amount when you want to keep going. No subscription, no auto-renew.

Does Human Browser work without a proxy?

The script itself works, but without a residential proxy your server's data center IP will be blocked by Cloudflare, Instagram, etc. The proxy is what makes it actually bypass detection.

How is Human Browser different from Playwright-stealth or puppeteer-extra?

Those plugins only handle fingerprint flags inside the browser. Human Browser also fixes the IP layer (residential proxy), adds human-like mouse/typing behavior, and is packaged as an AI agent skill. It's the complete solution.

Where are credentials stored?

In your environment variables — one variable: HUMANBROWSER_API_TOKEN=hb_live_…. The cloud handles residential proxy, captcha solving, and stealth fingerprint automatically — you don't manage proxy creds separately anymore.

What does the cloud cost?

Pay-as-you-go: $0.10/browser-hour, $0.02 per agent step with the AI included, $4/GB residential proxy bandwidth, $0.005 per solved captcha. Across successful customer tasks in Sep 2026, re-priced at these rates, the median task took about 8 agent steps and cost $0.24 all-in (a quarter cost $0.12 or less, three quarters $0.39 or less). No subscription, no auto-renew, your balance only decreases when you actually run a task.

Ready to install Human Browser?

Script is free (Apache-2.0). Cloud: try it for $1, then pay-as-you-go: $0.02 per agent step plus $0.10/hr. No subscription. Get started in under 5 minutes.

Try it for $1 → View on npm
Top up — $20

Loading secure checkout…

More coins →