2captcha-mcp MCP Server

[!IMPORTANT] The official 2Captcha MCP package is @2captcha/mcp (published under the @2captcha npm organization). The unscoped 2captcha-mcp package on npm is not affiliated with 2Captcha — don't put…

Local serverstdioMIT

What is the 2captcha-mcp Server?

2captcha-mcp is an MCP project maintained in the 2captcha/2captcha-mcp repository. The maintainer describes its purpose as “[!IMPORTANT] The official 2Captcha MCP package is @2captcha/mcp (published under the @2captcha npm organization). The unscoped 2captcha-mcp package on npm is not affiliated with 2Captcha…”. Read the project documentation for the complete scope.

Installation

The documented npm package is @2captcha/mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares API_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-13.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
GroupTools
parsingscrape_page, search_web, discover_urls, discover_search_params, parse_marketplace, extract, get_account
batchscrape_pages, parse_pages, get_job, cancel_job
captchalist_captcha_types, solve_captcha, detect_captcha, solve_captcha_on_page, captcha_report, captcha_balance
browser11 browser_ tools
browser_fullall 23 browser_ tools
alleverything the server advertises
scrape_pageFetch a page and return its readable content as markdown (or raw HTML with clean=false). Options: render, keep_links, structured_data, country…
search_webFind URLs for a query: ranked organic results with title, url and snippet. Options: count, country, engine.
discover_urlsList the URLs a site publishes in robots.txt and XML sitemaps — a reviewable inventory for scrape_pages/parse_pages, with pattern/prefix filters. Not a crawler.
discover_search_paramsA site's real URL search parameters, read off one page: the query parameters its own links use (with values known to work) plus any controls. Use it instead…
parse_marketplaceProduct page (target="product") or listing (target="search_results") → structured JSON. Pass schema for your own shape, include_offers for Amazon Buy-Box…
extractAny URL or raw text + your JSON Schema → extracted JSON. instructions steers the extraction.
get_accountTenant identity, configured capabilities, session spend counters.
get_jobPoll status and collect per-item results.
cancel_jobStop a running job (stops the spending).
CategoryTools
Readbrowser_snapshot (accessibility tree with element refs), browser_get_text, browser_get_html
Sessionsbrowser_save_session, browser_load_session, browser_list_sessions
list_captcha_typesThe catalogue of solvable types with their required parameters — call it before solve_captcha instead of guessing.
solve_captchaSolve a CAPTCHA of any supported kind; returns the token/answer, a captcha_id, and the cost.
detect_captchaIdentify the wall on a page — widget type, sitekey, whether a solvable task can be built from it, and the exact solve_captcha call to issue. Pass html from…
solve_captcha_on_pageDetect + solve in one step, and return an apply block: a self-contained JS expression to evaluate, or a cookie to add and a URL to re-request.
captcha_reportReport a solution good/bad (bad reports refund).
captcha_balanceCurrent balance in USD.
session_statsTool usage during this session (calls per tool, rate-limit window). Handled locally, free.

How to install the 2captcha-mcp Server

{
  "mcpServers": {
    "2captcha": {
      "command": "npx",
      "args": [
        "@2captcha/mcp"
      ],
      "env": {
        "API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
API_TOKENDeclared in the maintainer’s client configuration.Yes