
2Captcha MCP
io.github.aruxojuyu665Published by GitHub account aruxojuyu665v0.6.1Updated Oct 27, 2026
Full 2Captcha API (43 tools) for Claude Code: 31 captcha solvers + management + webhook.
The publisher's own server: captcha.cc Human Verification
Overview
Wraps the full 2Captcha API in 43 tools so an assistant can submit captchas for solving, check balance, and manage pingbacks.
- What you can do
- Submit captchas for solving across 31 types, including image, text, audio, grid, reCAPTCHA, hCaptcha, Turnstile, GeeTest and others
- Send a captcha and wait for the result in one call, or poll a captcha id manually
- Check account balance and report a solve as good or bad
- Register, list and delete pingback callback URLs
- Run an optional local webhook receiver that stores pingback results in SQLite and exposes tools to list, get and clear them
- Send raw API requests as an escape hatch for methods not yet exposed
- When to use it
- Useful when an assistant needs to get past captcha challenges on sites the user is authorized to automate, or to script 2Captcha account tasks such as balance checks and pingback management. Not needed for ordinary browsing or scraping that involves no captcha.
- Requirements
- Runs locally as a Python stdio process, installed from PyPI and started with uvx or python -m. Requires a 2Captcha API key supplied through an environment variable such as 2Captcha_API_KEY, plus network access to the 2Captcha service. Optional settings cover server choice, timeouts, polling interval and a default pingback URL.
Installation
In SourceWeft
- Open 2Captcha MCP in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
2Captcha MCP
[PyPI version] [Python 3.11+] [CI] [codecov] [mypy: strict] [License: MIT]
MCP server exposing the full 2Captcha API surface — 31 captcha types, 5 management tools, 3 pingback CRUD tools, 3 webhook event-store tools, and 1 composite solve-and-wait tool (43 tools total) — to Claude Code via stdio.
Built on the official 2captcha-python SDK (AsyncTwoCaptcha), so retry/polling/parsing are handled upstream and every captcha type the SDK supports is available the moment the SDK adds it.
Quick start
Create a .env next to the project root:
Verify it works:
Register the server with Claude Code:
After a claude restart, prompt the model with:
"Use twocaptcha_balance to check my account."
Configuration
All settings are environment-driven. Aliases in priority order:
Tools
Captcha solvers (31)
⚑ — proxy and user_agent are required by the SDK signature.
All solver tools accept the same set of optional kwargs (mixin SolverKwargs):
proxy: {type, uri}(HTTP/HTTPS/SOCKS4/SOCKS5)pingback: HttpUrl— per-call pingback URL (must be pre-registered)soft_id: intcookies: struser_agent: strlang: strheader_acao: 0|1
Management (5)
twocaptcha_balance— current balance in USDtwocaptcha_report_good/twocaptcha_report_bad— report a captcha id within 15 minutestwocaptcha_get_result— poll a captcha id manually (paired withsend_raw)twocaptcha_send_raw— escape hatch for SDK methods this server does not yet expose
Pingback CRUD (3)
twocaptcha_register_pingback— whitelist a callback URLtwocaptcha_list_pingbacks— list whitelisted addressestwocaptcha_delete_pingback— delete one oraddr="all"
Development
Run live tests against the real 2Captcha API (consumes credits):
Architecture
Tool handlers depend only on the SolverClient / PingbackClient abstractions — the SDK is never imported from a handler. Adding a new captcha type is a 3-step process: schema → tool handler → snapshot test count bump.
Webhook receiver (optional, since 0.3.0)
For long-running solves (recaptcha v3 up to 600 s), the polling-mode SDK call
holds the MCP request slot for the entire duration. Run the optional
twocaptcha-mcp-webhook server to flip into pingback mode — 2Captcha POSTs the
result to your URL, the receiver writes it to SQLite, and the MCP tools read
asynchronously without blocking.
- Composite tool:
twocaptcha_solve_and_wait_pingbacksends the captcha and waits on the local store - Read tools:
twocaptcha_pingback_events_list/get/clear - Deployment: docs/DEPLOY-WEBHOOK.md
- Troubleshooting: TROUBLESHOOTING.md
Contributing
See CONTRIBUTING.md for the dev loop, code conventions, and the SemVer policy for the MCP tool surface.
Security
See SECURITY.md. Vulnerabilities are reported privately via GitHub Security Advisory.
License
MIT — see LICENSE.
Registry verification — mcp-name: io.github.aruxojuyu665/twocaptcha-mcp
Source: README.md at commit 8d0b639
Tools
0Version history
1- v0.6.1LatestSep 16, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts
Other Captcha integrations

captcha.cc Human Verification
cc.captchaOfficial publisher
A remote MCP server for captcha.cc that helps an assistant generate CAPTCHA integration snippets and create live challenges for testing.

CaptchaNo
Published by GitHub account DishantSinghDev2
CaptchaNo MCP server lets an AI agent solve reCAPTCHA v2/v3/Enterprise, Turnstile, DataDome and image captchas through a paid solving service.

rea-captcha
Published by GitHub account masakaai
A local stdio MCP server that detects CAPTCHA challenges in an agent's existing browser session and coordinates authorized completion or human handoff before a

Capmonster Mcp Patchright Captcha Solver
Published by GitHub account CapMonsterCloud
A stealth browser automation MCP server built on Patchright, giving an assistant 66 tools to drive Chrome on anti-bot protected sites.

Capmonster Mcp Captcha Solver
Published by GitHub account CapMonsterCloud
Official CapMonster Cloud MCP server that lets an AI agent submit captcha tasks (reCAPTCHA, Turnstile, DataDome and more) and retrieve solved tokens.