How do I install Capmonster MCP Captcha Solver?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Capmonster MCP Captcha Solver need an API key?

No required environment variable is listed on this record.

What transport does Capmonster MCP Captcha Solver use?

Capmonster MCP Captcha Solver runs locally over stdio.

When was Capmonster MCP Captcha Solver last checked?

Last checked 2026-11-09. CapMonster Cloud MCP server — AI captcha solver for reCAPTCHA, Turnstile & DataDome for AI agents.

Capmonster MCP Captcha Solver MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add io.github.capmonstercloud-capmonster-mcp-captcha-solver -- npx -y capmonster-mcp@0.1.14

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.capmonstercloud-capmonster-mcp-captcha-solver": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.1.14
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

CapMonster Cloud MCP Server (Model Context Protocol)

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

Get your API key.
Add the server to your MCP client config (see below).
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):

uvx capmonster-mcp

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):

{
  "mcpServers": {
    "capmonster": {
      "command": "uvx",
      "args": ["capmonster-mcp"],
      "env": {
        "CM_API_KEY": "your_api_key_here"
      }
    }
  }
}

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 (docs.capmonster.cloud / api.capmonster.cloud only), with section-jump and pagination.
create_task(task): Submits a captcha task and returns a taskId.
get_task_result(task_id): Polls a task once.
get_task_result_wait(task_id, timeout_seconds, poll_interval_seconds): Polls a task to completion (preferred over driving the poll loop yourself).
get_actual_user_agent(): Fetches a current Windows User-Agent to use as one consistent fingerprint across the browser and the solve task.
get_balance(): Checks your current CapMonster Cloud API balance.

⚖️ Responsible use

Use this server only on websites you own or have permission to automate, and in line with the terms of service of those websites and applicable law.

📚 Official Documentation

📄 License

MIT