CaptchaAI MCP Server
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CAPTCHAAI_API_KEY | No | Your 32-character CaptchaAI API key. Required for account-related tools (get_threads, get_balance, solve_captcha); not needed for get_supported_captchas. Prefer setting this in the environment over using --api-key on multi-user hosts. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
CaptchaAI token-mode captcha solving. Call get_supported_captchas() first to inspect required and optional parameters per type.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": true
} |
| resources | {
"subscribe": false,
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_threadsA | Get CaptchaAI thread usage: total threads, active working_threads, and free_threads. |
| get_balanceA | Get the CaptchaAI account balance as returned by the API. |
| get_supported_captchasA | List all supported token-mode CAPTCHA types with required/optional arguments and capabilities. Works without an API key. |
| solve_captchaA | Solve a CAPTCHA in token mode (no browser) and return the solved token or payload. Blocks until solved (typically 10-80s). Call get_supported_captchas() first to check
which arguments are required for the chosen captcha_type. When |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
Each tool targets a distinct concern: two account-metric reads (threads vs. balance), one capability-discovery call, and one solve action. The descriptions make clear what each returns (working_threads/free_threads vs. monetary balance), and solve_captcha is unmistakably the only action tool. No two tools can plausibly be swapped.
All four names follow a strict verb_noun snake_case pattern: get_threads, get_balance, get_supported_captchas, solve_captcha. The get_* reads and the solve_* action are predictable, and a new tool would obviously be named by the same convention.
Four tools is a tight, purposeful surface for a narrow service (discover types, solve, check capacity, check balance). It is at the low end of the comfortable 3-15 range, and a small amount of padding (e.g., a combined account-status or error-lookup tool) would round it out, but nothing here feels redundant.
The core lifecycle is covered: get_supported_captchas to discover required args, then solve_captcha, with get_threads/get_balance for capacity and billing. Minor gaps exist around failure handling — no way to poll/retrieve a timed-out or asynchronous solve, and no reporting of failed solves — but the primary workflow has no dead ends.