MCP ReCaptcha Server

A Model Context Protocol (MCP) server for AceDataCloud's reCAPTCHA captcha-solving APIs.

Features

• Solve reCAPTCHA image challenges and obtain reCAPTCHA v2/v3 tokens.
• Bearer-token authentication through AceDataCloud

Connect locally

Use the local stdio package and an AceDataCloud API token. The public hosted HTTPS endpoint could not be verified, so this README does not offer it as a connection option. The local MCP process still calls AceDataCloud's API; it does not run the underlying service offline.

Get an API credential through AceDataCloud Platform, keep it out of committed files, and review current pricing before a billable call.

Local stdio

Install the package and give the local process an API token:

python -m pip install mcp-recaptcha
export ACEDATACLOUD_API_TOKEN='YOUR_API_TOKEN'
mcp-recaptcha

For Claude Desktop local MCP, merge this entry into the file opened by its developer settings (~/Library/Application Support/Claude/claude_desktop_config.json on macOS). uvx requires uv on PATH:

{
  "mcpServers": {
    "recaptcha": {
      "command": "uvx",
      "args": ["mcp-recaptcha"],
      "env": {"ACEDATACLOUD_API_TOKEN": "YOUR_API_TOKEN"}
    }
  }
}

Keep this user-level file private. Self-hosted HTTP uses mcp-recaptcha --transport http --port 8000; expose it only with suitable network and TLS controls. Local execution still calls the AceDataCloud API.

Check the connection

Confirm that the MCP client loads its tools. recaptcha_get_usage_guide returns reference information; it does not prove downstream API access or balance. A real service request can be billed. If it returns 401, check the API token; if it returns 403 or an account/balance error, read that response before retrying.

Tools

• recaptcha2_recognize — Recognize a reCAPTCHA v2 image challenge
• recaptcha2_get_token — Get a reCAPTCHA v2 token
• recaptcha3_get_token — Get a reCAPTCHA v3 token
• recaptcha_get_usage_guide — Get reCAPTCHA usage guide
• recaptcha_get_api_info — Get reCAPTCHA API information

Service details

Service details