MCP Server for CapSolver — give AI agents the ability to solve CAPTCHAs (reCAPTCHA v2/v3, Cloudflare Turnstile) via the Model Context Protocol. Works with Claude, Cursor, Windsurf, and any MCP client.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add capsolver --env CAPSOLVER_API_KEY='<CAPSOLVER_API_KEY>' -- uvx capsolver-mcp~/.codex/config.toml
[mcp_servers.capsolver]
command = "uvx"
args = ["capsolver-mcp"]
env = { CAPSOLVER_API_KEY = "<CAPSOLVER_API_KEY>" }
# codex mcp add capsolver --env CAPSOLVER_API_KEY='<CAPSOLVER_API_KEY>' -- uvx capsolver-mcp~/.cursor/mcp.json
{
"mcpServers": {
"capsolver": {
"command": "uvx",
"args": [
"capsolver-mcp"
],
"env": {
"CAPSOLVER_API_KEY": "<CAPSOLVER_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"capsolver": {
"type": "stdio",
"command": "uvx",
"args": [
"capsolver-mcp"
],
"env": {
"CAPSOLVER_API_KEY": "<CAPSOLVER_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"capsolver": {
"command": "uvx",
"args": [
"capsolver-mcp"
],
"env": {
"CAPSOLVER_API_KEY": "<CAPSOLVER_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"capsolver": {
"command": "uvx",
"args": [
"capsolver-mcp"
],
"env": {
"CAPSOLVER_API_KEY": "<CAPSOLVER_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"capsolver": {
"command": "uvx",
"args": [
"capsolver-mcp"
],
"env": {
"CAPSOLVER_API_KEY": "<CAPSOLVER_API_KEY>"
}
}
}
}Environment variables
CAPSOLVER_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.