AI agents

Hermes Agent

OpenAPI JSON llms.txt Markdown

Let Hermes Agent by Nous Research solve reCAPTCHA image challenges with the Solvecha extension in its browser, or with the Solvecha MCP server.

On this page

Way 1: the MCP server (fastest)
Way 2: the extension in the browser Hermes drives
Fewer challenges: CloakBrowser
Add the skill

Hermes Agent by Nous Research can control a real Chromium browser through the Chrome DevTools Protocol (CDP). Two ways work with Solvecha.

#Way 1: the MCP server (fastest)

Add the server to ~/.hermes/config.yaml:

config.yaml

mcp_servers:
  solvecha:
    url: "https://api.solvecha.com/mcp"
    headers:
      Authorization: "Bearer ${SOLVECHA_API_KEY}"

Put SOLVECHA_API_KEY=slv_... in ~/.hermes/.env. Run /reload-mcp in a running session. Then ask Hermes to use solve_recaptcha_grid when it meets an image challenge. Details and tools: MCP server.

#Way 2: the extension in the browser Hermes drives

The Solvecha extension reads the challenge, asks the API and clicks the tiles. Hermes does not need to do anything.

Download the extension and unzip it into a folder, for example ~/solvecha-extension.
Start Chrome or Chromium yourself with a separate profile, the extension and a debugging port. Chrome 136 and later ignore the debugging port on the default profile, so the profile folder is needed.
Open the extension options and save your API key once. Turn on auto-solve.
In the Hermes CLI, run /browser connect. The default address is http://127.0.0.1:9222. For another address use /browser connect ws://HOST:PORT.
Ask Hermes to do the task. When a reCAPTCHA image challenge appears, the extension solves it.

Linux or macOS

chromium \
  --user-data-dir="$HOME/.hermes/chrome-solvecha" \
  --remote-debugging-port=9222 \
  --load-extension="$HOME/solvecha-extension" \
  --no-first-run --no-default-browser-check

On a server without a screen, run the same command with xvfb-run. Extensions need a headed browser.

#Fewer challenges: CloakBrowser

CloakBrowser is a Chromium build with a changed fingerprint. It aims to keep captchas from appearing. Solvecha solves the ones that still appear. You can start CloakBrowser with a debugging port and the extension and connect Hermes to it in the same way. Read the license facts on the CloakBrowser page first. Solvecha is not affiliated with CloakHQ.

#Add the skill

Hermes reads skills from ~/.hermes/skills/. Copy the Solvecha agent skill there so that Hermes knows when to use which way.

Solvecha is an independent service. It is not affiliated with NopeCHA, 2Captcha, CapSolver, Google or CloakHQ. Their names describe compatibility or recommendations only. Figures come from our own tests, see the compare page.