Claude MarketplacesSubmit

2Captcha MCP

aruxojuyu665/2captcha-mcp

Wraps the entire 2Captcha API surface via the official Python SDK, exposing 31 solver types (reCAPTCHA, hCaptcha, Turnstile, FunCaptcha, GeeTest, image grids, audio, and two dozen others), plus account balance, result reporting, and pingback URL management. All told, 43 tools. Each solver accepts standard kwargs like proxy config, user agent, and callback URLs. Includes an optional webhook receiver (Starlette + SQLite) that flips long-running solves into async mode so Claude isn't blocking for ten minutes waiting on a reCAPTCHA v3 response. Reach for this when you're automating flows that hit CAPTCHAs and need programmatic solving without leaving the MCP context. Strict mypy, 92%+ coverage, live integration tests against the real API.

GitHub stars: 1
tools: 41
auth: Secret needed
transport: STDIO
env var: 1
last updated: May 5, 2026

Tools

41 tools

Public tool metadata for what this MCP can expose to an agent.

twocaptcha_solve_normalSolve a normal image captcha (file_path xor file_base64).

Solve a normal image captcha (file_path xor file_base64).

No parameter schema in public metadata yet.

twocaptcha_solve_textSolve a text captcha (text).

Solve a text captcha (text).

No parameter schema in public metadata yet.

twocaptcha_solve_audioSolve an audio captcha (file xor, audio_lang).

Solve an audio captcha (file xor, audio_lang).

No parameter schema in public metadata yet.

twocaptcha_solve_gridSolve a grid captcha (file xor).

Solve a grid captcha (file xor).

No parameter schema in public metadata yet.

twocaptcha_solve_canvasSolve a canvas captcha (file xor).

Solve a canvas captcha (file xor).

No parameter schema in public metadata yet.

twocaptcha_solve_coordinatesSolve a coordinates captcha (file xor).

Solve a coordinates captcha (file xor).

No parameter schema in public metadata yet.

twocaptcha_solve_rotateSolve a rotate captcha (files: list).

Solve a rotate captcha (files: list).

No parameter schema in public metadata yet.

twocaptcha_solve_vkimageSolve a vkimage captcha (files, steps).

Solve a vkimage captcha (files, steps).

No parameter schema in public metadata yet.

twocaptcha_solve_recaptchaSolve a reCAPTCHA (sitekey, url, version, enterprise).

Solve a reCAPTCHA (sitekey, url, version, enterprise).

No parameter schema in public metadata yet.

twocaptcha_solve_hcaptchaSolve an hCaptcha (sitekey, url).

Solve an hCaptcha (sitekey, url).

No parameter schema in public metadata yet.

twocaptcha_solve_turnstileSolve a Cloudflare Turnstile (sitekey, url, optional data/pagedata for CF Challenge).

Solve a Cloudflare Turnstile (sitekey, url, optional data/pagedata for CF Challenge).

No parameter schema in public metadata yet.

twocaptcha_solve_funcaptchaSolve a FunCaptcha (sitekey, url).

Solve a FunCaptcha (sitekey, url).

No parameter schema in public metadata yet.

twocaptcha_solve_geetestSolve a GeeTest captcha (gt, challenge, url).

Solve a GeeTest captcha (gt, challenge, url).

No parameter schema in public metadata yet.

twocaptcha_solve_geetest_v4Solve a GeeTest v4 captcha (captcha_id, url).

Solve a GeeTest v4 captcha (captcha_id, url).

No parameter schema in public metadata yet.

twocaptcha_solve_capySolve a Capy captcha (sitekey, url).

Solve a Capy captcha (sitekey, url).

No parameter schema in public metadata yet.

twocaptcha_solve_keycaptchaSolve a KeyCaptcha (user id, session id, two signs, url).

Solve a KeyCaptcha (user id, session id, two signs, url).

No parameter schema in public metadata yet.

twocaptcha_solve_leminSolve a Lemin captcha (captcha_id, div_id, url).

Solve a Lemin captcha (captcha_id, div_id, url).

No parameter schema in public metadata yet.

twocaptcha_solve_mtcaptchaSolve an MTCaptcha (sitekey, url).

Solve an MTCaptcha (sitekey, url).

No parameter schema in public metadata yet.

twocaptcha_solve_friendly_captchaSolve a Friendly Captcha (sitekey, url).

Solve a Friendly Captcha (sitekey, url).

No parameter schema in public metadata yet.

twocaptcha_solve_cutcaptchaSolve a CutCaptcha (misery_key, apikey, url).

Solve a CutCaptcha (misery_key, apikey, url).

No parameter schema in public metadata yet.

twocaptcha_solve_amazon_wafSolve an Amazon WAF captcha (sitekey, iv, context, url).

Solve an Amazon WAF captcha (sitekey, iv, context, url).

No parameter schema in public metadata yet.

twocaptcha_solve_tencentSolve a Tencent captcha (app_id, url).

Solve a Tencent captcha (app_id, url).

No parameter schema in public metadata yet.

twocaptcha_solve_atb_captchaSolve an ATB captcha (app_id, api_server, url).

Solve an ATB captcha (app_id, api_server, url).

No parameter schema in public metadata yet.

twocaptcha_solve_datadomeSolve a DataDome captcha (proxy, user_agent, captcha_url, pageurl).

Solve a DataDome captcha (proxy, user_agent, captcha_url, pageurl).

No parameter schema in public metadata yet.

twocaptcha_solve_captchafoxSolve a CaptchaFox captcha (proxy, user_agent, sitekey, pageurl).

Solve a CaptchaFox captcha (proxy, user_agent, sitekey, pageurl).

No parameter schema in public metadata yet.

twocaptcha_solve_vkcaptchaSolve a VK captcha (proxy, user_agent, redirect_uri).

Solve a VK captcha (proxy, user_agent, redirect_uri).

No parameter schema in public metadata yet.

twocaptcha_solve_prosopoSolve a Prosopo captcha (sitekey, pageurl).

Solve a Prosopo captcha (sitekey, pageurl).

No parameter schema in public metadata yet.

twocaptcha_solve_temuSolve a Temu captcha (body, part1..3).

Solve a Temu captcha (body, part1..3).

No parameter schema in public metadata yet.

twocaptcha_solve_altchaSolve an Altcha captcha (pageurl).

Solve an Altcha captcha (pageurl).

No parameter schema in public metadata yet.

twocaptcha_solve_cybersiaraSolve a CyberSiara captcha (master_url_id, pageurl, cyber_user_agent).

Solve a CyberSiara captcha (master_url_id, pageurl, cyber_user_agent).

No parameter schema in public metadata yet.

twocaptcha_solve_yandex_smartSolve a Yandex Smart captcha (sitekey, url).

Solve a Yandex Smart captcha (sitekey, url).

No parameter schema in public metadata yet.

twocaptcha_balanceReturns the current account balance in USD.

Returns the current account balance in USD.

No parameter schema in public metadata yet.

twocaptcha_report_goodReport a captcha id as solved correctly within 15 minutes.

Report a captcha id as solved correctly within 15 minutes.

No parameter schema in public metadata yet.

twocaptcha_report_badReport a captcha id as solved incorrectly within 15 minutes.

Report a captcha id as solved incorrectly within 15 minutes.

No parameter schema in public metadata yet.

twocaptcha_get_resultPoll a captcha id manually for its result (paired with send_raw).

Poll a captcha id manually for its result (paired with send_raw).

No parameter schema in public metadata yet.

twocaptcha_send_rawEscape hatch for SDK methods this server does not yet expose.

Escape hatch for SDK methods this server does not yet expose.

No parameter schema in public metadata yet.

twocaptcha_register_pingbackWhitelist a callback URL for pingback.

Whitelist a callback URL for pingback.

No parameter schema in public metadata yet.

twocaptcha_list_pingbacksList whitelisted pingback addresses.

List whitelisted pingback addresses.

No parameter schema in public metadata yet.

twocaptcha_delete_pingbackDelete one pingback address or all of them.

Delete one pingback address or all of them.

No parameter schema in public metadata yet.

twocaptcha_solve_and_wait_pingbackComposite tool that sends a captcha and waits on the local webhook store for the result.

Composite tool that sends a captcha and waits on the local webhook store for the result.

No parameter schema in public metadata yet.

twocaptcha_pingback_events_listList pingback events stored by the webhook receiver.

List pingback events stored by the webhook receiver.

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly

Agent CaffeineSponsoredClose your lid, come back to finished work

SnugSponsoredThe clipboard manager for the AI era Promote your product hereReach 125k+ visitors monthly

WaxSponsoredBlock anything with supervision, without erasing your iPhone Promote your product hereReach 125k+ visitors monthly

knobsSponsoredSee your site on any phone, any day, in any language

Configuration

2Captcha_API_KEY*secret

2Captcha account API key (https://2captcha.com/setting)

Readme

2Captcha MCP

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

View the full README on GitHub

Details

Repository: github.com/aruxojuyu665/2captcha-mcp
Category: Automation & Workflows
Package: twocaptcha-mcp
Transport: STDIO
Auth: Required
Registry: MCP registry, active

Related Automation & Workflows MCP servers

1

OrbiAds — Google Ad Managerorbiads/orbiads-gam-mcpAutomate Google Ad Manager: campaigns, line items, creatives, inventory, reporting — 51 tools.1stars

2

Provar MCP Serverprovartesting/provardx-cliProvar MCP: AI-powered Salesforce test automation. Generate, validate, migrate, and run tests.1stars

3

Date Mathjowendelapena/date-mathDate/time math for agents: business days, holidays, time zones, cron, RRULE. 25 free calls/day.1stars

4

Bowmark web data: LinkedIn, Amazon, YouTube, Reddit, Airbnb, Instagrambowmark-ai/skillWeb scraping and automation for AI agents: live prices, quotes, bookings, anything behind a login.0stars

5

Scopescope-bid/scope-mcpDispatch litigation work to legal-services vendors from any MCP-compatible AI workflow.1stars

6

Mcptickstem/mcpTickstem developer tools — manage cron jobs and verify emails from your AI coding assistant.0stars