SkillAgentSearch skills...

capskip-mcp

Captcha solver MCP server for AI agents — solve reCAPTCHA v2/v3, Cloudflare Turnstile, GeeTest, ALTCHA, Capy Puzzle, CaptchaFox, Friendly Captcha and image captchas with CapSkip, an unlimited local captcha solver. Works with Claude, Cursor and VS Code.

Install / Use

claude mcp add capskip -- npx -y github:capskip/capskip-mcp

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

84/100

Category

Automation

Supported Platforms

Claude Code
Claude Desktop
Cursor

Our assessment of capskip-mcp

capskip-mcp scores 84/100 on our quality scale, 2008th of 2,790 Automation skills we index.

Its MCP Server is 19 KB long, well organised into 26 sections with 5 code examples: a thorough specification that gives an agent plenty to work with.

It has 10 GitHub stars, so there is little community track record yet; judge it on its content.

Substance
30/30
Structure
20/20
Description
15/15
Adoption
4/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated today, so capskip-mcp is actively maintained.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

capskip-mcp compared with similar skills

All 4 of these similar skills score higher than capskip-mcp; compare them before choosing.

SkillScoreStarsUpdatedFormat
capskip-mcp (this skill)by capskip8410todayMCP Server
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md

Frequently asked questions

How do I install capskip-mcp?
Run claude mcp add capskip -- npx -y github:capskip/capskip-mcp. The install tabs above show the steps for each supported agent.
Which AI agents does capskip-mcp work with?
It is written for Claude Code, Claude Desktop and Cursor, as a MCP Server file. Other agents that read the same format can often use it too.
Is capskip-mcp safe to use?
It is MIT-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is capskip-mcp still maintained?
The repository was last updated today, so capskip-mcp is actively maintained.

CapSkip MCP Server — Unlimited Captcha Solver for AI Agents

Node.js 18+ License: MIT Tests npm

A captcha solver MCP server that lets AI agents solve reCAPTCHA, Cloudflare Turnstile, GeeTest, ALTCHA, Capy Puzzle, CaptchaFox, Friendly Captcha, AWS WAF, DataDome, hCaptcha, MTCaptcha, Yandex SmartCaptcha and image captchas instead of stalling on them.

Works with Claude Desktop, Claude Code, Cursor, VS Code, and any Model Context Protocol client. Powered by CapSkip — a local captcha solver that runs on your own machine, licensed once rather than billed per solve.

npx -y capskip-mcp

What this solves

An AI agent driving a browser hits a captcha and stops. This server gives it fifteen tools so it can read the sitekey, solve the challenge, and carry on — without a human stepping in and without a per-solve API bill.

CapSkip runs as a desktop app exposing a captcha-solving HTTP API on 127.0.0.1:8080. capskip-mcp is a thin translation layer over that API: the fifth official CapSkip client, alongside the Python, Node.js, PHP and .NET SDKs.

Supported captcha types

| Captcha | Tool | Notes | |---|---|---| | reCAPTCHA v2 solver (checkbox) | capskip_solve_recaptcha | Returns a g-recaptcha-response token | | reCAPTCHA v2 invisible solver | capskip_solve_recaptcha | Pass invisible: true | | reCAPTCHA Enterprise solver | capskip_solve_recaptcha | Pass enterprise: true, works with v2 and v3 | | reCAPTCHA v3 solver | capskip_solve_recaptcha | Pass version: "v3" and the page's action | | Cloudflare Turnstile solver | capskip_solve_turnstile | Widget and interstitial challenge pages | | GeeTest v3 solver | capskip_solve_geetest | Slide puzzle; returns challenge/validate/seccode | | GeeTest v4 solver | capskip_solve_geetest_v4 | Every v4 challenge type; needs only the captcha_id, returns the five values the site verifies | | ALTCHA solver | capskip_solve_altcha | Proof-of-work; returns the token for the altcha field | | Capy Puzzle solver | capskip_solve_capy | Slide puzzle; returns three form values, not a token | | CaptchaFox solver | capskip_solve_captchafox | Returns the token for the cf-captcha-response field | | Friendly Captcha solver | capskip_solve_friendly_captcha | Proof-of-work; say which version (v1 or v2) | | AWS WAF CAPTCHA solver (Amazon WAF) | capskip_solve_amazon_waf | Challenge page or widget; returns the voucher pair, not the cookie | | DataDome solver (slider and device check) | capskip_solve_datadome | Returns the datadome cookie, tied to one IP and one User-Agent | | hCaptcha solver (checkbox, invisible and Enterprise) | capskip_solve_hcaptcha | Returns the token for h-captcha-response; pass invisible: true or the Enterprise data when the page needs them | | MTCaptcha solver (text captcha) | capskip_solve_mtcaptcha | Returns the token for mtcaptcha-verifiedtoken; the sitekey starts with MTPublic- | | Yandex SmartCaptcha solver | capskip_solve_yandex_smart | Returns the token for smart-token; the sitekey usually starts with ysc1_ | | Image captcha solver (text/OCR) | capskip_solve_image_captcha | File path, URL, data URI, or base64 |

Not supported: FunCaptcha/Arkose. There is no tool for it. hCaptcha and reCAPTCHA both carry a data-sitekey, so check the widget before choosing a tool: class="h-captcha" or a js.hcaptcha.com script takes capskip_solve_hcaptcha, class="g-recaptcha" takes capskip_solve_recaptcha.

Try them against live widgets on the captcha demo pages.


Quick start (5 minutes)

1. Install the CapSkip captcha solver

Download and run the CapSkip desktop app from the download page. Leave it running in the background.

In CapSkip settings, note the API port (default 8080) and API key (optional — if key validation is disabled, any string works).

2. Add capskip-mcp to your MCP client

No install step — npx fetches and runs it on demand.

{
  "mcpServers": {
    "capskip": {
      "command": "npx",
      "args": ["-y", "capskip-mcp"],
      "env": {
        "CAPSKIP_HOST": "127.0.0.1",
        "CAPSKIP_PORT": "8080",
        "CAPSKIP_API_KEY": "capskip"
      }
    }
  }
}

| MCP client | Config file | Example | |---|---|---| | Claude Desktop | claude_desktop_config.json | examples/claude-desktop.json | | Claude Code | claude mcp add (CLI) | examples/claude-code.md | | Cursor | .cursor/mcp.json | examples/cursor.json | | VS Code | .vscode/mcp.json | examples/vscode.json |

3. Restart your client

It should list fifteen tools, all prefixed capskip_.

4. Ask your agent to solve a captcha

"Call capskip_status to confirm CapSkip is running, then solve the reCAPTCHA on this page and submit the form."

The agent reads the sitekey off the page, calls capskip_solve_recaptcha, and places the returned token in the page's g-recaptcha-response field.


Why a local captcha solver

Cloud captcha APIs bill per solve, so an agent that retries is an agent that costs money, and every page URL and sitekey you solve leaves your network.

CapSkip runs on your machine:

  • Unlimited captcha solving — licensed once, no per-solve fees, no credit balance to top up
  • Local by default — the solver talks to 127.0.0.1; nothing is proxied through a third-party queue
  • No rate limit per key — throughput is bounded by your machine, not a vendor's plan tier
  • Fast — image captchas return in well under a second; typical reCAPTCHA v2 solves land in 30–45s

Using an existing 2captcha or Anti-Captcha integration?

CapSkip exposes the familiar in.php / res.php endpoints, so it works as a 2captcha API alternative — point your existing client at 127.0.0.1:8080 and keep your code. See the migration notes. This MCP server is the equivalent for AI agents rather than scripts.


Tools

| Tool | Purpose | Required arguments | |---|---|---| | capskip_status | Check whether the CapSkip desktop app is running and reachable | none | | capskip_solve_image_captcha | Read the text out of a distorted-text captcha image | image | | capskip_solve_recaptcha | Solve reCAPTCHA v2 or v3, including invisible and Enterprise | sitekey, url | | capskip_solve_turnstile | Solve a Cloudflare Turnstile widget or challenge page | sitekey, url | | capskip_solve_geetest | Solve a GeeTest v3 slide-puzzle captcha | gt, challenge, url | | capskip_solve_altcha | Solve an ALTCHA proof-of-work challenge | url, and one of challenge_url / challenge_json | | capskip_solve_capy | Solve a Capy Puzzle captcha | sitekey, url | | capskip_solve_captchafox | Solve a CaptchaFox challenge | sitekey, url | | capskip_solve_friendly_captcha | Solve a Friendly Captcha proof-of-work challenge | sitekey, url | | capskip_solve_amazon_waf | Solve an AWS WAF (Amazon WAF) CAPTCHA | sitekey, url | | capskip_solve_datadome | Pass a DataDome challenge and get its cookie | captcha_url, url | | capskip_solve_hcaptcha | Solve an hCaptcha widget (checkbox, invisible, Enterprise) | sitekey, url | | capskip_solve_mtcaptcha | Solve an MTCaptcha text captcha | sitekey, url | | capskip_solve_geetest_v4 | Solve a GeeTest v4 captcha | captcha_id, url | | capskip_solve_yandex_smart | Solve a Yandex SmartCaptcha | sitekey, url |

There is no min_score parameter on capskip_solve_recaptcha. reCAPTCHA v3 scores are assigned by Google from signals no solver has access to — local or cloud, none can raise a score after the fact. A min_score option would promise control that does not exist, so it is deliberately left out. Passing it anyway is rejected as an unrecognized key, not silently ignored.

Full parameter tables and worked examples: API Reference.

| Guide | Description | |---|---| | Tutorial | Every captcha type — how to recognize it, what to read off the page, what call to make, where the answer goes | | Getting Started | Full setup: CapSkip app, client config, first solve | | API Reference | Every tool, parameter, and return shape | | Troubleshooting | Connection errors, timeouts, rejected tokens |


Browser automation: Playwright, Puppeteer and Selenium

This server solves the captcha and hands back a token; your agent's existing browser tooling does the driving. The pattern is the same whichever you use:

  1. Read the sitekey from the page (data-sitekey, or the widget's config object).
  2. Call the matching capskip_solve_* tool with that sitekey and the page URL.
  3. Write the token into the response field and submit.
// The agent does this via its browser tool after capskip_solve_recaptcha returns
document.querySelector('#g-recaptcha-response').value = TOKEN;

For non-agent scripts, use the language SDKs directly — see the Playwright, Puppeteer and Selenium guides.


Configuration

| Variable | Default | Meaning | |---|---|---| | CAPSKIP_API_KEY | capskip | Any string when key validation is off | | CAPSKIP_HOST | 127.0.0.1 | CapSkip host | | CAPSKIP_PORT | 8080 | API port from CapSkip settings | | CAPSKIP_TIMEOUT | 120 | Default timeout for the image / ALTCHA / Capy / MTCaptcha tools, seconds | | CAPSKIP_RECAPTCHA_TIMEOUT | 300 | Default timeout for the reCAPTCHA / Turnstile / GeeTest / CaptchaFox / Friendly Captcha / AWS WAF / DataDome / hCaptcha / GeeTest v4 / Yandex SmartCaptcha tools, seconds |

ALTCHA and Capy use CAPSKIP_TIMEOUT, not the reCAPTCHA one — neither is a browser solve. ALTCHA is CPU proof-of-work measured in milliseconds; a Capy solve is one HTTP fetch plus pixel math, held back to roughly two seconds because Capy refuses answers that arrive faster than a human could have produced them.

Friendly Captcha is proof-of-work too but takes the longer timeout: the service sets the difficulty per request, and v2 always solves in a browser.

| CAPSKIP_POLLING_INTERVAL | 5 | Max seconds between polls |

CLI flags override environment variables, which override the defaults:

capskip-mcp --api-key <key> --host <host> --port <port> --timeout <seconds> \
            --recaptcha-timeout <seconds> --polling-interval <seconds>

An invalid value (non-numeric port, port outside 1–65535, a negative or out-of-range timeout, an unknown flag) fails at startup naming the offending flag or variable, rather than surfacing later as a confusing solve failure.


What you get back

Every solve tool returns a human-readable text block and structuredContent matching its declared output schema:

{
  "captchaId": "12345",
  "code": "03AGdBq26f...",
  "solveSeconds": 11.8
}
  • capskip_solve_turnstile adds userAgent. Submit the token with this exact User-Agent — Cloudflare rejects a token repla

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars10
CategoryAutomation
Updated22h ago
Forks8

Languages

JavaScript

Trust signals

97/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 info
capskip-mcp — MCP Server: Install & Safety Check | SkillAgent