2Captcha MCP Server

A Model Context Protocol (MCP) server implementation that integrates with 2Captcha to provide robust CAPTCHA solving capabilities for AI agents.

Features

• Balance Check: Monitor your 2Captcha account balance.

• Image Captcha: Solve traditional image-based CAPTCHAs (file, base64, or HTML).

• reCAPTCHA v2: Solve reCAPTCHA v2 and Enterprise versions.

• hCaptcha: Solve hCaptcha widgets.

• Cloudflare Turnstile: Solve Cloudflare's invisible challenge.

• Arkose Labs (FunCaptcha): Solve FunCaptcha/Arkose challenges.

• GeeTest: Solve GeeTest v3 challenges.

Related MCP server: 2Captcha MCP

Installation

Running with npx

You can run the server directly using npx:

env TWOCAPTCHA_API_KEY=YOUR_API_KEY_HERE npx -y 2captcha-mcp

Note for Windows users: If you encounter issues with environment variables, try: cmd /c "set TWOCAPTCHA_API_KEY=YOUR_API_KEY_HERE && npx -y 2captcha-mcp"

Configuration

Environment Variables

• TWOCAPTCHA_API_KEY (Required): Your 2Captcha API key. You can find this in your 2Captcha Dashboard.

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "2captcha-mcp": {
      "command": "npx",
      "args": ["-y", "2captcha-mcp"],
      "env": {
        "TWOCAPTCHA_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Available Tools

1. Balance Check (get_balance)

Check your current 2Captcha account balance.

Prompt Example:

"How much balance do I have left on 2Captcha?"

2. Solve Image Captcha (solve_image)

Solve an image-based CAPTCHA. Supports local file paths, base64 strings, or HTML snippets containing <img> tags.

Arguments:

• body: The image source (path, base64, or HTML).

• numeric: 0=default, 1=only digits, 2=only letters, 3=either, 4=both (optional).

• min_len / max_len: Length constraints (optional).

Prompt Example:

"Solve this captcha image: "

3. Solve reCAPTCHA v2 (solve_recaptcha_v2)

Solve reCAPTCHA v2 or Enterprise.

Arguments:

• pageurl: The URL of the page where the captcha is located.

• googlekey: The sitekey (data-sitekey).

• enterprise: Set to true for enterprise version.

• invisible: Set to true for invisible version.

4. Solve hCaptcha (solve_hcaptcha)

Solve hCaptcha widgets.

Arguments:

• pageurl: The URL of the page.

• sitekey: The hCaptcha sitekey.

5. Solve Turnstile (solve_turnstile)

Solve Cloudflare Turnstile challenges.

Arguments:

• pageurl: The URL of the page.

• sitekey: The Turnstile sitekey.

6. Solve Arkose/FunCaptcha (solve_arkose)

Solve Arkose Labs/FunCaptcha challenges.

Arguments:

• pageurl: The URL of the page.

• publickey: The Arkose public key.

7. Solve GeeTest (solve_geetest)

Solve GeeTest v3 challenges.

Arguments:

• pageurl: The URL of the page.

• gt: The GeeTest gt value.

• challenge: The GeeTest challenge value.