CapMonsterCloud/capmonster-mcp-captcha-solver

**Let your AI agent solve CAPTCHAs on its own.** A Model Context Protocol (MCP) server for
CapMonster Cloud, available as a Python package and as a TypeScript port (ts/).
Works with Claude Desktop, Cursor and other MCP clients.
What it does
- Lists the CAPTCHA types CapMonster Cloud supports.
- Serves CapMonster's live documentation to the agent.
- Creates solve tasks and polls them against the CapMonster Cloud REST API.
This server is the **solving part** of the workflow. It has **no browser of its own** — pair it
with a browser-driving MCP (e.g.
capmonster-mcp-patchright,
GitHub) that does
the page work (navigation, interaction, reading the live DOM/network, and injecting the solved
token back into the page). See capmonster_agent/SKILL.md for the
full step-by-step procedure for analyzing a captcha-protected page and solving it this way.
**👉 Get your API Key and start solving CAPTCHAs**
***
⚡ Supported CAPTCHAs
Your AI Agent will be able to automatically solve, among others:
- **reCAPTCHA** (v2, v2 Enterprise, v3)
- **Cloudflare Turnstile** and Cloudflare Challenge (managed challenge / cf_clearance)
- **FunCaptcha** (Arkose)
- **GeeTest** (v3 and v4)
- **Enterprise Anti-Bot Systems:** AWS WAF, DataDome, Imperva, TSPD, Binance, Prosopo, Yidun,
TenDI, Hunt, Altcha, Basilisk, and more
- **Image-to-Text & Complex Image Tasks**
The authoritative, current list is served live from CapMonster's OpenAPI spec via the
get_supported_tasks tool. **hCaptcha is not currently supported.**
🚀 Quick start
1. Get your API key.
2. Add the server to your MCP client config (see below).
3. Ask your agent to open a captcha-protected page and solve it.
📦 Installation
Requires Python 3.11+ and a valid CapMonster API Key. Run it with uvx (no local clone needed):
Prefer TypeScript/Node? See ts/README.md for the
npm-published port — same tools, same behavior.
🔌 Using with an MCP client (e.g. Claude Desktop)
Add the following to your MCP client's config (e.g. claude_desktop_config.json):
The server only runs over stdio, so there are no HTTP headers to carry a per-request key —
CM_API_KEY is read once from the environment and shared by every tool call in the session.
Pair it with a browser-automation MCP server (e.g.
capmonster-mcp-patchright) so your
agent can both see the page and solve what's on it — see mcp.example.json
for a config with both servers wired up together.
🛠 Available MCP Tools
Once connected, your LLM will have access to the following tools:
- get_supported_tasks: Lists captcha task types CapMonster supports, from the live OpenAPI spec.
- get_task_parameters(task_type): Required/optional fields, variant notes, and the solution
schema for a task type.
- get_docs(url, offset, limit, section): Fetches a CapMonster documentation page