[opensourcedex]

aihawk_mcp_server is a free, open source ai development platforms project written in Python and released under MIT. It has 31,621 GitHub stars, 4,672 forks and 2 open issues, and was last pushed 3 hours ago. On this registry it ranks #27 of 142 tracked projects in AI Development Platforms, with 5 head-to-head comparisons available.

What is aihawk_mcp_server?

AIHawk is an open-source, MIT-licensed Python anti-detect browser and web browsing agent that ships both as an MCP server for coding agents and as a standalone web UI, letting users drive a real browser in plain language — built for developers, automation and lead-generation teams, and job seekers who need browser automation that is not blocked or captcha-walled.

What it is

AIHawk is an anti-detect browser and web browsing agent distributed under the MIT licence in the AI and Machine Learning / AI Development Platforms category. It lives in the MCP ecosystem as a server that coding agents can call, and it also runs as a standalone application whose interface shows a chat pane on the left and the live browser on the right. The agent drives pages the way a person would — the pointer moves and keys are pressed — so it can operate widgets such as a calendar date field by clicking the days rather than typing into them. The README describes it as undetected, with no captchas and no blocks, and instructions are given in ordinary language rather than as site-specific scripts.

The concrete problem it solves is automation of work that needs a real browser rather than an API, together with a person's judgement about what is actually on the page. It stands in for the API a site does not offer and for the human who would otherwise click through the flow by hand: the README's worked example asks the agent to check every date between the 12th and the 16th of the following month on a flight search, one at a time, read the cheapest fare for each day, click the calendar widget instead of typing, and say so when a date has no availability rather than guessing a number. The topic list points the same capability at job hunting, job search, scraping, lead generation and computer use.

Key capabilities

  • Installs as an MCP server for three assistants: Claude Code (claude plugin marketplace add feder-cr/aihawk_mcp_server, then claude plugin install aihawk@feder-cr), Codex (codex plugin marketplace add and codex plugin add aihawk@feder-cr) and Gemini CLI (gemini extensions install https://github.com/feder-cr/aihawk_mcp_server).
  • Provides a standalone web UI on 127.0.0.1:8765, launched with uvx aihawk ui --openrouter-key, pairing a chat pane with a live browser view.
  • Interacts like a person: the pointer moves and keys are pressed, so calendar widgets are navigated by clicking days rather than typing them.
  • Routes traffic through an optional proxy supplied as an http://user:pass@host:port or socks5://host:port URL, with host and port both required; timezone, locale and egress follow the proxy.
  • Controls identity and persistence: an integer --seed reproduces the same browser identity on every run, and --profile-dir keeps logins and cookies across restarts.
  • Accepts a pre-existing engine binary through --binary, but refuses to start unless it is the build the seal pins — that skips the download, not the version check.
  • Configures the model and key with --model or AIHAWK_MODEL, defaulting to z-ai/glm-5.3-flash, and reads OPENROUTER_API_KEY and STEALTHFOX_BINARY from a .env beside the command with the precedence --flag, then environment, then .env, then default.

Who uses it and how

  • Developers already working in Claude Code, Codex or Gemini CLI, who add AIHawk as a plugin and hand browsing tasks to the assistant they use rather than switching tools.
  • Individuals running the standalone interface with their own OpenRouter key, watching the live browser alongside the chat on a local port.
  • Job seekers, since job-hunting and job-search are listed topics and the project's press coverage includes a reporter who used it to apply to 2,843 jobs.
  • Lead-generation and scraping work, both named in the topic list alongside autonomous agents and computer use.
  • Operators who need a particular egress region or continuity: proxy settings carry the timezone and locale, and a --profile-dir keeps sessions usable across restarts.

Getting started

Install uv — by the PowerShell installer on Windows or the curl installer on Linux — then run uvx aihawk ui --openrouter-key sk-or-... and open http://127.0.0.1:8765, or add the MCP server to Claude Code, Codex or Gemini CLI with the plugin commands above. The key can also come from the environment or from a .env file in the directory the command runs from.

How it compares

The tools named in the facts — Claude Code, Codex and Gemini CLI — are hosts rather than rivals, because AIHawk installs into them as an MCP plugin or extension, and the standalone route pairs with OpenRouter for model access instead of substituting for it. No comparable project is named in the facts provided, so on the evidence given it stands alone in this registry.

When to use it — and when not to

Running it means operating a Python tool through uv, supplying an OpenRouter key, and managing what a real browsing session needs: a proxy if required, a profile directory, and an engine binary matching the pinned build, which startup rejects if it does not match. Changing --host away from 127.0.0.1 exposes an interface that has no authentication, so it should not be placed on a network as shipped, and anyone who needs an API-only scripted pipeline without a browser or without a model provider key should look elsewhere. The repository shows an MIT licence, 2 open issues and a last push in September 2026, but the README excerpt provided here is an excerpt, with fuller documentation living in the project wiki.

project readme (upstream, from github) — read inline
AIHawk

AIHawk is an anti detect browser and web browsing agent, open source, with an MCP server for coding agents: undetected, no captchas, no blocks. Tell it what you want in plain language.

FEATURED IN
Business Insider · TechCrunch · Semafor · Wired · The Verge · Vanity Fair · 404 Media

Two ways to use this browser agent

1. From your assistant, over MCP

Windows, in PowerShell:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
$env:Path = "$env:USERPROFILE\.local\bin;$env:Path"

Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env

Then install it in your assistant.

Claude Code:

claude plugin marketplace add feder-cr/aihawk_mcp_server
claude plugin install aihawk@feder-cr

Codex:

codex plugin marketplace add feder-cr/aihawk_mcp_server
codex plugin add aihawk@feder-cr

Gemini CLI:

gemini extensions install https://github.com/feder-cr/aihawk_mcp_server

2. Standalone: the web UI

We bring the interface, you bring an OpenRouter key. Chat on the left, the live browser on the right.

Windows, in PowerShell:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
$env:Path = "$env:USERPROFILE\.local\bin;$env:Path"
uvx aihawk ui --openrouter-key sk-or-...

Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env
uvx aihawk ui --openrouter-key sk-or-...

Then open http://127.0.0.1:8765 and type the same thing.

What to ask a web browsing agent

Anything that needs real web automation: a browser rather than an API, and a person's judgement about what is on the page.

Go to ``. One way, Milan to Lisbon, economy, one checked bag, one adult. Check every date from the 12th to the 16th of next month, one at a time, and read the cheapest fare for each day. The date field is a calendar widget, so click the days rather than typing them. If a date has no availability, say so. Do not guess a number.

It drives the page the way a person would: the pointer moves, keys are pressed.

Options: proxy, profile, seed

  • --openrouter-key Your key, or the OPENROUTER_API_KEY variable.
  • --model An OpenRouter model id, or AIHAWK_MODEL. Defaults to z-ai/glm-5.3-flash.
  • --proxy Optional. http://user:[email protected]:8080 or socks5://proxy.example.com:1080. Host and port are both required. The timezone, locale and egress follow it.
  • --binary An engine binary you already have. It must be the build the seal pins, or startup refuses: this skips the download, not the version check.
  • --seed An integer. Same seed, same browser identity, every run.
  • --profile-dir A directory to keep the profile in, so logins and cookies survive restarts.
  • --headed Show the browser window. The interface shows you the page anyway.
  • --host, --port 127.0.0.1 and 8765. Changing the host exposes an interface that has no authentication.

A .env beside the command

Rather than retyping the key and the binary path, put them in a .env in the directory you run from:

OPENROUTER_API_KEY=sk-or-...
STEALTHFOX_BINARY=/path/to/firefox

It is read at startup, and on the way in it never overrides something already set, so the order is --flag > the environment > .env > the default. Only the directory you are in is read - there is no search upwards, so running from a subfolder cannot silently pick up a different key. The startup line names the variables it applied and never prints their values.

Passing --openrouter-key puts the key in your shell history, and on Linux in the process list. OPENROUTER_API_KEY in the environment or in a .env avoids both.

The wiki: AI browser-agent guides

The reading room around the agent lives in the wiki: the AI browser-agent landscape: browser-use, Operator-style and computer-use agents compared, what to check when an agent gets blocked, and what happened to OpenAI Operator, among others. Worked examples, transcripts and their outputs live in articles/.

The rest of the family: engine, core

The MCP server from option 1 ships inside this package: aihawk with no subcommand is the server, aihawk ui the interface. Its config blocks for clients that take a file, its settings and its tools are on the wiki page The MCP server.

  • invisible_playwright The engine, as a Python library, for writing code instead of prompts. The API is Playwright's.
  • invisible_core Seed to fingerprint to preferences, proxy and geolocation.

Using it responsibly

This automates a browser under your control. Read the terms of the sites you point it at, respect their rate limits, and do not submit anything a human has not read.

Privacy Policy

AIHawk runs on your machine and has no server of its own. What leaves your computer, and to whom:

  • The sites you visit see the browser, as they would any Firefox.
  • Your model provider. The web UI sends the conversation and what the agent reads on the page to OpenRouter under your key. Over MCP, the client you plugged it into does the same with whichever model it uses.
  • GitHub. The engine is downloaded from a GitHub release the first time the server or the interface starts, and a GeoIP database is when a proxy is set. Each browser launch also fetches a one-line counter file from a GitHub release, which is how launches are counted: the request carries no identifier and nothing of yours, and GitHub sees what any HTTPS request shows, your IP address.

Nothing else is collected and nothing is sent to the author. Sessions, profiles and screenshots are stored locally, under AIHAWK_HOME if set and otherwise in the application-data directory of your system, and are yours to delete; nothing is retained anywhere else. Questions go to the issues.

License

MIT. Everything distributed before 2 September 2026 was released under AGPL-3.0 and stays under it.

Frequently asked questions

Is aihawk_mcp_server free to use?

aihawk_mcp_server is open source under the MIT licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does aihawk_mcp_server do?

Anti-detect agentic browser: undetected browsing, browser automation, MCP server, AI web browsing agent, computer use, scraping, lead generation. No captchas.

What is aihawk_mcp_server written in?

aihawk_mcp_server is primarily written in Python. Its source is publicly available at https://github.com/feder-cr/aihawk_mcp_server, and it has 31,621 GitHub stars.