Agent Automation · MCP Server
Connect CapSolver to Claude Desktop, Claude Code, Cursor, Cline, or another MCP-compatible client. The server exposes CAPTCHA solving as MCP tools, so agents can call CapSolver without a separate integration for every client.
MCP Client · CapSolver
MCP clients
Use the same CapSolver MCP server across popular MCP-compatible clients.
Configure the CapSolver MCP server in your client to access the same set of CAPTCHA solving tools.
How it works
Connect your MCP client to the CapSolver MCP server.
The client discovers the available CapSolver tools.
The agent calls the right tool when CAPTCHA solving is needed.
CapSolver returns the result so the client can continue the workflow.
Why MCP
A CapSolver MCP server lets MCP-compatible agents call CAPTCHA recovery without a custom integration for every framework.
MCP servers expose tools with clear names, descriptions, and input schemas, making CapSolver a natural fit for agent tool use.
Expose CapSolver tools once and let MCP clients discover and call them through a consistent interface.
MCP does not replace Browser Use, Playwright, Puppeteer, Browserbase, or Steel. It gives agents a standard way to call CapSolver when needed.
With and without MCP
CapSolver MCP does not change how CAPTCHA solving works. It changes how compatible AI agents connect to and call CapSolver tools.
| Area | Without CapSolver MCPSeparate setup for each integration | With CapSolver MCPOne consistent tool interface |
|---|---|---|
| Integration setup | Connect CapSolver separately in each agent framework or application. | Connect the MCP server once and make its tools available to compatible clients. |
| Tool discovery | Define and document the available CapSolver functions for each integration. | MCP clients discover the available tools, descriptions, and input fields. |
| Tool calls | Each integration may use a different function format and response flow. | Agents call the same tool interface and receive structured results. |
| API key setup | Configure the API key across multiple scripts or applications. | Keep the API key in the CapSolver MCP server environment. |
MCP tools
CapSolver MCP provides tools for CAPTCHA solving, browser workflows, account checks, and supported-type discovery. Browser tools require Playwright; the other tools can run without a browser.
| Tool | What it does | Browser required |
|---|---|---|
| solve_captcha | Solves a CAPTCHA using the challenge type and required page parameters. | No |
| detect_captchas | Detects CAPTCHA challenges on the current browser page. | Yes |
| solve_on_page | Detects and solves a CAPTCHA within the current browser workflow. | Yes |
| get_balance | Returns the available CapSolver account balance. | No |
| get_supported_captchas | Returns the CAPTCHA types available through the MCP server. | No |
{
"name": "solve_captcha",
"title": "Solve CAPTCHA with CapSolver",
"description": "Solve a captcha by type and site params (token mode).",
"inputSchema": {
"type": "object",
"properties": {
"captcha_type": {
"type": "string",
"enum": [
"reCaptchaV2",
"reCaptchaV3",
"cloudflare"
],
"description": "The captcha family to solve."
},
"website_url": {
"type": "string",
"description": "Full URL of the page where the captcha appears."
},
"website_key": {
"type": "string",
"description": "Public site key extracted from the captcha widget."
}
},
"required": [
"captcha_type",
"website_url",
"website_key"
]
}
}Quick Start
Install the CapSolver MCP server, add it to your client configuration, and reload the client to access the available tools.
# Install the core packagepip install capsolver-core # Install the MCP serverpip install capsolver-mcpNeed browser tools? Install the browser extra and Chromium.
View Browser Setup{ "mcpServers": { "capsolver": { "command": "capsolver-mcp", "env": { "CAPSOLVER_API_KEY": "YOUR_API_KEY" } } }}Add this configuration to your MCP client and provide your CapSolver API key through the environment settings.
CapSolver MCP is connected, Ready for tool calls.
View Available ToolsExample Tool Call
The agent calls solve_captcha with the challenge type and required page details, then receives a structured result.
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "solve_captcha",
"arguments": {
"captcha_type": "cloudflare",
"website_url": "https://example.com/signup",
"website_key": "0x4XXXXXXXXXXXXXXXX"
}
}
}Responsible Use
Use CapSolver for approved QA testing, internal RPA, public-data workflows, and user-approved agent tasks. Review site terms, privacy requirements, and rate limits before running automated workflows.
Limit MCP tool access to trusted clients and add confirmation or human review for sensitive operations. CapSolver does not support unauthorized access, credential abuse, spam, or unlawful activity.
Related Integrations
Choose another integration to add CAPTCHA solving to your agent or browser workflow.
Add CAPTCHA solving to custom browser automation.
Add CapSolver as an action for browser-based AI agents.
Use CapSolver as a callable tool in LangChain agents.
Add CAPTCHA solving through function tools and agent workflows.
Connect the CapSolver MCP server and make CAPTCHA solving tools available to your AI agents through a standard interface.